DITA マップの分岐の作成と管理

Experience Manager Guidesでは、DITA マップの複数のブランチを作成して、様々なリリース、機能、または修正のドキュメントを管理できます。 分岐を切り替えて、関連するコンテンツで作業したり、不要になった分岐をアーカイブしたり、必要に応じて復元したりできます。

同じDITA マップの既存のブランチからブランチを作成することもできます。

ブランチを作成

DITA マップのブランチを作成して、他のブランチの対応するコンテンツに影響を与えることなく、ドキュメントの変更に取り組むことができます。

ブランチを作成するには、次の手順を実行します。

選択したDITA マップ用に新しいブランチが作成されます。 新しいブランチに切り替えて、関連するコンテンツの作業を開始できるようになりました。

分岐の切り替え

分岐を切り替えるには、次の手順を実行します。

これで、選択したブランチ内のマップとその関連コンテンツに取り組むことができます。

これで、選択したブランチ内のマップとその関連コンテンツに取り組むことができます。

分岐での独立した編集

DITA マップのブランチで作業する場合、そのコンテンツに加えられた変更は選択したブランチ内に残り、他のブランチの対応するコンテンツには影響しません。 これにより、複数の作成者が、マップの異なるブランチをまたいで独立して同じトピックに取り組むことができます。

デフォルトでは、変更されていないトピックはソースブランチまたはmainから読み取られます。 選択したブランチでトピックを編集すると、そのブランチの一部になります。 トピックに対するその後の変更は、選択したブランチ内に残ります。

同じDITA マップの分岐を切り替えて、それぞれのコンテンツを表示および編集できます。

ブランチ内のトピックの編集

選択したブランチのDITA マップに関連付けられているトピックは、他のブランチのコンテンツに影響を与えずに編集できます。

トピックを編集するには、次の手順を実行します。

選択したブランチのトピックを引き続き編集するか、別のブランチに切り替えてコンテンツを操作できます。

現在のマップコンテキスト以外のマップを開く

Experience Manager Guidesでは、マップコンテキスト​は、エディターで現在開いているDITA マップを指します。

現在のマップコンテキストに含まれていないマップ、トピック、またはアセットを開こうとすると、確認ダイアログが表示され、次のオプションが表示されます。

例えば、現在master_map.ditamapが​main ブランチで選択されているとします。

別のDITA マップを開こうとすると、次の確認ダイアログが表示されます。

選択したマップに切り替えるには、開く​を選択します。

main ブランチのマップコンテキストが新しく選択したマップに更新され、関連するコンテンツを操作できるようになります。

現在のマップコンテキスト以外のトピックを開いたり編集したりします

マップで参照されていないトピックは、ブランチで自動的に使用できません。

選択したブランチでそのようなトピックを編集できるようにするには、現在のブランチで編集​を選択します。

mainのコンテンツに影響を与えることなく、トピックを編集できるようになりました。 ただし、トピックは関連するDITA マップに自動的に追加されず、公開された出力には含まれません。 出力にトピックを含めるには、トピックをDITA マップに追加します。

分岐を管理

DITA マップの分岐は、マップコンソールの​分岐 パネルから管理できます。 使用可能なブランチの表示、新しいブランチの作成、既存のブランチの結合または名前変更、およびアクティブに使用されなくなったブランチのアーカイブを行うことができます。

分岐 パネルには、選択したDITA マップで使用可能なすべての分岐が一覧表示されます。

ブランチを管理するには、必要なブランチにカーソルを合わせ、オプション メニューを選択します。 次のアクションが使用可能です。

分岐 パネルの上部にあるオプションを使用して、分岐の検索、分岐リストの更新、新しい分岐の作成を行うこともできます。

分岐をアーカイブ

アクティブに使用されなくなったDITA マップの分岐をアーカイブし、必要に応じて復元できます。

ブランチをアーカイブするには、次の手順を実行します。

アーカイブされたブランチの復元

DITA マップのアーカイブされたブランチは、そのコンテンツの作業を再開する必要がある場合に復元できます。

アーカイブされたブランチを復元するには、次の手順を実行します。