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 開發者調查
部落格索引