将页面从 Wiki 扩展迁移到团队项目 Wiki

2025-04-15

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

了解如何将使用 Wiki 市场扩展创建的页面迁移到团队项目 Wiki。可将使用 Wiki 市场扩展创建的任意 Wiki 页面保存到团队项目中的 Git 存储库。

注释

先决条件

类别	要求
项目访问权限	Wiki 所在的项目的成员。如果没有访问权限，请从项目管理员请求它。
权限	参与者组的成员。
访问级别	至少具有基本访问权限。

迁移页面和其他工件的概述

克隆 vsts-wikiTools 存储库并编译 MigrateToVSTSWiki 工具。
创建然后克隆 Azure DevOps Wiki。
将所有 Markdown 页面移动到 Azure DevOps Wiki 并将其提交。
运行 Wiki 迁移工具 MigrateToVSTSWiki.exe
Wiki 迁移工具完成后，将更改推送到 Azure DevOps Wiki 存储库的默认主分支 wikiMain。

从 Wiki 扩展迁移页面

克隆 vsts-wikiTools 存储库并编译 MigrateToVSTSWiki 工具。
要生成迁移工具 EXE，请编译路径 Tools/MigrateToVSTSWiki 下的项目。
在 Web 浏览器中打开 Azure DevOps 团队项目，并创建第一个 Wiki 页面。
要克隆 Wiki，请获取 URL。有关详细信息，请参阅克隆 Wiki 并离线编辑 Wiki 页面。
将此克隆位置命名为 LocationA，以用于此过程。
使用 IDE 或 git clone 命令克隆 wiki 存储库。
克隆 wiki 扩展存储库。该 Wiki 关联到在创建 Wiki 时提供给你的文件夹。可以通过转到现有 wiki 中的管理 wiki 选项进行确认，如以下示例所示。现有 Wiki 页面保存在标记为 Root的文件夹中。

例如，你在位置 C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki 克隆了前面提到的 sampleWiki

将此位置在此过程中命名为 LocationB。
在本地计算机上的任意路径中创建一个空文件夹，并针对此过程将其命名为 LocationC。

总之，以下位置如下所示：
- 位置 A = Azure DevOps Wiki 存储库
- 位置 B = Wiki 扩展存储库
- 位置 C = 运行迁移工具的空文件夹
以管理员身份打开命令提示符并运行 MigrateToVSTSWiki.exe。此工具将文件从现有 Wiki 复制到你提供的目标目录。在复制期间，该工具会将页面转换为符合 Azure DevOps Wiki 的要求。

MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

例如：
- E:\wiki\sampleWiki\_extensionWiki 是现有 Wiki 文件所在的文件夹
- E:\Temp\Wiki\New 是一个空文件夹，用于复制迁移的文件。
从 LocationA 文件夹中删除所有文件，除了与 Git 相关的文件，比如 .gitignore等。
复制 LocationC 中的所有文件并将其粘贴到 LocationA 中。
运行 git add . 将所有新添加的文件暂存到 LocationA 中以进行提交。
运行 git commit -m <commit message> 以提交本地暂存的文件。
运行 git push origin wikiMain -f，将更改推送到 Azure DevOps Wiki 的默认分支。

将 Wiki 扩展文件迁移到 Azure DevOps Wiki 后，即可卸载 Wiki 扩展。

后续步骤

卸载 Wiki 扩展

发布内容

此项目采用了 Microsoft 开放源代码行为准则。有关详细信息，请参阅行为准则常见问题解答或与 opencode@microsoft.com 联系，如有任何问题或意见。

通过