將頁面從Wiki延伸模組遷移至小組專案Wiki

  • 發行項

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

瞭解如何將使用 Wiki Marketplace延伸模組 建立的頁面移轉至您的小組專案Wiki。 使用內建Wiki版本，使用Wiki Marketplace擴充功能建立的任何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. 從網頁瀏覽器開啟您的 Azure DevOps 小組專案，並 建立您的第一個 Wiki 頁面。

  4. 取得 URL 以複製您的 Wiki。 請參閱 複製您的Wiki並離線編輯Wiki頁面。
    將此複製位置命名為此 LocationA 程式。

  5. 使用 IDE 或 git clone 命令複製 Wiki 存放庫。

  6. 複製Wiki擴充功能存放庫。 Wiki 會對應至Wiki建立期間提供給您的資料夾。 您可以移至 現有Wiki中的 [管理Wiki ] 選項來確認，如下列範例所示。 您現有的 Wiki 頁面會儲存在標示 Root為 的資料夾底下。

    例如，您複製了先前在位置中提及 sampleWiki 的 C:\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 相關檔案以外的所有檔案 LocationA ，例如 .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 任何問題或意見。