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

  • [アーティクル]

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

Azure DevOps では、チーム プロジェクト Wiki またはコード 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 として発行コードの [リポジトリで編集] オプションを選択すると、[リポジトリ] ページに移動してその特定のページを編集できます。 wiki 用に選択したブランチ内のページに作成した更新は、自動的に Wiki に発行されます。

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

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

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

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

ページを追加する

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

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

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

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

どちらの種類の Wiki も同じファイル構造に従います。wiki としてコードを発行するには、ページ シーケンスを手動でメインする必要があります。

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

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

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

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

  • プロビジョニングされた Wiki ページの場合は、「プロビジョニングされた Wiki ページへのコミットを元に戻す」の説明に従って、[元に戻す] を選択します
  • コード Wiki ページとして発行する場合は、ローカル ブランチから作業し、作業中のブランチを更新するための pull request を送信します。

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

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

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

Note

Wiki REST API では、プロジェクト Wiki の削除はサポートされていません。 したがって、代わりに Wiki リポジトリを削除する必要があります。

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

  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 として発行できます。 詳細については、「オフラインで Wiki ページを複製および更新する」を参照してください。