Wiki ページの追加と編集

  • [アーティクル]

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

Wiki Git リポジトリがチーム プロジェクト用にプロビジョニングされた後、ページにタイトルとコンテンツを追加できます。 ページを編集してコンテンツをプレビューできるサイド バイ サイドの編集とプレビューエクスペリエンスがあります。

Markdown 形式を使用してページを作成するときに、書式設定ウィンドウを使用してリッチ テキストの書式設定を行い、画像、添付ファイル、リンクを挿入することもできます。

Wiki のホーム ページ

ページを編集するときに、 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 を開く

サポートされている Web ブラウザーを使用してプロジェクトに接続し、[Wiki] を選択します。

強調表示された Wiki メニューの選択を示すスクリーンショット。

チーム プロジェクトを切り替える必要がある場合は、[Azure DevOps] を選択して、すべてのチーム プロジェクトとチームを参照します。

Wiki ページを追加する

別のページを追加するには、[ 新しいページ] を選択します。 または、サブページを追加するには、既存のページのコンテキスト メニューを開き、[ サブページの追加] を選択します。

235 文字以下の一意のタイトルを指定します。 ページ タイトルでは大文字と小文字が区別されます。 その他のタイトル制限については、「 Wiki Git リポジトリ ファイルとファイル構造」の「ファイルの名前付け規則」を参照してください。

最初の Wiki ページのスクリーンショット。

キーボード ショートカットを使用して 、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 を使用して、現在のページの編集にすばやく移動することもできます。

コード Wiki の場合は、マークダウン ツール バーを使用してコンテンツを作成し、サイド バイ サイド エディターでページを編集できます。 このエクスペリエンスは、プロジェクト Wiki のプロセスと同じです。 Repos ハブの Wiki ページも、[リポジトリ で編集] オプションを使用して編集できます。

Wiki ページの編集のスクリーンショット。

コード Wiki にブランチ ポリシーがある場合は、[リポジトリで編集] を選択してブランチを作成し、編集を続けます。 [ リポジトリ で編集] オプションは、特にコード Wiki で使用できます。

ページを削除するには、ツリーまたはページ内のコンテキスト メニューを開き、[削除] を選択 します。 開いたダイアログで削除を確認します。

Note

ページを削除すると、階層内のすべてのメタデータとそのすべてのサブページ (存在する場合) も削除されます。

Wiki ページを並べ替える

Wiki ツリー ビュー内のページを並べ替えて、目的の順序と階層にページを表示させることができます。 ツリー ビューでページ タイトルをドラッグ アンド ドロップすると、次の操作を実行できます。

  • ページの親子関係を変更します。
  • 階層内のページの順序を変更します。

Note

階層内のページを移動すると、他のページからのリンクが解除される可能性があります。 移動後は、いつでも手動でリンクを修正できます。 階層内のページの並べ替えは、ページ リンクには影響しません。

キーボード ショートカットを使用してページを並べ替えることもできます。 ページを選択し、 Ctrl + 上方向 キーまたは Ctrl + ↓ キーを押 してページの順序を変更します。 ページの親子関係を変更するには、そのコンテキスト メニューを開 き、[移動] を選択します。 [ ページの移動 ] ダイアログが開きます。 現在のページを移動できる親ページを選択します。

階層内の Wiki ページを移動する

キーボード ショートカットの完全な一覧については、「 Wiki ページを管理するためのキーボード ショートカット」を参照してください。

Wiki ホーム ページにページを作成する

既定では、Wiki の作成時に追加する最初のページは Wiki ホーム ページとして設定されます。 ツリーの上部にページをドラッグ アンド ドロップすることで、別のページの関連性が高くなった場合は、Wiki ホームページを変更できます。

次のステップ

Wiki ページの履歴を表示して元に戻す