概要

Adobe Experience Manager Guidesで分岐すると、DITA マップ用の​main ブランチから複数のブランチを作成および管理して、様々なドキュメントリリースを並行して作業できます。 各ブランチでは、作成者は、他のブランチの対応するコンテンツに影響を与えることなく、コンテンツの変更を個別に管理できます。

分岐を使用すると、複数のチームが、同じDITA マップに関連する異なるリリース、機能、または修正を同時に作業できます。 更新の準備ができたら、ブランチからデフォルトブランチ （main）に変更を結合できます。

分岐の仕組み

ブランチは、main​またはDITA マップの既存のブランチから作成できます。 ブランチを作成したら、ブランチに切り替えて、マップとそのコンテンツの編集を開始できます。 選択したブランチからコンテンツを公開したり、準備ができたら変更をmainに結合したりすることもできます。

例えば、製品のインストール手順を含むinstall-the-lift.ditamapという名前のDITA マップを考えてみましょう。 ドキュメントチームは、mainからこのマップの2つのブランチを作成できます。

両方のチームは、お互いの変更に影響を与えることなく、それぞれのマップブランチで独立して作業できます。

DITA マップのブランチを作成する場合、Experience Manager Guidesはマップの参照トピックを新しいブランチに自動的にコピーしません。 変更されていないトピックは、ソースブランチまたはデフォルトブランチ（main）から読み取られます。 トピックは、そのブランチで編集して保存する場合にのみ、新しいブランチにコピーされます。

例えば、DITA マップは100件のトピックを参照し、リポジトリにはマップで参照されない50件の追加トピックが含まれます。 新しいブランチ（release-1.0）を作成すると、100件の参照トピックはすべて、編集されていなくても、自動的にrelease-1.0の一部になります。 参照されていない50個のトピックは、自動的に新しいブランチの一部にはなりません。 そのうち10個を編集した場合、その10個のみがリリース 1.0の一部になります。 残りの40個の未変更のトピックは、デフォルトのブランチ（main）から引き続き使用されます。

主な特長

Experience Manager Guidesのブランチを操作すると、次のメリットが得られます。

分岐とベースライン

ベースライン​は、DITA マップのトピックバージョンの特定の組み合わせを識別し、選択したバージョンを使用して出力を生成できるようにします。

ブランチ​は、DITA マップとそのコンテンツに対して個別の編集環境を提供し、作成者が同じマップの他のブランチに影響を与えずに変更を行えるようにします。

今後の機能

次の機能は現在、デフォルトブランチ（main）でのみサポートされており、今後のExperience Manager Guides リリースでは、DITA マップの他のブランチでもサポートされる予定です。