为项目创建 Wiki

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

在 Azure DevOps 中,每个团队项目都有一个 Wiki。 可以使用 Wiki 与团队共享信息,并支持项目贡献。 Wiki 由后端中的 Git 存储库提供支持。 本文介绍如何打开项目 Wiki 并创建 Git 存储库。

创建团队项目时,默认情况下不会创建 Wiki Git 存储库。 可以创建存储库来存储 Wiki Markdown 文件,或 将现有 Markdown 文件从 Git 存储库发布到 Wiki。

先决条件

类别 要求
项目访问权限 Wiki 所在的项目的成员。 如果没有访问权限,请从项目管理员请求它。 有权访问团队项目的任何人都可以查看 Wiki,包括 利益干系人
权限 - 若要添加或编辑 wiki 页面:参与者 组的成员。
- 若要将代码发布为 wiki:创建存储库 权限。 默认情况下,此权限是为项目管理员组的成员设置的。
访问级别 至少具有基本访问权限。

打开 Wiki

可以在浏览器中从 Azure DevOps 打开并查看团队项目的 Wiki 页面,也可以使用 Azure DevOps CLI。

使用 受支持的 Web 浏览器 连接到项目,然后选择 Wiki

浏览器中打开 Wiki 的屏幕截图,其中显示了 Wiki 概述页。

如果需要切换团队项目,请选择 Azure DevOps浏览所有团队项目和团队

创建 Wiki Git 存储库

本部分介绍如何为 Wiki 创建 Git 存储库。 可以直接在浏览器中使用 Azure DevOps UI,也可以使用 Azure DevOps CLI。

在浏览器中,可以创建新的 Git 存储库来存储 Wiki 页面和相关项目。 在 Wiki 登陆页面中,选择“ 创建项目 Wiki”。 即使使用 Team Foundation 版本控制(TFVC)进行源代码管理,也可以使用 Git 存储库创建 Wiki。

显示如何在 Azure DevOps 中选择“创建项目 Wiki”或“发布代码”作为 Wiki 选项的屏幕截图。

如果没有创建 Wiki Git 存储库所需的权限,或者无法访问任何现有 Wiki,则会看到以下消息:

用户没有足够的权限创建 Wiki Git 存储库的消息的屏幕截图。

具有 Project 管理员级访问权限的用户可以创建 Wiki Git 存储库。 具有利益干系人访问权限的用户无法创建 Wiki,因为它们无权在项目的 ReposCode 部分中工作。

Wiki 存储库的名称基于项目名称。 约定为 <ProjectName>.wiki. 如果团队项目名称为 Contoso ,则 Wiki 存储库名称为 Contoso.wiki.

小窍门

可以通过将 代码发布为 Wiki 为单个项目创建多个 Wiki。

访问你的维基代码库

Wiki (ProjectName.wiki) 的 Git 存储库未包含在项目的 ReposCode 部分中存储库的下拉列表中。 Wiki 存储库也不会在 项目设置 > 存储库版本控制 页中列出。 相反,可以从 Wiki 的 Repos>文件 页访问 Wiki 存储库。

  1. 创建 Repos>文件 页的 URL。 在以下 URL 中,将服务器、组织、项目和 wiki 名称替换为任何 <Placeholder> 部分:

    https://dev.azure.com/<Organization>/<ProjectName>/_git/<WikiName>

    https://<ServerName>/Default_Collection/<ProjectName>/_git/<WikiName>

  2. 将 URL 粘贴到浏览器中,然后打开 Wiki 的“文件” 页。

  3. “存储库>文件 ”页上,找到 Wiki 存储库名称并选择 “更多选项 ”(...) >克隆

    显示如何打开 Wiki 存储库的 Repos 文件页,然后选择“克隆”选项的屏幕截图。

    克隆 ”选项将打开一个对话框,其中包含 Wiki 存储库的 URL。

  4. 在对话框中,选择 “HTTP ”,然后选择 “复制 ”图标(双页):

    显示如何通过选择 HTTP 选项和“复制”图标来访问 Wiki 存储库 URL 的屏幕截图。

    URL 将复制到剪贴板。

    关闭对话框。

  5. 若要访问 Wiki 存储库,请将复制的 URL 粘贴到浏览器中。

后续步骤