新增和編輯 Wiki 頁面

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

您可以在為小組專案布建 Wiki Git 存放庫 之後,將標題和內容新增至頁面。 有並存編輯和預覽體驗,您可以在其中編輯頁面並預覽內容。

瞭解如何執行下列工作:

  • 開啟 Wiki
  • 新增 Wiki 頁面
  • 檢視頁面的修訂
  • 編輯和刪除 Wiki 頁面
  • 重新排序 Wiki 頁面
  • 將頁面設為 Wiki 首頁

使用 Markdown 格式撰寫頁面時,您也可以使用格式窗格進行 RTF 格式設定,以及插入影像、附件和連結。

Wiki 首頁

當您編輯頁面時,請輸入 Ctrl+S加以儲存。 若要使用自訂修訂訊息儲存,請選取 [ 儲存] 旁的 。 如需更多快捷方式,請參閱 管理 Wiki 頁面的鍵盤快速鍵

使用自訂訊息儲存頁面

Wiki 命令列工具

命令 描述
az devops wiki show 開啟 Wiki
az devops wiki page show 取得頁面的內容或開啟頁面
az devops wiki page create 新增頁面
az devops wiki page update 編輯頁面
az devops wiki page delete 刪除頁面

注意

若要將頁面新增或編輯至您從 Git 存放庫發佈的 Wiki,請參閱 將 Git 存放庫發佈至 Wiki。 本文說明如何新增和編輯您為小組專案布建的 Wiki 頁面。

必要條件

  • 您必須擁有布建的 Wiki。 如果您的 Wiki 尚未建立,請 立即建立它
  • 您必須是小組專案的成員,才能新增或更新 Wiki 頁面。
  • 您必須具備基本存取層級,才能編輯專案 Wiki。

開啟 Wiki

使用 支援的網頁瀏覽器 連線到您的專案,然後選擇 [Wiki]。

顯示醒目提示 [Wiki] 功能表選取專案的螢幕擷取畫面。

如果您需要切換小組專案,請選擇 [Azure DevOps] 來流覽所有小組專案和小組

新增 Wiki 頁面

若要新增另一個頁面,請選擇 [ 新增頁面]。 或者,若要新增子頁面,請開啟現有頁面的操作功能表,然後選取 [ 新增子頁面]。

指定 235 個字元或更少的唯一標題。 頁面標題會區分大小寫。 如需其他標題限制,請參閱 Wiki Git 存放庫檔案和檔案結構、檔案命名慣例

建立 Wiki 和第一頁

您也可以使用鍵盤快速鍵,按 n 或按 c來新增子頁面。 如需鍵盤快速鍵的完整清單,請參閱 管理 Wiki 頁面的鍵盤快速鍵

Wiki 頁面標題命名限制

每個 Wiki 頁面都會對應至 Wiki Git 存放庫中的檔案。 您指派給 Wiki 頁面標題的名稱必須符合下列限制。

限制類型 限制
檔案名稱 完整頁面路徑不應超過 235 個字元。
唯一性 頁面標題區分大小寫,而且在 Wiki 階層中必須是唯一的。
特殊字元
  1. 不得包含任何 Unicode 控制字元或 Surrogate 字元
  2. 不得包含下列可列印字元: / \#
  3. 不得以句點 (.) 當做開頭或結尾
檔案大小 不可超過上限 18 MB
附件檔案大小 不可超過上限 19 MB

Wiki 頁面標題中的特殊字元

您可以指定包含一或多個這些特殊字元 : < > * ? | - 的頁面標題。 例如,您可以將 Markdown 檔案命名為 「FAQ?」 或 「Set-up guide」。 字元具有下列 URI 編碼字串:

字元 編碼字串
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22
限制類型 限制
檔案名稱 完整頁面路徑不應超過 235 個字元。
唯一性 頁面標題區分大小寫,而且在 Wiki 階層中必須是唯一的。
特殊字元
  1. 不得包含任何 Unicode 控制字元或 Surrogate 字元
  2. 不得包含下列可列印字元: / : < \ * ? \ | - #
  3. 不得以句點 (.) 當做開頭或結尾
  4. 離線新增的頁面標題不得包含空格。
檔案大小 不可超過上限 18 MB
附件檔案大小 不可超過上限 19 MB

編輯和刪除 Wiki 頁面

若要編輯現有的 Wiki 頁面,請開啟頁面並選取 [ 編輯],或開啟操作功能表,然後選取 [ 編輯]。 您也可以使用鍵盤快速鍵 e 快速移至目前頁面的編輯。

針對程式碼 Wiki,您可以使用 Markdown 工具列來建立內容,在並存編輯器中編輯頁面。 此體驗與專案 Wiki 中的程式相同。 您也可以使用 Repos 中樞的 [編輯] 選項,編輯 Repos 中的Wiki 頁面。

編輯 Wiki 頁面。

注意

如果您的程式碼 Wiki 中有分支原則,請使用 Repos 中的編輯 來建立分支並繼續編輯。

若要刪除頁面,請從樹狀結構或頁面內的功能表開啟操作功能表,然後選取 [ 刪除]。 確認對話方塊中開啟的刪除。

注意

刪除頁面會刪除頁面以及所有中繼資料及其所有子頁面,如果階層中有任何) ,則 (。

重新排序 Wiki 頁面

您可以在 Wiki 樹狀檢視內重新排序頁面,讓頁面以您想要的順序和階層顯示。 您可以在樹狀檢視中拖放頁面標題,以執行下列作業:

  • 變更頁面的父子關聯性。
  • 變更階層內頁面的順序。

注意

在階層中移動頁面可能會中斷從其他頁面連結。 移動之後,您一律可以手動修正連結。 重新排序階層中的頁面不會影響頁面連結。

您也可以使用鍵盤快速鍵來重新排序頁面。 選取頁面,然後按 CTRL + 向上鍵CTRL + 向下鍵 來變更頁面順序。 若要變更頁面的父子關聯性,請開啟其操作功能表,然後選取 [ 移動]。 [ 移動頁面] 對話方塊隨即開啟。 選取您可以移動目前頁面的父頁面。

在階層中移動 Wiki 頁面

如需鍵盤快速鍵的完整清單,請參閱 管理 Wiki 頁面的鍵盤快速鍵

將頁面設為 Wiki 首頁

根據預設,當您建立 Wiki 時新增的第一頁會設定為 Wiki 首頁。 如果另一個頁面在樹狀結構頂端拖放頁面而變得更相關,您可以變更 Wiki 首頁。

下一步