Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
在 Azure DevOps 中,每個小組專案都有 Wiki。 您可以使用Wiki與小組分享資訊,並支援項目貢獻。 Wiki 是由後端中的 Git 存放庫所提供。 本文說明如何開啟專案 Wiki 並建立 Git 存放庫。
當您建立小組專案時,預設不會建立Wiki Git存放庫。 您可以建立存放庫來儲存Wiki Markdown 檔案,或
將現有的 Markdown 檔案從 Git 存放庫發佈
至 Wiki。
如需詳細資訊,請參閱 Azure DevOps CLI
命令參考
。
範例:檢視特定頁面
下列範例示範如何取得 「MyProjectwiki」 Wiki 中 “Get Started” 頁面的內容:
az devops wiki page show --path 'Get Started' --wiki 'MyProjectwiki' --content "Hello World"
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
建立Wiki Git存放庫
本節說明如何為您的Wiki建立 Git 存放庫。 您可以在瀏覽器中直接使用 Azure DevOps UI,或使用 Azure DevOps CLI。
具有專案管理員層級存取權的使用者可以建立Wiki Git存放庫。 具有項目關係人存取權的用戶無法建立Wiki,因為他們無權在專案的 Repos 或 Code 區段中工作。
Wiki 存放庫的名稱是以您的專案名稱為基礎。 慣例為 <ProjectName>.wiki。 如果您的小組項目名稱是 Contoso ,則您的 Wiki 存放庫名稱為 Contoso.wiki。
您可以將 程式代碼發佈為Wiki,為單一專案建立多個Wiki。
存取您的Wiki存放庫
Wiki 的 Git 存放庫 (ProjectName.wiki) 未包含在專案的 Repos 或 Code 區段中的存放庫下拉式清單中。 Wiki 存放庫也不會列在 [項目設定 > 存放庫 ] 或 [ 版本控制 ] 頁面中。 相反地,您可以從Wiki的 [存放庫>檔案 ] 頁面存取您的Wiki存放庫。
建立 Repos>檔案頁面的 URL。 在以下 URL 中,將您的伺服器、組織、專案和 Wiki 名稱替換至任何 <Placeholder> 部分:
https://dev.azure.com/<Organization>/<ProjectName>/_git/<WikiName>
https://<ServerName>/Default_Collection/<ProjectName>/_git/<WikiName>
將 URL 貼到瀏覽器中,然後開啟 Wiki 的 [ 檔案 ] 頁面。
在 [ 存放庫>檔案 ] 頁面上,找出您的Wiki存放庫名稱,然後選取 [更多選項 ](...) >複製。
Azure DevOps 組織 URL。 您可以使用 命令來設定預設組織 az devops configure -d organization=ORG_URL 。
注意:當未預設設定組織或透過使用git config指令來選擇時,該參數為必要。 範例:--org https://dev.azure.com/<OrganizationName>/。
project
項目的名稱或識別碼。 您可以使用 命令來設定預設專案 az devops configure -d project=NAME_OR_ID 。
注意:當專案未預設配置或使用 git config 命令選取時,此參數為必要。
repository
是 (codewiki)
用來發佈Wiki的 Git 存放庫名稱或識別碼。
要建立的Wiki類型:Project wiki (projectwiki) 或將程式代碼發佈為wiki (codewiki)。 預設值為 projectwiki。
version
是 (codewiki)
用來發佈程式代碼Wiki的 Git 存放庫分支名稱。
範例:建立專案Wiki
下列命令會建立名為 「Fabrikam Fiber」 的專案 Wiki,並以數據表格式顯示輸出:
az devops wiki create --name "Fabrikam Fiber" --output table
ID Name Type
------------------------------------ ------------------- -----------
7edcc35b-89be-465e-855e-377ba8660af7 Fabrikam Fiber.wiki projectWiki