| ... | ... | @@ -4,7 +4,7 @@ |
|
|
|
|
|
|
|
如果您不想将文档保留在代码仓库中，但确实希望将其保留在代码所在的项目中，则 Wiki 非常方便。
|
|
|
|
|
|
|
|
您可以在 Web 界面中或[使用 Git 在本地](#adding-and-editing-wiki-pages-locally)创建 Wiki 页面，因为每个 Wiki 都是单独的 Git 存储库。
|
|
|
|
您可以在 Web 界面中或[使用 Git 在本地](#本地添加和编辑-wiki)创建 Wiki 页面，因为每个 Wiki 都是单独的 Git 存储库。
|
|
|
|
|
|
|
|
## 创建 Home [](#first-time-creating-the-home-page "Permalink")
|
|
|
|
|
| ... | ... | @@ -14,13 +14,13 @@ |
|
|
|
|
|
|
|
**注意：**需要 developer [权限](/docs/user/permissions)
|
|
|
|
|
|
|
|
通过单击可在所有 Wiki 页面中找到的" **新页面"**按钮来创建新页面。
|
|
|
|
通过单击可在所有 Wiki 页面中找到的**新页面**按钮来创建新页面。
|
|
|
|
|
|
|
|
系统将要求您为新的 Wiki 页面填写标题。
|
|
|
|
|
|
|
|
您可以通过在标题中使用" /"指示子目录来为 Wiki 页面指定完整路径，任何丢失的目录将自动创建。例如， `docs/my-page`的标题将创建一个 Wiki 页面，其路径为`/wikis/docs/my-page` 。
|
|
|
|
|
|
|
|
输入页面名称后，就该填写其内容了. Wiki 支持 Markdown，RDoc，AsciiDoc 和 Org。对于基于 Markdown 的页面，所有[Markdown 功能](/docs/user/markdown)均受支持，对于链接，则存在一些[特定](/docs/user/markdown#wiki-specific-markdown)于[Wiki 的](/docs/user/markdown#wiki-specific-markdown)行为。
|
|
|
|
输入页面名称后，就该填写其内容了. Wiki 支持 Markdown，RDoc，AsciiDoc 和 Org。对于基于 Markdown 的页面，所有[Markdown 功能](/docs/user/markdown)均受支持，对于链接，则存在一些[特定](/docs/user/markdown#wiki-内链-markdown)于[Wiki 的](/docs/user/markdown#wiki-内链-markdown)行为。
|
|
|
|
|
|
|
|
在 Web 界面中，提交消息是可选的，但是 Wiki 是基于 Git 的，并且需要提交消息，因此如果您不输入消息，则会为您创建一条。
|
|
|
|
|
| ... | ... | @@ -56,7 +56,7 @@ Wiki 页面作为文件存储在 Git 代码仓库中，因此某些字符具有 |
|
|
|
|
|
|
|
**注意：**需要 developer [权限](/docs/user/permissions)
|
|
|
|
|
|
|
|
要编辑页面，只需单击" **编辑"**按钮，然后您可以更改其内容；完成后，单击" **保存更改"**以使更改生效。
|
|
|
|
要编辑页面，只需单击**编辑**按钮，然后您可以更改其内容；完成后，单击**保存更改**以使更改生效。
|
|
|
|
|
|
|
|
### 添加目录[](#adding-a-table-of-contents "Permalink")
|
|
|
|
|
| ... | ... | @@ -66,11 +66,11 @@ Wiki 页面作为文件存储在 Git 代码仓库中，因此某些字符具有 |
|
|
|
|
|
|
|
**注意：**需要 maintainer [权限](/docs/user/permissions)
|
|
|
|
|
|
|
|
仅在编辑页面时才能找到" **删除"**按钮，单击它并确认您要删除页面。
|
|
|
|
仅在编辑页面时才能找到**删除**按钮，单击它并确认您要删除页面。
|
|
|
|
|
|
|
|
## 移动 Wiki [](#moving-a-wiki-page "Permalink")
|
|
|
|
|
|
|
|
通过在[编辑](#editing-a-wiki-page)表单的 Wiki 页面标题中指定完整路径，可以将 Wiki 页面从一个目录移动到另一个目录。
|
|
|
|
通过在[编辑](#编辑-wiki)表单的 Wiki 页面标题中指定完整路径，可以将 Wiki 页面从一个目录移动到另一个目录。
|
|
|
|
|
|
|
|
为了将 Wiki 页面移动到根目录，必须在 Wiki 页面标题前加上斜杠（ `/` ）字符。
|
|
|
|
|
| ... | ... | @@ -84,7 +84,7 @@ Wiki 页面作为文件存储在 Git 代码仓库中，因此某些字符具有 |
|
|
|
|
|
|
|
Wiki 页面随时间的变化记录在 Wiki 的 Git 存储库中，您可以通过单击**页面历史**按钮来查看它们。
|
|
|
|
|
|
|
|
从历史记录页面中，您可以看到页面的修订版（Git commit SHA）、作者、提交消息以及上次更新时间，要查看页面的先前版本的外观，请在" **页面版本"**列中单击修订号。
|
|
|
|
从历史记录页面中，您可以看到页面的修订版（Git commit SHA）、作者、提交消息以及上次更新时间，要查看页面的先前版本的外观，请在**页面版本**列中单击修订号。
|
|
|
|
|
|
|
|
### 查看 Wiki 版本差异[](#viewing-the-changes-between-page-versions "Permalink")
|
|
|
|
|
| ... | ... | @@ -92,13 +92,13 @@ Wiki 页面随时间的变化记录在 Wiki 的 Git 存储库中，您可以通 |
|
|
|
|
|
|
|
1. 进入到您感兴趣的 Wiki 页面
|
|
|
|
2. 单击**页面历史记录**以查看所有页面版本
|
|
|
|
3. 单击" **更改"**列中的提交消息以获取您感兴趣的版本
|
|
|
|
3. 单击**更改**列中的提交消息以获取您感兴趣的版本
|
|
|
|
|
|
|
|
## 本地添加和编辑 Wiki[](#adding-and-editing-wiki-pages-locally "Permalink")
|
|
|
|
|
|
|
|
由于 Wiki 基于 Git 存储库，因此您可以像在其他所有 Git 存储库中一样在本地克隆它们并进行编辑。
|
|
|
|
|
|
|
|
在右侧栏上，单击" **克隆存储库"，**然后按照屏幕上的说明进行操作。
|
|
|
|
在右侧栏上，单击**克隆存储库"，**然后按照屏幕上的说明进行操作。
|
|
|
|
|
|
|
|
根据您要使用的标记语言，您在本地添加到 Wiki 的文件必须具有以下受支持的扩展名之一，否则当推送到 CODEChina 时将不会显示这些文件：
|
|
|
|
|
| ... | ... | |
