:::info
日期:2020 年 11 月 10 日
作者:Julie Qiu
原文链接:https://go.dev/blog/pkgsite-redesign
:::
自从推出 pkg.go.dev 以来,我们收到了很多关于设计和可用性的很好的反馈。 特别是,很明显,在浏览网站时,信息的组织方式让用户感到困惑。
今天我们很高兴分享一个重新设计的 pkg.go.dev,我们希望它会更清晰、更有帮助。 这篇博文介绍了重点。 有关详细信息,请参阅 Go 问题 41585。
所有路径的登录页面一致
主要的变化是 pkg.go.dev/
图1:登录页
路径页面将在该路径显示自述文件(如果有)。 以前,如果存在于模块根目录,则概览选项卡仅显示自述文件。 这是我们为将最重要的信息放在最前面所做的众多更改之一。
文档导航
文档部分现在显示一个索引和一个左侧导航栏。 这提供了查看完整包 API 的能力,同时在浏览文档部分时具有上下文。 左侧导航栏中还有一个新的跳转到输入框,用于搜索标识符。
图2:跳转到 https://pkg.go.dev/net/http 上的功能
有关文档部分更改的详细信息,请参阅 Go 问题 41587。
在主页面的元数据
每个页面的顶部栏现在显示额外的元数据,例如每个包的“导入”和“导入者”计数。 横幅还显示有关模块的最新次要和主要版本的信息。 有关详细信息,请参阅 Go 问题 41588。
图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 是开源的! 查看贡献指南以了解更多信息。