Wiki コンテンツをオフラインで複製および更新する

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

Git リポジトリでコードを開発するのと同じ方法で、Wiki ページをオフラインで更新できます。

必要な任意のクライアントまたは git コマンドラインツールを使用して、Wiki をオフラインで更新できます。 Git リポジトリの使用とサポートされているツールについて詳しくは、Git リポジトリに関する記事をご覧ください。

Wiki コンテンツをオフラインで更新する基本的な手順は次のとおりです。

前提条件

Markdown ページを別の Wiki からチームプロジェクト Wiki に移行するか、コードとして Wiki に発行するコンテンツに移行するには、次の手順を実行します。

Wiki リポジトリには、ページ、画像、添付ファイル、ページとサブページのシーケンスが格納されます。 Wiki を複製して開始します。

プロジェクト (https://dev.azure.com/{Your_Organization/Your_Project}) にサインインし、Wiki を選択します。
[その他のアクション] コンテキストメニューを開き、[Wiki の複製] を選択します。
[リポジトリの複製] ダイアログで、[複製 URL をクリップボードにコピー] を選択します。

ブラウザーに入力して、wikiMaster ブランチで定義されているファイルを表示します。
コピーした URL を使用して、使用する IDE でリポジトリを複製します。詳細については、次のいずれかの記事を参照してください。

Markdown 形式を使用してページを作成します。 Wiki に追加するページとサブページごとに、ローカルブランチに Markdown ファイルを追加します。

Wiki ツリーのルートにページを追加するには、Git リポジトリのルートに Markdown ファイルを追加します。

追加するページごとに、ページの内容を含む Markdown ファイルを作成し、リポジトリのルートフォルダーの下に追加します。

CanaryBuilds チームプロジェクトの場合は、次のフォルダーにあります。

C:\Users\UserName\Source\Repos\CanaryBuilds.wiki
Wiki ツリーのルートにページを追加するには、Git リポジトリのルートにある各ページの Markdown ファイルを追加します。
ルートに追加するすべてのページを追加したら、ルートにある .order ファイルを更新します。ルートで定義されている Markdown ファイルごとに 1 つのエントリが必要です。各エントリは、ファイルタイトルとスペースをダッシュで置き換えたものに一致する必要があります。

次に例を示します。
```
 Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference  
```

親ページのフォルダーを作成し、フォルダー内の各サブページの Markdown ファイルを追加します。

たとえば、次のファイルを投稿方法フォルダーに追加しました。これらのサブページは Wiki の [投稿方法] ページの下に表示されます。
wiki に表示されるサブページの順序を含む .order ファイルをフォルダーに追加します。 .order ファイルを使用してページをシーケンスする方法については、Wiki Git リポジトリファイルとファイル構造に関するページを参照してください。

たとえば、ファイルには次のサブページがあります。
```
 Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines  
```

すべての更新が完了したら、 Git リポジトリにファイルをプッシュします。

追加されたページとサブページは、Wiki にすぐに表示されます。

Wiki ツリーが更新されました

プロセスにエラーがある場合、ページは Wiki に警告記号と共に表示されます。

.order ファイルが正しく更新されない場合の警告。