{"meta":{"title":"添加或编辑 wiki 页面","intro":"可以使用命令行直接在 GitHub 或本地添加和编辑 Wiki 页面。","product":"建设社区","breadcrumbs":[{"href":"/zh/communities","title":"建设社区"},{"href":"/zh/communities/documenting-your-project-with-wikis","title":"使用 wiki"},{"href":"/zh/communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages","title":"管理 wiki 网页"}],"documentType":"article"},"body":"# 添加或编辑 wiki 页面\n\n可以使用命令行直接在 GitHub 或本地添加和编辑 Wiki 页面。\n\n## 添加 wiki 页面\n\n1. 在 GitHub 上，导航到存储库的主页面。\n\n2. 在仓库名称下，单击 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-book\" aria-label=\"book\" role=\"img\"><path d=\"M0 1.75A.75.75 0 0 1 .75 1h4.253c1.227 0 2.317.59 3 1.501A3.743 3.743 0 0 1 11.006 1h4.245a.75.75 0 0 1 .75.75v10.5a.75.75 0 0 1-.75.75h-4.507a2.25 2.25 0 0 0-1.591.659l-.622.621a.75.75 0 0 1-1.06 0l-.622-.621A2.25 2.25 0 0 0 5.258 13H.75a.75.75 0 0 1-.75-.75Zm7.251 10.324.004-5.073-.002-2.253A2.25 2.25 0 0 0 5.003 2.5H1.5v9h3.757a3.75 3.75 0 0 1 1.994.574ZM8.755 4.75l-.004 7.322a3.752 3.752 0 0 1 1.992-.572H14.5v-9h-3.495a2.25 2.25 0 0 0-2.25 2.25Z\"></path></svg>“Wiki”\\*\\*\\*\\*。\n\n   ![存储库中菜单的屏幕截图。 “Wiki”选项用深橙色框标出。](/assets/images/help/wiki/wiki-menu-link.png)\n\n3. 在页面的右上角，单击“新页面”。\n\n4. 或者，要以 Markdown 以外的其他格式写入，请使用“编辑模式”下拉列表以选择其他格式。\n\n   ![“新建页面”页的屏幕截图。 “编辑模式”下拉列表用深橙色框标出。](/assets/images/help/wiki/wiki-edit-mode-dropdown.png)\n\n5. 使用文本编辑器添加页面内容。\n\n6. 在“编辑消息”字段中，键入描述要添加的新文件的提交消息。\n\n7. 要将更改提交到 Wiki，请单击“保存页面”。\n\n## 编辑 wiki 页面\n\n1. 在 GitHub 上，导航到存储库的主页面。\n2. 在仓库名称下，单击 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-book\" aria-label=\"book\" role=\"img\"><path d=\"M0 1.75A.75.75 0 0 1 .75 1h4.253c1.227 0 2.317.59 3 1.501A3.743 3.743 0 0 1 11.006 1h4.245a.75.75 0 0 1 .75.75v10.5a.75.75 0 0 1-.75.75h-4.507a2.25 2.25 0 0 0-1.591.659l-.622.621a.75.75 0 0 1-1.06 0l-.622-.621A2.25 2.25 0 0 0 5.258 13H.75a.75.75 0 0 1-.75-.75Zm7.251 10.324.004-5.073-.002-2.253A2.25 2.25 0 0 0 5.003 2.5H1.5v9h3.757a3.75 3.75 0 0 1 1.994.574ZM8.755 4.75l-.004 7.322a3.752 3.752 0 0 1 1.992-.572H14.5v-9h-3.495a2.25 2.25 0 0 0-2.25 2.25Z\"></path></svg>“Wiki”\\*\\*\\*\\*。\n\n   ![存储库中菜单的屏幕截图。 “Wiki”选项用深橙色框标出。](/assets/images/help/wiki/wiki-menu-link.png)\n3. 使用右侧的 Wiki 边栏，导航到要更改的页面。 在页面的右上角，单击“编辑”。\n4. 使用文本编辑器编辑页面内容。\n5. 在“编辑消息”字段中，键入描述所做更改的提交消息。\n6. 要将更改提交到 Wiki，请单击“保存页面”。\n\n## 本地添加或编辑 wiki 页面\n\nWiki 是 Git 仓库的一部分，因此您可以在本地进行更改，然后使用 Git 工作流程将它们推送到仓库。\n\n### 克隆维基到你的计算机\n\n每个 wiki 都提供一种将其内容克隆到计算机的简易方式。\n创建初始页面 GitHub后，可以使用提供的 URL 将存储库克隆到计算机：\n\n```shell\n$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.wiki.git\n# Clones the wiki locally\n```\n\n在克隆 wiki 后，可以添加新文件、编辑现有文件以及提交更改。 您与协作者在操作 wiki 时可以创建分支，但只有推送到默认分支的更改才会生效并供读者使用。\n\n## 关于 wiki 文件名\n\n文件名确定 wiki 页面的标题，文件扩展名确定 wiki 内容如何呈现。\n\nWiki 使用[开放源代码 Markup 库](https://github.com/github/markup)转换标记，它根据文件扩展名确定要使用的转换器。 例如，如果将文件命名为 foo.md 或 foo.markdown，Wiki 将会使用 Markdown 转换器，而名为 foo.textile 的文件将使用 Textile 转换器  。\n\n请勿在 Wiki 页面标题中使用以下字符：`\\ / : * ? \" < > |`。 有些操作系统的用户不能使用包含这些字符的文件名。 请确保使用符合扩展名的标记语言编写内容，否则您的内容无法正确呈现。"}