跳至主要內容

全新的 conda-forge.org

您可能已經注意到，在過去幾個月中，我們一直在更改 conda-forge.org 網站的不同部分。閱讀更多內容以了解我們更改了什麼、它是如何運作的以及如何貢獻。

舊版與新版​

舊版 conda-forge.org 文件是使用 Sphinx 編寫的。一些額外的擴充功能負責網站的其他部分；例如 部落格、RSS feed、首頁、feedstock 輸出，或 狀態頁面。

新網站已使用 Docusaurus 專案重新編寫。這讓我們能夠為網站的所有部分使用單一框架。如果我們將新網站與舊網站進行比較，會有一些很大的差異

  • Sphinx 是用 Python 編寫的。Docusaurus 使用 Node.js 堆疊。
  • 我們的大部分文件都是用 RST 編寫的。Docusaurus 處理 Markdown 和 MDX (Markdown + JSX)。
  • 我們現在不再從 Jinja 模板生成靜態 HTML，而是偏好獲取 JSON payload 並在建置時（即當我們運行 npm run build 時）或載入時（當使用者訪問網站時）呈現相關頁面。這允許將所有網站呈現邏輯放在同一個儲存庫中，並具有統一的主題、搜尋引擎和統計資料。

我們已變更的內容​

  • 整個網站的主題具有響應式、易於訪問、行動裝置友善，並支援深色/淺色模式。樣式指南也已提供。
  • 狀態儀表板動態獲取資料，並為每個遷移提供詳細視圖。
  • 「套件」部分除了將套件映射到 feedstock 外，還列出了最新的更新。
  • 新的「下載」頁面顯示最新 Miniforge 安裝程式的連結。
  • 文件已分為兩個頂層類別：「文件」和「社群」。
  • Algolia 慷慨地為搜尋欄提供後端服務。
  • Netlify 將為每個開啟的 PR 呈現預覽，以實現更順暢的貢獻流程。
  • 部落格文章和公告 feed 由 Docusaurus 原生提供服務。
  • 我們將所有 Sphinx 原生的 ReStructuredText 文件轉換為 Docusaurus 友善的 Markdown。
  • conda-forge.yml 文件是從 conda-smithy 結構描述自動生成的。
  • ... 以及文件中許多較小的變更。請參閱 meta-issue 以獲取更多資訊！

您可以使用的新功能​

  • 在主要文件部分中了解如何使用和維護來自 conda-forge 的套件。
  • 在社群部分中閱讀有關我們社群如何建立的資訊
  • 我們基礎架構的最新變更將在最新消息中宣布。您還可以訂閱 RSS feed 並瀏覽封存。
  • 有關生態系統的重要資訊在部落格中討論。您還可以訂閱 RSS feed 並瀏覽封存。這些文章有時也會使用 標籤 進行分類。
  • 使用搜尋欄查找網站中的任何文件！它應該足夠智能，可以記住您更常需要的內容。使用 Cmd/Ctrl+K 快捷鍵以更快存取。
  • 狀態儀表板將告知您最新的事件和正在進行的遷移。現在每個遷移都有一個您可以瀏覽和分享的永久連結！
  • 套件部分將幫助您找到 conda-forge 中的所有套件。如果您在搜尋欄中沒有輸入任何內容，它將列出最近 100 個上傳到 Anaconda.org 頻道的套件。每行的元數據連結將帶您到 conda-metadata-app 儀表板。
  • 使用下載頁面獲取最新的 Miniforge 安裝程式。

如何幫助和貢獻​

我們已經更改了很多內容，因此有可能我們在某處遺漏了一些內容。如果您有建議或錯誤要報告，請在網站問題追蹤器中告知我們。也請隨時查看文件貢獻指南。

致謝​

這次改版是歷時數月的努力。核心團隊想藉此機會感謝所有促成這次改版的貢獻者（按字母順序排列）：Afshin Darian、Asmit Malakannawar、Gabriela Vives、Isabela Presedo-Floyd、Klaus Zimmermann、Tania Allard。