共用方式為


離線複製和更新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 檔案時的警告。