已布建的Wikis與以Wiki的形式發行的程序代碼

  • 發行項

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

在 Azure DevOps 中，您可以在小組專案 Wiki 或發布為程式代碼 Wiki 中維護 Wiki 內容。 透過已發佈為程式代碼 Wiki，您可以維護數個已建立版本的 Wiki 來支援您的內容需求，不過只有在已啟用 Azure Repos 時才可使用。

即使這兩個選項都會維護 Git 存放庫中的 Wiki 內容，但新增、更新和管理 Wiki 內容的方式仍會有所不同。

注意

Azure DevOps Server 2018 和更新版本目前提供發佈程式代碼作為Wiki功能。 針對舊版，您只能 為您的小組專案布建Wiki。

Wiki 頁面功能表選項

透過布建的Wiki，您可以直接在Wiki中新增和編輯頁面。 布建Wiki的所有內容更新都會發生在Wiki中。

使用發佈程式代碼作為Wiki，您可以從 Repos 或 Code 新增、編輯及更新內容。

下圖顯示已布建Wiki選項。 發佈為程式代碼Wiki頁面不支援其中幾個選項。

[已布建 Wiki] 頁面功能表選項的螢幕快照。

例如，發佈程式代碼的 [ 在 Repos 中編輯] 選項，因為wiki會帶您前往 存放庫 頁面來編輯該特定頁面。 更新 您針對Wiki選取的分支中的頁面，會自動發佈至Wiki。

支援的功能和操作差異

這兩種類型的Wiki都支援下列功能：

下表摘要說明視Wiki類型而定，這些作業或功能可能會有所不同。

作業 已布建的Wiki 將程式代碼發佈為wiki
支援多個Wiki，名稱wiki ✔️
從 Repos> 檔案或程式代碼>檔案新增或編輯頁面 ✔️
從Wiki還原為先前的 修訂 ✔️
從 Repos 或 Code 還原為先前的修訂 ✔️ ✔️
維護版本設定的Wiki ✔️
選取Wiki版本 ✔️
解除發佈程式代碼Wiki ✔️

新增頁面

針對這兩種類型的Wiki，選取 [新增頁面] 或 [新增子頁面]。 如需詳細資訊，請參閱 新增和編輯Wiki頁面。

瀏覽窗格中的頁面順序和頁面清單

布建的 Wiki 會在您在瀏覽窗格中新增或行動頁面時，自動管理頁面順序和頁面清單。

若要將發佈程式代碼的瀏覽窗格中 的頁面清單結構化為wiki，請在根目錄定義 .order 檔案，以及針對包含子頁面的每個子資料夾或父頁面。

這兩種類型的Wiki都遵循相同的檔案結構，只是發佈程式代碼需要您手動維護頁面順序。

如需使用 .order 檔案的詳細資訊，請參閱 Wiki Git存放庫檔案和檔案結構。

頁面修訂並還原為舊版

您可以從Wiki檢視任何Wiki頁面的修訂。 選取 [修訂] 或 [ 檢視修訂] 功能表選項。

但是，還原程式會根據Wiki頁面類型而有所不同。

  • 針對布建的Wiki頁面，選取 [還原]，如將認可還原至已布建的Wiki頁面中所述
  • 針對發佈 即程式代碼Wiki 頁面，請從本機分支工作，並提交提取要求以更新您正在工作的分支。

版本設定和取消發佈Wiki

使用版本設定，您可以根據 Git 存放庫的版本分支，將不同的內容版本發佈至不同的 Wiki。 只有將程式代碼發佈至Wiki所建立的Wiki，才支援版本設定和取消發佈Wiki。 如需詳細資訊，請參閱 發佈程式碼 Wiki/取消發佈程式碼 Wiki。

刪除專案Wiki

注意

Wiki REST API 不支援刪除專案 Wiki。 因此，您必須改為刪除Wiki存放庫。

  1. 複製Wiki存放庫以備份其所有內容。 [ 更多] 選項 具有複製 Wiki URL，可用來複製 Wiki。

  2. 取得可備份Wiki的 Git存放庫標識碼。 您可以使用 REST API 來取得專案中的所有 Wiki。

    例如， GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 傳回專案中的所有Wiki，因此您可以選擇要刪除的Wiki。

  3. 使用 REST API 刪除備份 Git 存放庫。 使用您在上一個步驟中找到之專案 Wiki 的存放庫標識碼，並仔細檢查存放庫標識碼，因此您不會移除錯誤的存放庫標識碼。

    例如，DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

離線更新Wiki

您可以離線工作，或在本機分支中更新已布建Wiki的內容，併發佈為程式代碼Wiki。 如需詳細資訊，請參閱 脫機複製和更新Wiki頁面。