:::info 日期:2020 年 11 月 10 日
作者:Julie Qiu
原文链接:https://go.dev/blog/pkgsite-redesign :::

自从推出 pkg.go.dev 以来,我们收到了很多关于设计和可用性的很好的反馈。 特别是,很明显,在浏览网站时,信息的组织方式让用户感到困惑。

今天我们很高兴分享一个重新设计的 pkg.go.dev,我们希望它会更清晰、更有帮助。 这篇博文介绍了重点。 有关详细信息,请参阅 Go 问题 41585

所有路径的登录页面一致

主要的变化是 pkg.go.dev/ 页面已经围绕路径的概念进行了重新组织。 路径表示模块特定版本中的目录。 现在,无论该目录中有什么内容,每个路径页面都将具有相同的布局,目的是使体验始终有用且可预测。
path.png
图1:登录页

路径页面将在该路径显示自述文件(如果有)。 以前,如果存在于模块根目录,则概览选项卡仅显示自述文件。 这是我们为将最重要的信息放在最前面所做的众多更改之一。

文档导航

文档部分现在显示一个索引和一个左侧导航栏。 这提供了查看完整包 API 的能力,同时在浏览文档部分时具有上下文。 左侧导航栏中还有一个新的跳转到输入框,用于搜索标识符。
nav.png
图2:跳转到 https://pkg.go.dev/net/http 上的功能

有关文档部分更改的详细信息,请参阅 Go 问题 41587

在主页面的元数据

每个页面的顶部栏现在显示额外的元数据,例如每个包的“导入”和“导入者”计数。 横幅还显示有关模块的最新次要和主要版本的信息。 有关详细信息,请参阅 Go 问题 41588
meta.png
图3:https://pkg.go.dev/github.com/russross/blackfriday 的标头元数据

视频文件

上周在 Google Open Source Live 上,我们在演讲中介绍了新站点体验的演练,Level Up: Go Package Discovery and Editor Tooling
点击查看【codepen】

反馈

我们很高兴与您分享这个更新的设计。 与往常一样,请通过网站每个页面底部的“共享反馈”和“报告问题”链接告诉我们您的想法。
如果你有兴趣为这个项目做贡献,pkg.go.dev 是开源的! 查看贡献指南以了解更多信息。