MDN 網頁文件儲存庫
MDN 網頁文件 是一個複雜的專案,包含許多活動的部分。熟悉專案不同的儲存庫是一個好主意。本文件旨在幫助您找到在為 MDN 網頁文件專案的不同部分做出貢獻時可能需要的不同儲存庫 (repo)。
儲存庫層級
第 1 層
這些儲存庫中的程式碼是 MDN 網頁文件專案的核心,並在 Mozilla 擁有的域上執行。
第 1 層專案至少應有 3 名成員,其中至少 2 名具有管理員許可權。
第 2 層
這些儲存庫主要集中在支援內容,如程式碼示例、MDN 網頁文件學習區域、本地化和示例專案。示例包括
第 2 層專案至少應有 2 名成員,其中至少 1 名具有管理員許可權。
第 3 層
核心儲存庫
- 核心內容: https://github.com/mdn/content。MDN 網頁文件內容最重要的儲存庫 - 這裡存放著網站的所有核心英語內容,您將在那裡進行對頁面內容的所有標準更改。
- MDN 網頁文件平臺: https://github.com/mdn/yari。這是 MDN 網頁文件平臺的存放位置,如果您想對我們高級別的頁面結構或渲染機制進行更改,請訪問這裡。
- 瀏覽器相容性資料: https://github.com/mdn/browser-compat-data。這裡存放著用於生成我們參考頁面上找到的瀏覽器相容性表格的資料 (示例)。如果您有關於網頁功能瀏覽器相容性的資訊 - 或者願意並能夠進行一些研究和/或實驗 - 您可以幫助更新 MDN 的 瀏覽器相容性資料
- 互動式示例: https://github.com/mdn/interactive-examples。此儲存庫存放著我們許多參考頁面頂部找到的示例程式碼塊 (示例)。在這裡編輯這些示例。
- Bob 也稱為 Builder of Bits: https://github.com/mdn/bob 此儲存庫存放著用於生成我們許多參考頁面頂部找到的漂亮的可編輯、可複製的示例的渲染程式碼 (示例)。
- 翻譯後的內容: https://github.com/mdn/translated-content。這是本地化內容的存放位置。如果您想幫助將頁面翻譯成我們的任何 積極維護的語言環境,請訪問這裡。
- 工作流程: https://github.com/mdn/workflows 在 MDN 網頁文件儲存庫中使用的可重用 GitHub 操作的不斷增長集合。
程式碼示例
程式碼示例和演示
MDN 網頁文件 GitHub 組織包含大量示例儲存庫。這些通常包含獨立的程式碼示例,這些示例通常從我們的頁面連結到,但有時您會發現這些示例中的一個透過像這樣的宏呼叫嵌入到頁面中 - {{EmbedGHLiveSample("css-examples/learn/tasks/grid/grid1.html", '100%', 700)}}。
請記住,如果您更新任何給定頁面的程式碼,您還需要更新相應的示例儲存庫。