Go 博客

Pkg.go.dev 全新上线!

Julie Qiu
2020年11月10日

pkg.go.dev 推出以来,我们收到了许多关于设计和可用性的宝贵反馈。尤其是,大家普遍反映网站信息组织方式让用户在浏览时感到困惑。

今天,我们很高兴地推出改版后的 pkg.go.dev,希望它能更加清晰和实用。本篇博文将介绍主要亮点。更多详情,请参阅 Go issue 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 issue 41587

主页上的元数据

每个页面的顶部栏现在显示额外的元数据,例如每个包的“导入”和“被导入”计数。横幅还显示有关模块最新次要和主要版本的信息。有关详细信息,请参阅 Go issue 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 的 11 年
上一篇文章:发布 2020 年 Go 开发者调查
博客索引