共用方式為

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

  • 發行項

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

瞭解如何將使用 Wiki Marketplace 擴充功能所建立的頁面 移轉至您的小組專案 Wiki。 使用內建Wiki版本，使用Wiki Marketplace擴充功能建立的任何Wiki頁面都可以儲存至小組專案中的 Git 存放庫。

先決條件

類別 要求
專案存取 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 頁面會儲存在標示為 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. 從 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，並詢問任何問題或意見。