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,因為他們無權在專案的 ReposCode 區段中工作。

Wiki 存放庫的名稱是以您的專案名稱為基礎。 慣例為 <ProjectName>.wiki。 如果您的小組項目名稱是 Contoso ,則您的 Wiki 存放庫名稱為 Contoso.wiki

您可以將 程式代碼發佈為Wiki,為單一專案建立多個Wiki。

存取您的Wiki存放庫

Wiki 的 Git 存放庫 (ProjectName.wiki) 未包含在專案的 ReposCode 區段中的存放庫下拉式清單中。 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)。 預設值為 projectwikiversion 是 (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
    
  •