Wiki

每个项目都内置了一个称为 Wiki 的独立文档系统。默认情况下，所有新项目都启用此功能，您可以在项目的Wiki下找到它。

如果您不想将文档保留在代码仓库中，但确实希望将其保留在代码所在的项目中，则 Wiki 非常方便。

您可以在 Web 界面中或使用 Git 在本地创建 Wiki 页面，因为每个 Wiki 都是单独的 Git 存储库。

创建 Home

首次访问 Wiki 时，系统将指示您创建主页 Home 。它是查看 Wiki 时的默认页面，没有 Home 页的话您将看到的是 Wiki 的文件列表。您只需要填写内容部分，然后单击创建页面 ，您以后可以随时对其进行编辑，因此继续写欢迎信息。

新建 Wiki

**注意：**需要 developer 权限

通过单击可在所有 Wiki 页面中找到的新页面按钮来创建新页面。

系统将要求您为新的 Wiki 页面填写标题。

您可以通过在标题中使用" /"指示子目录来为 Wiki 页面指定完整路径，任何丢失的目录将自动创建。例如， docs/my-page的标题将创建一个 Wiki 页面，其路径为/wikis/docs/my-page 。

输入页面名称后，就该填写其内容了. Wiki 支持 Markdown，RDoc，AsciiDoc 和 Org。对于基于 Markdown 的页面，所有Markdown 功能均受支持，对于链接，则存在一些特定于Wiki 的行为。

在 Web 界面中，提交消息是可选的，但是 Wiki 是基于 Git 的，并且需要提交消息，因此如果您不输入消息，则会为您创建一条。

当你都准备好了后，点击建立页面 就可以完成新页面的新建操作。

附件存储大小

通过界面上传到 Wiki 的任何文件都将存储在 Wiki Git 存储库中，如果您在本地克隆 Wiki 存储库，该文件将可用。

页面标题中的特殊字符

Wiki 页面作为文件存储在 Git 代码仓库中，因此某些字符具有特殊含义：

存储页面时，空格会转换为连字符
显示页面时，连字符（ - ）转换回空格
不能使用斜杠（ / ），因为它们用作路径分隔符

文件及目录的长度限制

许多常见的文件系统的文件名和目录名限制为 255 个字节，尽管 Git 和 CODE CHINA 都支持超出这些限制的路径，但是它们的存在使这些文件系统上的用户无法在本地检出 Wiki 存储库。

为了避免这种情况，通过界面和 API 编辑页面时会强制执行以下限制：

页面标题为 245 个字节（文件扩展名保留 10 个字节）
255 个字节的目录名称

请注意：

非 ASCII 字符占用多个字节
仍然可以通过 Git 在本地创建超出限制的文件和目录，但这可能会在其他人的计算机上中断.

编辑 Wiki

**注意：**需要 developer 权限

要编辑页面，只需单击编辑按钮，然后您可以更改其内容；完成后，单击保存更改以使更改生效。

添加目录

要从 Wiki 页面中的标题生成目录，请使用[[_TOC_]]标签。

删除 Wiki

**注意：**需要 maintainer 权限

仅在编辑页面时才能找到删除按钮，单击它并确认您要删除页面。

移动 Wiki

通过在编辑表单的 Wiki 页面标题中指定完整路径，可以将 Wiki 页面从一个目录移动到另一个目录。

为了将 Wiki 页面移动到根目录，必须在 Wiki 页面标题前加上斜杠（ / ）字符。

查看 Wiki 列表

每个 Wiki 都有一个侧边栏，从中可以找到所创建页面的简短列表，该列表按字母顺序排列。

如果页面很多，则不会在侧边栏中列出所有页面，单击查看所有页面以查看所有页面 。

查看 Wiki 历史

Wiki 页面随时间的变化记录在 Wiki 的 Git 存储库中，您可以通过单击页面历史按钮来查看它们。

从历史记录页面中，您可以看到页面的修订版（Git commit SHA）、作者、提交消息以及上次更新时间，要查看页面的先前版本的外观，请在页面版本列中单击修订号。

查看 Wiki 版本差异

类似于版本化的差异文件视图，您可以看到在给定的 Wiki 页面版本中所做的更改：

进入到您感兴趣的 Wiki 页面
单击页面历史记录以查看所有页面版本
单击更改列中的提交消息以获取您感兴趣的版本

本地添加和编辑 Wiki

由于 Wiki 基于 Git 存储库，因此您可以像在其他所有 Git 存储库中一样在本地克隆它们并进行编辑。

在右侧栏上，单击**克隆存储库"，**然后按照屏幕上的说明进行操作。

根据您要使用的标记语言，您在本地添加到 Wiki 的文件必须具有以下受支持的扩展名之一，否则当推送到 CODE CHINA 时将不会显示这些文件：

Markdown 扩展名： own ， .mkd ， .mkdn ， `` ， .markdown
AsciiDoc 扩展名： .adoc ， .ad ， .asciidoc
其他标记扩展名： .textile ， .rdoc ， .org ， .creole ， .wiki ， .mediawiki ， .rst

自定义侧边栏

在项目的 Wiki 页面上，有一个右侧导航，默认情况下呈现带有层次结构的完整 Wiki 页面列表。

您可以创建一个名为_sidebar的文件以完全替换默认导航，进行自定义设置。

_sidebar示例（使用 Markdown 格式）：

### [Home](home)
 - [Hello World](hello)
- [Foo](foo)
- [Bar](bar)
 ---

- [Sidebar](_sidebar)

GitCode / 帮助文档

wiki