Go 博客

Pkg.go.dev 焕然一新!

Julie Qiu
2020年11月10日

自推出 pkg.go.dev 以来,我们收到了大量关于设计和可用性的宝贵反馈。特别是,用户在浏览网站时,信息组织方式让他们感到困惑,这一点非常明确。

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

所有路径的统一着陆页

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

Landing page for cloud.google.com/go/storage
图 1. https://pkg.go.dev/cloud.google.com/go/storage 的着陆页。

如果该路径下存在 README 文件,路径页面将显示它。以前,概述选项卡仅在模块根目录中存在 README 时才显示。这是我们为优先展示最重要信息而进行的众多更改之一。

文档导航

文档部分现在显示索引以及侧边导航栏。这使得用户在浏览文档部分时能够查看完整的软件包 API 并了解上下文。左侧边导航栏中还有一个新的“跳转到”输入框,用于搜索标识符。

Jump To feature navigating net/http
图 2. https://pkg.go.dev/net/http 上的“跳转到”功能。

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

主页面元数据

每个页面顶部的条现在显示额外的元数据,例如每个软件包的“imports”和“imported by”计数。横幅还显示有关模块最新次要版本和主要版本的信息。有关详细信息,请参见 Go 问题 41588

Header metadata for github.com/russross/blackfriday
图 3. https://pkg.go.dev/github.com/russross/blackfriday 的头部元数据。

视频演示

上周在 Google Open Source Live 活动中,我们在题为 Level Up: Go Package Discovery and Editor Tooling 的讲座中演示了新的网站体验。

反馈

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

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

下一篇文章:Go 的十一年
上一篇文章:宣布 2020 年 Go 开发者调查
博客索引