Wiki 拡張機能からチーム プロジェクト Wiki にページを移行する

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

Wiki Marketplace 拡張機能を使用して作成されたページをチーム プロジェクト Wiki に移行する方法について説明します。 Wiki Marketplace 拡張機能を使用して作成した Wiki ページは、チーム プロジェクトの Git リポジトリに保存できます。

注

Wiki Marketplace 拡張機能は非推奨です。 ページを移行した後、アンインストールしてください。

前提 条件

カテゴリ	必要条件
プロジェクトへのアクセス	Wiki が配置されているプロジェクトのメンバー。 アクセス権がない場合は、プロジェクト管理者に依頼してください。
アクセス許可	共同作成者 グループのメンバー。
アクセスレベル	少なくとも Basic アクセス。

ページとその他の成果物の移行の概要

1. vsts-wikiTools リポジトリを複製し、MigrateToVSTSWiki ツールをコンパイルします。
2. Azure DevOps Wiki を作成し、複製します。
3. すべての Markdown ページを Azure DevOps Wiki に移動してコミットします。
4. wiki 移行ツールを実行 MigrateToVSTSWiki.exe
5. Wiki 移行ツールが完了したら、Azure DevOps Wiki リポジトリの既定のメイン ブランチ (wikiMain) に変更をプッシュします。

Wiki 拡張機能からページを移行する

1. vsts-wikiTools リポジトリを複製し、MigrateToVSTSWiki ツールをコンパイルします。

2. 移行ツール EXE を生成するには、パス Tools/MigrateToVSTSWikiの下にプロジェクトをコンパイルします。

3. Web ブラウザーから Azure DevOps チーム プロジェクトを開き、最初の wiki ページ作成 。

4. Wiki を複製するには、URL を取得します。 詳細については、「 Wiki を複製し、Wiki ページをオフラインで編集する」を参照してください。
   この複製の場所に、この手順の LocationA として名前を付けます。

5. IDE または git clone コマンドを使用して Wiki リポジトリを複製します。

6. Wiki 拡張機能リポジトリを複製します。 Wiki は、Wiki の作成時に指定されたフォルダーにマップされます。 次の例に示すように、既存の wiki の 管理 wiki オプションに移動して確認できます。 既存の Wiki ページは、Rootというラベルの付いたフォルダーの下に保存されます。

   たとえば、前述の sampleWiki を場所 C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki に複製したとします。

   この場所には、この手順の LocationB として名前を付けます。

7. ローカル コンピューター上の任意のパスに空のフォルダーを作成し、この手順に LocationC 名前を付けます。

   要約すると、次の場所は次のように表されます。

   • 場所 A = Azure DevOps Wiki リポジトリ
   • 場所 B = Wiki 拡張機能リポジトリ
   • 場所 C = 移行ツールを実行する空のフォルダー

8. 管理者としてコマンド プロンプトを開き、MigrateToVSTSWiki.exe実行します。 このツールは、既存の Wiki から指定した宛先ディレクトリにファイルをコピーします。 コピー中に、ツールはページを Azure DevOps Wiki に準拠するように変換します。

   MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

   例えば：

   • E:\wiki\sampleWiki\_extensionWiki は、既存の Wiki ファイルが存在するフォルダーです
   • E:\Temp\Wiki\New は、移行されたファイルのコピー先となる空のフォルダーです。

9. LocationAなどの Git 関連ファイルとは別に、.gitignore (存在する場合) からすべてのファイルを削除します。

10. LocationC からすべてのファイルをコピーし、LocationAに貼り付けます。

11. git add . を実行して、コミットの LocationA に新しく追加されたすべてのファイルをステージングします。

12. git commit -m <commit message> を実行して、ローカルにステージングされたファイルをコミットします。

13. git push origin wikiMain -f を実行して、変更を Azure DevOps Wiki の既定のブランチにプッシュします。

Wiki 拡張機能ファイルを Azure DevOps Wiki に移行したら、Wiki 拡張機能をアンインストールする準備ができました。

次のステップ

Wiki 拡張機能をアンインストールする

関連記事

• Wiki ページのタイトルの名前付け規則
• オフライン で Wiki ページを複製および更新する
• wiki ツールのソースコード
• Git クイックスタート

貢献

このプロジェクトでは、Microsoft オープン ソースの行動基準を採用しました。 詳細については、行動規範に関する FAQ を参照するか、質問やコメントを opencode@microsoft.com にお問い合わせください。