離線複製和更新Wiki內容

  • 發行項

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

離線更新 Wiki 頁面的方式與您在 Git 存放庫開發程式碼的方式相同。

您可以使用您想要的任何用戶端或 git 命令列工具來離線更新您的 Wiki。 如需使用 Git 存放庫和支援工具的詳細資訊，請參閱 Git 存放庫。

離線更新 Wiki 內容的基本步驟如下：

  1. 將Wiki Git存放庫複製到本機 IDE 或工作區。
  2. 將檔案或資料夾新增至本機 Git 分支。
  3. 更新 .order 檔案以反映您的頁面和子頁面。
  4. 認可並推送您對本機 Git 分支所做的更新。

必要條件

執行下列步驟，將 Markdown 頁面從另一個 Wiki 移轉至您的小組專案 Wiki，或將您發佈為程式代碼的內容移轉至 Wiki。

複製Wiki

您的Wiki存放庫會儲存頁面、影像、附件，以及頁面和子頁面的順序。 複製您的Wiki以開始。

  1. 登入您的專案 （https://dev.azure.com/{Your_Organization/Your_Project}），然後選取您的Wiki。

  2. 開啟 [ 更多動作] 操作功能表，然後選取 [ 複製Wiki]。

    複製Wiki Git存放庫

  3. 從 [複製存放庫] 對話框中，選取 [將複製 URL 複製到剪貼簿]。

    複製Wiki URL

    在您的瀏覽器中輸入它，以檢視wikiMaster分支下定義的檔案。

    Wiki 主要檔案

  4. 使用您複製的 URL，在您使用的 IDE 中複製存放庫。 若要深入了解，請參閱以下其中一篇文章：

將頁面新增至本機 Git 存放庫

我們會使用 Markdown 格式撰寫頁面。 針對您要新增至Wiki的每個頁面和子頁面，將Markdown 檔案新增至您的本機分支。

新增頁面

若要在Wiki樹狀目錄的根目錄新增頁面，請在 Git 存放庫的根目錄新增 Markdown 檔案。

  1. 針對您要新增的每個頁面，使用頁面內容建立 Markdown 檔案，然後在存放庫的根資料夾下新增它。

    針對 CanaryBuilds 小組專案，其位於下列資料夾中：

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. 若要在Wiki樹狀目錄的根目錄新增頁面，請在 Git 存放庫根目錄為每個頁面新增 Markdown 檔案。

    本機分支Wiki Git存放庫

  3. 在您新增要在根目錄新增的所有頁面之後，請更新 根目錄的 .order 檔案。 每個在根目錄定義的 Markdown 檔案都應該有一個專案。 每個項目都應該比對檔案標題，並將空格取代為虛線。

    例如：

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

新增子頁面

  1. 建立父頁面的資料夾，然後為資料夾中的每個子頁面新增 Markdown 檔案。

    例如，我們已將下列檔案新增至 How-to-contribute 資料夾。 這些子頁面會出現在Wiki中的 [如何參與] 頁面底下。

    子頁面的螢幕快照。

  2. 使用子頁面的順序，在資料夾中新增 .order 檔案，因為它們應該出現在wiki中。 若要瞭解 使用 .order 檔案來排序頁面，請參閱 Wiki Git存放庫檔案和檔案結構。

    例如，檔案具有下列子頁面：

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

推送變更

當您完成所有更新時， 請將檔案推送至 Git 存放庫。

新增的頁面和子頁面會立即出現在您的Wiki中。

Wiki 樹狀結構已更新

如果程式中有任何錯誤，頁面就會以警告符號出現在Wiki中。

未正確更新 .order 檔案時的警告。