Pkg.go.dev 网站新设计
Julie Qiu
10 November 2020
自推出 pkg.go.dev 以来,我们收到了很多有关设计和可用性的反馈。特别是在浏览网站时信息的组织方式使用户感到困惑。
今天,我们很高兴分享一个重新设计的 pkg.go.dev,我们希望它会更清晰、更有帮助。这篇博客文章展示了其中的亮点。详细信息,请参阅 Go issue 41585 。
所有路径的登陆页始终保持一致#
主要的变化是 pkg.go.dev/<path>
页面已经围绕路径的概念进行了重组。路径表示模块特定版本中的目录。现在,无论该目录中包含什么内容,每个路径页面都将具有相同的布局,使体验始终一致且可预测。
Fig 1. pkg.go.dev/cloud.google.com/go/sto... 的着陆页。
如果目录里面存在 README,则路径页面将在会自动渲染。以前,概述选项卡只显示自述文件 (如果存在于模块根目录)。这是我们为将最重要的信息放在前面所做的众多更改之一。
文档导航#
文档部分现在显示索引以及网站导航。这使他们能够查看完整的程序包 API,同时在浏览文档时可方便地定位上下文。此外,左侧导航栏中还有一个新的跳转到输入框,用于搜索标识符。
Fig 2. 页面上的跳转功能 pkg.go.dev/net/http.
有关文档部分中的更改的详细信息,请参考 Go issue 41587 。
主页上的元数据#
现在,每个页面的顶部栏显示其他元数据,例如每个程序包的 “引用” 和 “被引用” 计数。还显示有关模块的最新次要和主要版本的信息。有关详细信息,请参见 Go issue 41588 。
Fig 3. 页面元数据 pkg.go.dev/github.com/russross/bla....
演示视频#
上周,在 Google Open Source Live 中,我们在演讲 升级:Go 软件包发现和编辑器工具 中介绍了新站点的体验 。
回馈#
我们很高兴能与您分享此更新的设计。一如既往,请通过网站每个页面底部的 “分享反馈” 和 “报告问题” 链接让我们知道您的想法。
如果您有兴趣为此项目做贡献,pkg.go.dev 是开源的!请查看 贡献指南 了解更多信息。
本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
推荐文章: