通过

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

  • 项目

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

了解如何将使用 Wiki 市场扩展创建的页面迁移到团队项目 Wiki。 随着内置 Wiki 的发布，使用 Wiki 市场扩展创建的任何 Wiki 页面都可以保存到团队项目中的 Git 存储库。

先决条件

成为团队项目的“参与者”组的成员，将 Wiki 页面迁移到团队项目 Wiki。

迁移页面和其他项目

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

详细步骤

  1. 克隆 vsts-wikiTools 存储库并编译 MigrateToVSTSWiki 工具。

  2. 在路径 Tools/MigrateToVSTSWiki 下编译项目以生成迁移工具 EXE。

  3. 在 Web 浏览器中打开 Azure DevOps 团队项目，创建第一个 wiki 页面。

  4. 获取用于克隆 Wiki 的 URL。 请参阅克隆你的 wiki 并脱机编辑 wiki 页面。
    将此克隆位置命名为 LocationA，以用于此过程。

  5. 使用 IDE 或 git clone 命令克隆 wiki 存储库。

  6. 克隆 wiki 扩展存储库。 该 Wiki 关联到在创建 Wiki 时提供给你的文件夹。 可以通过转到现有 wiki 中的管理 wiki 选项进行确认，如以下示例所示。 现有 Wiki 页面保存在标记为 Root的文件夹下。

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

    将此位置在此过程中命名为 LocationB。

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

    总之，以下位置如下所示：

    • 位置 A = Azure DevOps Wiki 存储库
    • 位置 B = Wiki 扩展存储库
    • 位置 C = 运行迁移工具的空文件夹

  8. 以管理员身份打开命令提示符并运行 MigrateToVSTSWiki.exe。 此工具将文件从现有 Wiki 复制到你提供的目标目录。 在复制期间，该工具会将页面转换为符合 Azure DevOps wiki。

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    例如：

    • E:\wiki\sampleWiki\_extensionWiki 是现有 Wiki 文件所在的文件夹
    • E:\Temp\Wiki\New 是一个空文件夹，用于复制迁移的文件。

  9. 从 LocationA 文件夹中删除所有文件，除了与 Git 相关的文件，比如 .gitignore等。

  10. 复制 LocationC 中的所有文件并将其粘贴到 LocationA中。

  11. 运行 git add . 将所有新添加的文件暂存到 LocationA 中以进行提交。

  12. 运行 git commit -m <commit message> 以提交本地暂存的文件。

  13. 运行 git push origin wikiMain -f，将更改推送到 Azure DevOps wiki 的默认分支。

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

贡献

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