我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

此版本的 GitHub Enterprise 已停止服务 2020-11-12. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

添加或编辑 wiki 页面

您可以直接在 GitHub Enterprise Server 或者本地使用命令行添加和编辑 wiki 页面。

Wikis are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

本文内容

添加 wiki 页面

  1. 在 GitHub Enterprise Server 上,导航到仓库的主页面。
  2. 在仓库名称下,单击 Wiki
    Wiki 菜单链接
  3. 在页面的右上角,单击 New Page(新页面)
    Wiki 新页面按钮
  4. 或者,要以 Markdown 以外的格式,请使用 Edit(编辑)模式下拉菜单,并单击不同的格式。
    Wiki 标记选择
  5. 使用文本编辑器添加页面内容。
    Wiki WYSIWYG
  6. 输入提交消息,描述所添加的新文件。
    Wiki 提交消息
  7. 要提交更改到 wiki,请单击 Save Page(保存页面)

编辑 wiki 页面

  1. 在 GitHub Enterprise Server 上,导航到仓库的主页面。
  2. 在仓库名称下,单击 Wiki
    Wiki 菜单链接
  3. 使用 wiki 侧栏,导航到您要更改的页面。 在页面的右上角,单击 Edit(编辑)
    Wiki 编辑页面按钮
  4. 使用文本编辑器添加页面内容。
    Wiki WYSIWYG
  5. 输入提交消息,描述您的更改。
    Wiki 提交消息
  6. 要提交更改到 wiki,请单击 Save Page(保存页面)

本地添加或编辑 wiki 页面

Wiki 是 Git 仓库的一部分,因此您可以在本地进行更改,然后使用 Git 工作流程将它们推送到仓库。

克隆 wiki 到计算机

每个 wiki 都提供一种将其内容克隆到计算机的简易方式。 您可以选择使用提供的 URL 将仓库克隆到计算机:

$ git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY.wiki.git
# Clones the wiki locally

在克隆 wiki 后,可以添加新文件、编辑现有文件以及提交更改。 您与协作者在操作 wiki 时可以创建分支,但只有推送到默认分支的更改才会生效并供读者使用。

关于 wiki 文件名

文件名确定 wiki 页面的标题,文件扩展名确定 wiki 内容如何呈现。

Wiki 使用我们的开源 Markup 库转换标记,它根据文件扩展名确定要使用的转换器。 例如,如果您将文件命名为 foo.mdfoo.markdown,wiki 将会使用 Markdown 转换器,而名为 foo.textile 的文件将使用 Textile 转换器。

不要在 wiki 页面标题中使用以下字符:\ / : * ? " < > |。 有些操作系统的用户不能使用包含这些字符的文件名。 请确保使用符合扩展名的标记语言编写内容,否则您的内容无法正确呈现。