Wiki ページの追加と編集
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Wiki Git リポジトリがチーム プロジェクト用にプロビジョニングされた後、ページにタイトルとコンテンツを追加できます。 ページを編集してコンテンツをプレビューできるサイド バイ サイドの編集とプレビューエクスペリエンスがあります。
Markdown 形式を使用してページを作成するときに、書式設定ウィンドウを使用してリッチ テキストの書式設定を行い、画像、添付ファイル、リンクを挿入することもできます。
ページを編集するときに、 Ctrl + S キーを押して保存します。 カスタム リビジョン メッセージで保存するには、[保存] の横にある を選択
します。 その他のショートカットについては、「 Wiki ページを管理するためのキーボード ショートカット」を参照してください。
Wiki コマンド ライン ツール
| コマンド | 説明 |
|---|---|
| az devops wiki show | Wiki を開く |
| az devops wiki page show | ページのコンテンツを取得するか、ページを開く |
| az devops wiki page create | 新しいページを追加する |
| az devops wiki page update | ページを編集する |
| az devops wiki page delete | ページの削除 |
Note
Git リポジトリから発行した Wiki にページを追加または編集するには、「Git リポジトリを Wiki に発行する」を参照してください。 この記事では、チーム プロジェクト用にプロビジョニングした Wiki のページを追加および編集する方法について説明します。
前提条件
- Wiki を プロビジョニングします。
- Wiki ページを追加または更新するための共同作成者として、チーム プロジェクトのメンバーになる。
- プロジェクト Wiki を編集するための基本アクセス レベルを持つ。
Wiki を開く
プロジェクトの Wiki ページを開いて表示できます。
サポートされている Web ブラウザーを使用してプロジェクトに接続し、[Wiki] を選択します。
チーム プロジェクトを切り替える必要がある場合は、[Azure DevOps] を選択
して、すべてのチーム プロジェクトとチームを参照します。
Wiki ページを追加する
別のページを追加するには、[ 新しいページ] を選択します。 または、サブページを追加するには、既存のページのコンテキスト メニューを開き、[ サブページの追加] を選択します。
235 文字以下の一意のタイトルを指定します。 ページ タイトルでは大文字と小文字が区別されます。 その他のタイトル制限については、「 Wiki Git リポジトリ ファイルとファイル構造」の「ファイルの名前付け規則」を参照してください。
キーボード ショートカットを使用して 、n キーを押して新しいページを追加したり、 c キーを押してサブページを追加したりすることもできます。 キーボード ショートカットの完全な一覧については、「 Wiki ページを管理するためのキーボード ショートカット」を参照してください。
Wiki ページのタイトルの名前付けの制限
各 Wiki ページは、Wiki Git リポジトリ内のファイルに対応しています。 Wiki ページのタイトルに割り当てる名前は、次の制限に従う必要があります。
| 制限の種類 | Restriction |
|---|---|
| ファイル名 | 完全修飾ページ パスは、235 文字を超えてはなりません。 |
| 一意性 | ページ タイトルは大文字と小文字が区別され、Wiki 階層内で一意である必要があります。 |
| 特殊文字 | - Unicode 制御文字またはサロゲート文字を含めてはなりません。 - 次の印刷可能な文字を含めてはいけません: / \ #。- ピリオド .で開始または終了することはできません。 |
| ファイル サイズ | 最大 18 MB を超えてはなりません。 |
| 添付ファイルのサイズ | 最大 19 MB を超えてはなりません。 |
Wiki ページ タイトルの特殊文字
これらの特殊文字の 1 つ以上を含むページ タイトルを : < > * ? | -指定できます。 たとえば、Markdown ファイルに "FAQ" または "セットアップ ガイド" という名前を付けることができます。 文字には、次の URI でエンコードされた文字列があります。
| 文字 | エンコードされた文字列 |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
%22 |
Wiki ページを編集および削除する
既存の Wiki ページを編集するには、ページを開いて [編集] を選択するか、コンテキスト メニューを開いて [編集] を選択します。 キーボード ショートカット e を使用して、現在のページの編集にすばやく移動することもできます。 特定の編集機能の詳細については、「Markdown ガイダンスを使用する」を参照してください。
コード Wiki の場合は、マークダウン ツール バーを使用してコンテンツを作成し、サイド バイ サイド エディターでページを編集できます。 このエクスペリエンスは、プロジェクト Wiki のプロセスと同じです。 Repos ハブの Wiki ページも、[リポジトリ で編集] オプションを使用して編集できます。
[リポジトリで編集] を選択してブランチを作成し、編集を続けます。 [ リポジトリ 内の編集] ボタンは、ブランチ ポリシーが有効になっているコード Wiki でのみ使用できます。 ボタンが表示されない場合は、Wiki がコード Wiki ではないか、ブランチ ポリシーが有効になっていない可能性があります。 ブランチ ポリシーの詳細については、「ブランチ ポリシーと設定」を参照してください。
ページを削除するには、ツリーまたはページ内のコンテキスト メニューを開き、[削除] を選択 します。 開いたダイアログで削除を確認します。
Note
Wiki ページを削除すると、そのメタデータとその階層内のすべてのサブページも削除されます。
Wiki ページを並べ替える
Wiki ツリー ビュー内のページを並べ替えて、目的の順序と階層にページを表示させることができます。 ツリー ビューでページ タイトルをドラッグ アンド ドロップすると、次の操作を実行できます。
- ページの親子関係を変更します。
- 階層内のページの順序を変更します。
Note
階層内のページを移動すると、他のページからのリンクが壊れる可能性があります。 これらのリンクは、ページの移動後に手動で修正できます。 階層内のページの順序を変更しても、ページ リンクには影響しません。
ページの移動後に壊れたリンクを手動で修正する
階層内のページを移動した後に壊れたリンクを手動で修正するには、次の手順に従います。
- 壊れたリンクを特定する:
- 移動したページに最初にリンクしたページに移動します。
- 破損したリンクを探します。これは、エラーまたはコンテンツが見つからないように見える可能性があります。
- リンク ページを編集する: リンクが壊れたページを編集モードで開きます。
- リンクを更新します。
- コンテンツ内の壊れたリンクを見つけます。
- 移動したページの新しい場所を指すようにリンクを更新します。通常、リンク内の URL またはパスを変更する必要があります。
- 変更を保存する: 変更をページに保存して、更新されたリンクを適用します。
- 修正を確認する: 更新されたリンクに移動して、移動されたページを正しくポイントしていることを確認します。
例
ページ/docs/old-path/page.md/docs/new-path/page.mdを移動した場合は、次の手順を実行します。
- 次のように
Link to Page、コンテンツ内の壊れたリンクを見つけます。 - 新しいパスへのリンクを編集します。
Link to Page - 変更を保存し、リンクが新しい場所を正しく指していることを確認します。
キーボード ショートカットを使用してページを並べ替える
キーボード ショートカットを使用してページを並べ替えることもできます。 ページを選択し、 Ctrl + 上方向 キーまたは Ctrl + ↓ キーを押 してページの順序を変更します。 ページの親子関係を変更するには、そのコンテキスト メニューを開 き、[移動] を選択します。 [ ページの移動 ] ダイアログが開きます。 現在のページを移動できる親ページを選択します。
キーボード ショートカットの完全な一覧については、「 Wiki ページを管理するためのキーボード ショートカット」を参照してください。
Wiki ホーム ページにページを作成する
既定では、Wiki の作成時に追加する最初のページは Wiki ホーム ページとして設定されます。 ツリーの上部にページをドラッグ アンド ドロップすることで、別のページの関連性が高くなった場合は、Wiki ホームページを変更できます。