预配的 wiki 与发布为代码 Wiki

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

可以在团队项目 Wiki 或发布为代码 Wiki 中维护 Wiki 内容。通过 发布为代码 Wiki，可以维护多个版本的 Wiki 以满足内容需求。启用 Azure Repos 时，此选项可用。

虽然这两个选项都在 Git 存储库中维护 Wiki 内容，但添加、更新和管理 Wiki 内容的方式有所不同。

维护 Wiki 内容

对于这两种类型的 Wiki，可以直接在 GitHub 中工作或脱机工作，然后将更改推送到存储库。

对于 预配的 Wiki，可以直接在存储库的 Wiki Pages 部分中添加和维护 Wiki>页面。 对预配的 Wiki 进行的所有内容更新都发生在 Wiki 本身中。

对于 以代码形式发布的 Wiki，您可以在存储库中添加和维护 Wiki 内容，并以代码文件的形式存储。访问 GitHub 上存储库的 Repos 或 Code 部分中的文件。

下图显示了 预配 Wiki 的菜单选项：

某些菜单选项不适用于作为代码 Wiki 发布的页面。对于 已发布的代码 Wiki， “在 Repos 中编辑 ”选项将打开当前页，以便你可以就地编辑内容。对所选分支中 Wiki 中的页面进行更新后，会自动发布到 Wiki。

“新建”页和“添加子页”菜单选项可用于 GitHub 中的这两种类型的 Wiki。有关详细信息，请参阅 “添加和编辑 Wiki 页面”。

这两种类型的 Wiki 都在 Git 存储库中应用相同的文件夹和文件结构。区别在于如何维护页面序列。

对于 预配的 Wiki，GitHub 会在在导航窗格中添加或移动页面时自动管理页面序列和页面列表。

对于发布为代码 wiki 的内容，需要手动维护页面顺序。若要在导航窗格中构建页面列表，请在根页和包含子页的每个子文件夹或父页中定义 一个 .order 文件。有关详细信息，请参阅 Wiki Git 存储库文件和文件结构。

在 Git 存储库的 Wiki 页面中，可以查看 Wiki 中任何页面的修订。使用 “修订 ”或 “查看修订 ”菜单选项。若要将当前页内容还原到早期版本，该过程因 Wiki 页面类型而异。

对于 已配置的 Wiki 页面，请选择 “还原” 菜单选项。有关详细信息，请参阅将提交还原到预配的 Wiki 页面。

对于发布为代码 Wiki的页面，您需要从本地分支工作，并提交拉取请求来更新您正在处理的分支。

通过版本控制支持，可以根据 Git 存储库的版本控制分支将不同的内容版本发布到不同的 Wiki。

只有发布代码以创建 wiki 的用户，才能对 wiki 进行版本管理和取消发布。有关详细信息，请参阅取消发布代码 Wiki。

以下步骤介绍如何删除项目 Wiki。

注意

不能使用 REST API 删除项目 Wiki。而是直接删除 Wiki 存储库。

克隆 Wiki 存储库以备份所有内容。可以在 “更多选项” 菜单上找到 Wiki URL（...）。
获取与 Wiki 关联的 Git 存储库 ID。可以使用 REST API 获取项目中的所有 Wiki。

例如，该 GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 命令返回项目中的所有 Wiki。运行命令并选择要删除的 Wiki。
使用 REST API 删除与 Wiki 关联的 Git 存储库。使用之前找到的项目 Wiki 的存储库 ID。仔细检查存储库 ID，确保不会删除错误的 Wiki。

例如， DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 该命令将删除 wiki。将 <repositoryId> 替换为要删除的维基的存储库 ID。

你可以脱机工作，也可以在本地分支中更新这两种类型的 Wiki 的内容。有关详细信息，请参阅脱机克隆和更新 Wiki 页面。

这两种类型的 Wiki 都支持其他几个功能和作：

一些作和功能仅适用于一种类型的 Wiki 或用法方法不同：