プロビジョニングされた Wiki とコード Wiki として発行された Wiki

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

wiki コンテンツは、team プロジェクト wikiまたはコード wiki として公開に保持できます。 コード Wiki として発行された場合、コンテンツのニーズをサポートするためにバージョン管理された Wiki をいくつか維持できますが、Azure Repos が有効になっている場合にのみ使用できます。

どちらのオプションでも Git リポジトリで Wiki コンテンツを維持しますが、Wiki コンテンツを追加、更新、管理する方法が異なります。

Wiki ページのメニュー オプション

プロビジョニングされた wiki を使用すると、wiki 内でページを直接追加および編集。 プロビジョニングされた wiki に対するすべてのコンテンツの更新はwiki内で行われます。

コード wiki として発行を使用すると、Repos または Code からコンテンツを追加、編集、更新できます。

次の図は、プロビジョニングされた Wiki のオプションを示しています。 これらのオプションの一部は、コード Wiki ページとして公開ではサポートされていません。

たとえば、コード Wiki として発行された Edit in Repos オプションを使用すると、 Repo ページに移動してその特定のページを編集できます。 Wiki 用に選択したブランチのページに対して行った更新は、自動的に Wiki に発行されます。

サポートされている機能と運用上の違い

どちらの種類の Wiki でも、次の機能がサポートされています。

• Markdown 形式
• HTML タグ
• 画像の挿入とサイズ変更
• 数学表記と文字
• を使用して作業項目にリンクする#
• ファイルの添付
• Wiki コンテンツをフィルター処理する
• Wiki ページを印刷する
• コンテンツをオフラインで更新する
• Wiki からページを追加または編集する

次の表は、Wiki の種類によって異なる可能性のある操作または機能をまとめたものです。

ページを追加する

どちらの種類の Wiki でも、[新しいページまたは サブページの追加を選択します。 詳細については、「 Wiki ページの追加と編集を参照してください。

ナビゲーション ウィンドウのページ シーケンスとページ リスト

プロビジョニングされた wikiは、ナビゲーション ウィンドウ内でページを追加または移動するときに、ページ シーケンスとページ リストを自動的に管理します。

コード Wiki として公開 のナビゲーション ウィンドウ内のページの一覧を構成するにはルートの *.order* ファイルを定義し、サブページを含むサブフォルダーまたは親ページごとに定義します。

どちらの種類の Wiki も同じファイル構造に従います。コード Wiki として公開されている場合は、ページ シーケンスを手動で管理する必要があります。

.order ファイルの操作の詳細については、「Wiki Git リポジトリ ファイルとファイル構造を参照してください。

ページのリビジョンと以前のバージョンに戻す

wikiから、任意の Wiki ページの変更履歴を表示できます。 Revisions または View リビジョン メニュー オプションを選択します。

ただし、元に戻すプロセスは Wiki ページの種類によって異なります。

• プロビジョニングされた wiki ページの場合は、「プロビジョニングされた Wiki ページへのコミットを再変換する」の説明に従って、Revert を選択します
• コード wiki として公開ページの場合は、ローカル ブランチから作業し、作業しているブランチを更新するための pull request を送信します。

Wiki のバージョン管理と発行解除

バージョン管理を使用すると、Git リポジトリのバージョン管理されたブランチに基づいて、異なる Wiki に異なるコンテンツ バージョンを発行できます。 Wiki にコードを発行して作成した Wiki の場合にのみ、Wiki のバージョン管理と発行解除を行うことができます。 詳細については、「 コード Wiki を発行するを参照してください。

プロジェクト Wiki を削除する

1. Wiki リポジトリを複製して、すべてのコンテンツのバックアップを作成します。 その他のオプションには、Wiki の複製に使用できるクローン Wiki URL があります。

2. Wiki をバックアップする Git リポジトリ ID を取得します。 REST API を使用して、プロジェクト内のすべての Wiki を取得できます。

   たとえば、 GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 はプロジェクト内のすべての Wiki を返すので、削除する Wiki を選択できます。

3. REST API を使用して、バッキング Git リポジトリを削除します。 前の手順で見つけたプロジェクト Wiki のリポジトリ ID を使用し、リポジトリ ID を再確認して、間違ったリポジトリを削除しないようにします。

   たとえば、DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1 のように指定します。

Wiki をオフラインで更新する

オフラインまたはローカル ブランチで作業して、プロビジョニングされた wiki のコンテンツを更新しコード wiki として公開。 詳細については、「 Clone およびオフラインで Wiki ページを更新するを参照してください。

関連記事

• チーム プロジェクトの Wiki を作成する
• Wiki Git リポジトリのファイルとファイル構造
• Git リポジトリを Wiki に公開する
• Git の概要