将页面从 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. 获取 URL 以克隆 Wiki。 请参阅 克隆 Wiki 并脱机编辑 Wiki 页面。
    将此克隆位置命名为 LocationA 此过程。

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

  6. 克隆 Wiki 扩展存储库。 Wiki 将映射到 Wiki 创建期间提供给你的文件夹。 可以通过转到 现有 Wiki 中的“管理 Wiki ”选项进行确认，如以下示例所示。 现有 Wiki 页面保存在标记 Root的文件夹下。

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

    将此位置命名为 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. 从 Git 相关文件（如.gitignore等）中删除所有文件LocationA（如果有）。

  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 。