Pkg.go.dev 网站新设计

未匹配的标注

本文为官方 Go Blog 的中文翻译,详见 翻译说明

Julie Qiu
10 November 2020

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

今天,我们很高兴分享一个重新设计的 pkg.go.dev,我们希望它会更清晰、更有帮助。这篇博客文章展示了其中的亮点。详细信息,请参阅 Go issue 41585

所有路径的登陆页始终保持一致

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

Pkg.go.dev 网站新设计

Fig 1.  pkg.go.dev/cloud.google.com/go/sto... 的着陆页。

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

文档导航

文档部分现在显示索引以及网站导航。这使他们能够查看完整的程序包 API,同时在浏览文档时可方便地定位上下文。此外,左侧导航栏中还有一个新的跳转到输入框,用于搜索标识符。

Jump To feature navigating net/http

Fig 2. 页面上的跳转功能 pkg.go.dev/net/http.

有关文档部分中的更改的详细信息,请参考 Go issue 41587 。

主页上的元数据

现在,每个页面的顶部栏显示其他元数据,例如每个程序包的 “引用” 和 “被引用” 计数。还显示有关模块的最新次要和主要版本的信息。有关详细信息,请参见 Go issue 41588 。

Header metadata for github.com/russross/blackfriday

Fig 3. 页面元数据 pkg.go.dev/github.com/russross/bla....

演示视频

上周,在 Google Open Source Live 中,我们在演讲 升级:Go软件包发现和编辑器工具 中介绍了新站点的体验 。

回馈

我们很高兴能与您分享此更新的设计。一如既往,请通过网站每个页面底部的“分享反馈”和“报告问题”链接让我们知道您的想法。

如果您有兴趣为此项目做贡献,pkg.go.dev是开源的!请查看 贡献指南 了解更多信息。

本文章首发在 LearnKu.com 网站上。

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。

原文地址:https://learnku.com/docs/go-blog/new-des...

译文地址:https://learnku.com/docs/go-blog/new-des...

上一篇 下一篇
Summer
贡献者:1
讨论数量: 0
发起讨论 只看当前版本


暂无话题~