title: "贡献指南" post_status: publish comment_status: open taxonomy: category: - wordpress post_tag: - Hosting Handbook - Repos - Data

贡献指南

感谢您有兴趣为 WordPress 托管团队手册 做出贡献！如果您对任何内容不确定，请放心，我们 💯 欢迎您就任何主题 提交 Issue 或 Pull Request。最坏的情况也只是您会被礼貌地引导到提问或修改 Pull Request 的最佳位置。所有贡献都是有价值的，而一长串规则可能会阻碍这一点。

与所有 WordPress 项目一样，确保为每个人提供一个友好的环境是我们的首要任务。考虑到这一点，所有贡献者都应遵守我们的 行为准则。

所有 WordPress 项目均 采用 GPLv2+ 许可证，对本项目的所有贡献也将根据 GPLv2+ 许可证发布。您保留对所做贡献的版权，提交 Pull Request 即表示您同意根据 GPLv2+ 许可证发布该贡献。

进行编辑

欢迎提交 Pull Request！

您可以通过以下方式发起 Pull Request（PR）：使用手册页面旁的"编辑"按钮，或复刻并克隆仓库（请查看复刻网络）。

所有文档均使用 Markdown 格式的纯文本编写。无需担心特定的 Markdown 变体，因为在生成 HTML 前会进行检查和清理。

无论采用哪种方式，请附上修改目的的说明，以便他人轻松审阅。

任何编辑都需要至少两位托管团队成员审阅后方可合并。可在 Pull Request 表单的右上角请求审阅。

页面中的资源

图片等资源不会自动导入到手册中。因此，资源必须包含在仓库的 /assets/ 目录下的 Pull Request 中以便追踪。

如果您要合并包含资源的 Pull Request，请在合并前将资源上传至 WordPress 托管手册的媒体库，并直接链接到已上传的媒体文件。

生成清单

当手册中添加了新页面，或在 Pull Request 期间页面的标题或路径发生更改时，目前需要手动重新生成清单，以便将其导入手册。

包含一个 WP-CLI 命令来处理此操作。要运行它，请从克隆的手册仓库中：

• 通过运行 wp 或 which wp 检查是否已安装 WP-CLI
• 如果需要，请使用 WP-CLI.org 的安装说明 或您喜欢的包管理器安装 WP-CLI
• 运行 wp hosting-handbook gen-all

清单应在仓库内的 /bin/handbook-manifest.json 中创建。