共用方式為

已配置的Wiki與發佈為程式碼的Wiki

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

您可以在小組專案 Wiki 或發布為程式代碼 Wiki 中維護 Wiki 內容。 透過 程式碼製作的 Wiki，您可以維護多個版本的 Wiki，以滿足您的內容需求。 當您啟用 Azure Repos 時，可以使用此選項。

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

維護Wiki內容

針對這兩種類型的Wiki，您可以直接在 GitHub 中工作或離線工作，然後將變更推送至存放庫。

針對 布建的Wiki，您可以直接在儲存庫的 Wiki>頁面 中新增和維護頁面。 已配置的Wiki內的所有內容更新都會在Wiki本身發生。

針對 已發佈為程式代碼 Wiki 的 ，您會在存放庫中新增及維護 Wiki 內容作為程式碼檔案。 您可以在 GitHub 上存取存放庫的 Repos 或 Code 區段內的檔案。

下圖顯示 已佈建Wiki的功能表選項：

[Wiki 頁面] 區段中已布建 Wiki 可用的功能表選項螢幕快照。

某些功能表選項不支援 以程式碼形式發佈的 Wiki 頁面。 針對 發佈為程式碼 Wiki，在 Repos 中編輯 選項會開啟目前的頁面，讓您可以就地編輯內容。 您針對Wiki所選分支中的頁面進行更新，會自動發佈至Wiki。

新增Wiki頁面

[新增頁面] 和 [新增子頁面] 功能表選項適用於 GitHub 中這兩種類型的 Wiki。 如需詳細資訊，請參閱 新增和編輯Wiki頁面。

調整頁面順序和頁面清單

這兩種類型的Wiki都會在 Git 存放庫中套用相同的資料夾和檔案結構。 差異在於您維護頁面順序的方式。

針對 建立的 wiki，GitHub 會在您於導航窗格中新增或移動頁面時，自動管理頁面順序和頁面清單。

針對 已發佈為程式代碼 Wiki 的 ，您必須 手動維護頁面順序。 若要建構瀏覽窗格中的頁面清單，您可以在根目錄定義 .order 檔案，並針對包含子頁面的每個子資料夾或父頁面定義 。 如需詳細資訊，請參閱 Wiki Git存放庫檔案和檔案結構。

檢視頁面修訂並還原為舊版

從 Git 存放庫的 Wiki 頁面中，您可以檢視 Wiki 內任何頁面的修訂。 使用 [修訂 ] 或 [ 檢視修訂] 功能表選項。 若要將目前的頁面內容還原為舊版，程式會根據Wiki頁面類型而有所不同。

針對 布建的Wiki 頁面，選取 還原 選單選項。 如需詳細資訊，請參閱 還原提交至已配置的Wiki頁面。

針對 已發佈為程式碼 Wiki 頁面，您可以從本機分支進行工作，並提交拉取請求來更新您正在工作的分支。

使用版本設定並停止發佈維基

版本控制支援可讓您根據 Git 存放庫的版本化分支，將不同的內容版本發佈至不同的Wiki。

只有當您是發佈程式代碼以建立Wiki的使用者時，才可以發行和取消發佈Wiki。 如需詳細資訊，請參閱 取消發佈程式碼Wiki。

刪除專案Wiki

下列步驟說明如何刪除專案Wiki。

注意

您無法使用 REST API 來移除專案 Wiki。 相反地，請直接刪除Wiki存放庫。

  1. 複製Wiki存放庫以備份所有內容。 您可以在 [其他選項 ] 功能表上找到 Wiki URL（...）。

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

    例如， GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 命令會傳回專案中的所有Wiki。 執行 命令，然後選擇要刪除的Wiki。

  3. 使用 REST API 刪除與您的 Wiki 相關聯的 Git 存放庫。 使用你稍早找到的專案 wiki 存放庫 ID。 請仔細檢查存放庫標識碼，以確保您不會移除錯誤的Wiki。

    例如， DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 命令會刪除wiki。 將 <repositoryId> 換成要刪除的 Wiki 存放庫標識碼。

離線時更新Wiki

您可以離線工作，或在本機分支中更新這兩種Wiki類型的內容。 如需詳細資訊，請參閱如何離線克隆和更新Wiki頁面。

探索其他功能和作業

這兩種類型的Wiki都支援數個其他功能和作業：

只有在某一種特定類型的 Wiki 上，或是在使用方式不同時，才有某些作業和功能可供使用：

作業 已佈建 發佈為程式碼
支援多個維基，名稱wiki ✔️
在Repos>檔案中新增或編輯頁面
或來自 程式代碼>檔案		 ✔️
將 Wiki 頁面還原到先前版本 ✔️
從 Repos 選項還原為較早的修訂版本
或從 程式代碼 選項		 ✔️ ✔️
維護版本設定的Wiki ✔️
選取Wiki版本 ✔️
取消發佈程式碼Wiki ✔️

相關內容