分享方式:


已布建的Wiki與發佈為程式代碼Wiki

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

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

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

注意

已發佈為程式代碼Wiki功能目前可在 Azure DevOps Server 2018 和更新版本上使用。 針對舊版,您只能 為您的小組專案布建Wiki。

Wiki 頁面功能表選項

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

透過發佈為程式代碼 Wiki,您可以從 ReposCode 新增、編輯和更新內容

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

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

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

支援的功能和操作差異

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

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

新增頁面

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

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

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

若要建構發佈為程式碼 Wiki 之瀏覽窗格中的頁面清單,請在根目錄定義*.order*檔案,以及包含子頁面的每個子資料夾或父頁面。

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

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

頁面修訂並還原為舊版

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

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

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

版本設定和取消發佈Wiki

使用版本設定,您可以根據 Git 存放庫的版本分支,將不同的內容版本發佈至不同的 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頁面。