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)}}
。
请记住,如果您更新任何给定页面的代码,您还需要更新相应的示例存储库。