次の方法で共有

プロビジョニングされた 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 コンテンツを追加、更新、管理する方法が異なります。

Note

コード Wiki として公開されている機能は、現在、Azure DevOps Server 2018 以降のバージョンで利用できます。 以前のバージョンの場合は、チーム プロジェクトの wiki を プロビジョニングすることしかできません。

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

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

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

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

[Provisioned Wiki]\(プロビジョニングされた Wiki ページ\) メニュー オプションのスクリーンショット。

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

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

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

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

操作 プロビジョニングされた Wiki コード Wiki として公開
複数の Wiki をサポートし、wiki という名前を付ける ✔️
Repos>Files または Code>Files からページを追加または編集する ✔️
Wiki から以前のリビジョンに戻す ✔️
Repos または Code から以前のリビジョンに戻す ✔️ ✔️
バージョン管理された Wiki を維持する ✔️
Wiki バージョンを選択する ✔️
コード Wiki の発行を取り消す ✔️

ページを追加する

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

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

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

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

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

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

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

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

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

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

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

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

Note

Wiki REST API では、プロジェクト 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 ページを更新するを参照してください。