Azure DevOps Services |Azure DevOps Server 2022 および Azure DevOps Server 2019
wiki コンテンツは、team プロジェクト wikiまたはコード wiki として公開に保持できます。 コード Wiki として発行すると、コンテンツのニーズをサポートするために、バージョン管理された Wiki を複数維持できます。 このオプションは、Azure Repos を有効にするときに使用できます。
どちらのオプションでも Git リポジトリで Wiki コンテンツを維持しますが、Wiki コンテンツを追加、更新、管理する方法が異なります。
Wiki コンテンツを維持する
どちらの種類の Wiki でも、GitHub で直接作業することも、オフラインで作業して、変更をリポジトリにプッシュすることもできます。
プロビジョニングされた Wiki の場合は、リポジトリの Wiki> セクション内で Wiki ページを直接追加および管理します。 プロビジョニングされた Wiki に対するすべてのコンテンツの更新 は、Wiki 自体内で行われます。
コード Wiki として発行された場合は、リポジトリに Wiki コンテンツをコード ファイルとして追加および管理します。 GitHub の リポジトリの Repos または Code セクション内のファイルにアクセスします。
次の図は、 プロビジョニングされた Wiki のメニュー オプションを示しています。
一部のメニュー オプションは、 コード Wiki ページとして発行 された場合はサポートされていません。 コード Wiki として発行された場合、[リポジトリで編集] オプションを選択すると、現在のページが開き、コンテンツをインプレースで編集できます。 Wiki の選択したブランチのページに対して行った更新は、自動的に Wiki に発行されます。
Wiki ページを追加する
GitHub の Wiki の両方の種類で、[ 新しいページ ] メニューと [サブページの追加] メニュー オプションを使用できます。 詳細については、「 Wiki ページの追加と編集を参照してください。
ページ シーケンスとページ リストを調整する
どちらの種類の Wiki でも、Git リポジトリ内で同じフォルダーとファイル構造が適用されます。 違いは、ページ シーケンスを維持する方法です。
プロビジョニングされた Wiki の場合、ナビゲーション ウィンドウ内でページを追加または移動すると、GitHub によってページ シーケンスとページ リストが自動的に管理されます。
コード Wiki として発行する場合は、ページ シーケンスを手動で管理する必要があります。 ナビゲーション ウィンドウでページの一覧を構成するには、サブページを含むサブフォルダーまたは親ページごとに、ルートに .order ファイルを定義します。 詳細については、 Wiki Git リポジトリのファイルとファイル構造を参照してください。
ページのリビジョンを表示し、以前のバージョンに戻す
Git リポジトリの Wiki ページから、Wiki 内の任意のページの変更履歴を表示できます。 [変更履歴] または [変更履歴の表示] メニュー オプションを使用します。 現在のページ コンテンツを以前のバージョンに戻すには、Wiki ページの種類によってプロセスが異なります。
プロビジョニングされた Wiki ページの場合は、[元に戻す] メニュー オプションを選択します。 詳細については、「 プロビジョニングされた Wiki ページにコミットを戻す」を参照してください。
コード Wiki ページとして公開されている場合は、ローカル ブランチから作業し、作業中のブランチを更新するための pull request を送信します。
バージョン管理を使用して Wiki の公開を解除する
バージョン管理のサポートにより、Git リポジトリのバージョン管理されたブランチに基づいて、異なる Wiki に異なるコンテンツ バージョンを発行できます。
Wiki を作成するコードを発行したユーザーの場合にのみ、Wiki のバージョン管理と発行解除を行うことができます。 詳細については、「 コード Wiki を発行するを参照してください。
プロジェクト Wiki を削除する
次の手順では、プロジェクト Wiki を削除する方法について説明します。
注
REST API を使用してプロジェクト Wiki を削除することはできません。 代わりに、Wiki リポジトリを直接削除してください。
Wiki リポジトリを複製して、すべてのコンテンツをバックアップします。 Wiki URL は、[ その他のオプション ] メニュー (...) にあります。
Wiki に関連付けられている Git リポジトリ ID を取得します。 REST API を使用して、プロジェクト内のすべての Wiki を取得できます。
たとえば、
GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1
コマンドは、プロジェクト内のすべての Wiki を返します。 コマンドを実行し、削除する Wiki を選択します。REST API を使用して、Wiki に関連付けられている Git リポジトリを削除します。 先ほど見つけたプロジェクト Wiki のリポジトリ ID を使用します。 リポジトリ ID を再確認して、間違った Wiki を削除しないようにします。
たとえば、
DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1
コマンドは wiki を削除します。<repositoryId>
を削除する Wiki のリポジトリ ID に置き換えます。
オフライン時に Wiki を更新する
オフラインまたはローカル ブランチで作業して、両方の種類の Wiki のコンテンツを更新できます。 詳細については、「 Clone およびオフラインで Wiki ページを更新するを参照してください。
その他の機能と操作を調べる
どちらの種類の Wiki でも、他のいくつかの機能と操作がサポートされています。
- Markdown 形式
- HTML タグ
- 画像の挿入とサイズ変更
- 数学表記と文字
- ハッシュ タグ (#) を持つ項目へのリンク
- ファイルの添付
- Wiki コンテンツをフィルター処理する
- Wiki ページを印刷する
- コンテンツをオフラインで更新する
- Wiki からページを追加または編集する
いくつかの操作と機能は、1 種類の Wiki でのみ使用できます。また、使用方法が異なります。
操作 | プロビジョニング済み | コードとして発行 |
---|---|---|
複数の Wiki をサポートし、wiki という名前を付ける | ✔️ | |
Repos>Files からページを追加または編集する または Code>Files から |
✔️ | |
Wiki ページから以前のリビジョンに戻す | ✔️ | |
[リポジトリ] オプションから以前のリビジョンに戻す または コード オプションから |
✔️ | ✔️ |
バージョン管理された Wiki を維持する | ✔️ | |
Wiki のバージョンを選択する | ✔️ | |
コード Wiki を公開中止する | ✔️ |