ベースラインの操作 id1825FI0J0PF
ベースライン機能を使用すると、トピックとアセットのバージョンを作成して、公開や翻訳に使用できます。 たとえば、DITA マップに topicA
と imageA
がある場合、3 番目のバージョンの topicA
を使用し、4 番目のバージョンの ImageA
を使用するベースラインを作成できます。 ベースラインを設定したら、1 回のクリックで様々なバージョンのトピックを公開または翻訳できます。
出力プリセットではベースラインの選択はオプションで、DITA マップには複数のベースラインを含めることができます。 ただし、DITA マップ内の各出力プリセットは、1 つのベースラインにのみ関連付けることができます。 公開時にベースラインが指定されていない場合、出力は最新バージョンのコンテンツを使用して公開されます。
同様に、コンテンツを翻訳するベースラインの選択はオプションです。 ただし、ベースラインを使用してコンテンツを翻訳することを選択した場合は、ベースラインのコンテンツも翻訳済みコピーと共に保存されます。 その後、翻訳済みベースラインを使用して、外部パブリッシャーとの共有やアーカイブなどの追加の操作を実行できます。 翻訳済みベースラインのエクスポートについて詳しくは、「 翻訳済みベースラインのエクスポート」を参照してください。
管理者は、マップダッシュボードの「ベースライン」タブを設定できます。 詳細は、『インストールと設定ガイド』の DITA マップダッシュボードの「ベースラインを設定」タブ 節を参照してください。
ベースライン機能にアクセスするには、次の手順を実行します。
- Assets UI で、に移動し、DITA マップファイルをクリックします。
- 「ベースライン」タブに移動します。
「ベースライン」タブでは、次のアクションを実行できます。
ベースラインの作成 id195FI0I0MUQ
特定の日時に使用可能なトピックと参照コンテンツの特定のバージョン、またはトピックのバージョン用に定義されたラベルを使用して、ベースラインを作成できます。 ベースライン内で選択したトピックのバージョンを個別に指定できるので、発行または翻訳ワークフローでベースラインを適用するたびに、選択したトピックとそれに対応するバージョンを出力の生成または翻訳に含めることができます。
ベースラインを作成するには、次の手順を実行します。
-
ベースライン ページで、「作成」をクリックします。
-
ベースラインの名前を「ベースライン名 に入力 ます。
{width="800"} -
バージョンの設定に基づく で、次のいずれかのオプションを選択します。
- ラベル:適用されるラベルに従ってトピックを選択するには、このオプションを選択します。 入力した文字列に基づいてリストをフィルタリングするためのラベルを入力します。 フィルターで除外リストからラベルを選択して、指定したラベルを持つトピックや他のアセットを選択できます。
ラベル を選択すると、指定したラベルが適用されていない最新バージョンのトピックを使用する追加のオプションも提供されます。 このオプションを選択しない場合、指定したラベルを持たないトピックまたはメディア ファイルがあると、ベースラインの作成プロセスは失敗します。 ラベルの追加について詳しくは、 ラベルの使用を参照してください。
- バージョン日 <タイムスタンプ>:指定された日時にトピックのバージョンを選択します。 ここで指定する時間は、AEM サーバーのタイムゾーンに対応することに注意してください。 サーバーが異なるタイムゾーンにある場合、トピックは、ローカルタイムゾーンではなく、サーバーのタイムゾーンに従って取得されます。
日付としてラベルまたはバージョンを選択すると、マップ内の参照されるトピックおよびメディア ファイルがすべて選択されます。 この選択したトピックは、ユーザーインターフェイスには表示されませんが、バックエンドで保存されます。
note note NOTE ベースラインを作成する際には、「すべてのトピックを参照 リンクを使用しないことをお勧めします。 -
「保存」をクリックします。
ベースラインのコンテンツの表示 id195FI0I0TLN
既存のベースラインの内容を表示するには、「ベースライン」タブをクリックし、リストから目的のベースラインバージョンを選択します。 ベースライン ページは、DITA マップファイル、マップのコンテンツまたはトピック、参照コンテンツの 3 つの部分に分かれています。 マップにサブマップが含まれている場合、サブマップから参照されるトピックも [ コンテンツ ] セクションに表示されます。 「ベースライン」ページの様々な列を以下に示します。
-
名前: DITA マップまたはトピックのタイトルまたはアセットの名前(イメージのファイル名など)を一覧表示します。
-
種類: DITA マップ、DITA トピック、画像形式など、マップ内のアセットの種類または種類を一覧表示します。
-
バージョン: ベースラインで使用可能なアセットのバージョンをリストします。
-
バージョン日時:選択したバージョンのアセットの作成日時をリストします。
-
最新: アセットの最新バージョンをベースラインで使用するかどうかをリストします。
-
親マップ:マップファイルにサブマップが含まれている場合、この列にはトピックが参照されているマップの名前が含まれます。
-
ラベル: トピックのバージョンに適用されたラベルを一覧表示します。
-
参照元:この列は、参照されているコンテンツでのみ使用できます。 これは、参照されるアセットの親トピックを示します。 アセットが複数のトピックで参照される場合、トピックはコンマで区切られます。
ベースラインの編集、複製、または削除 id195FI0I0YJL
ベースラインの編集
既存のベースラインを編集するには、次の手順を実行します。
-
「ベースライン」を選択し、「編集 をクリックします。
-
ベースラインに必要な変更を加えます。 トピックまたは参照コンテンツの名前とバージョンを変更できます。
-
1 つ以上のトピックに異なるバージョンを使用する場合は、それらのトピックを手動で選択します。 [ トピックの参照 ] をクリックし、別のバージョンを使用するトピックを選択します。 選択したトピックの「バージョンを選択」ドロップダウンリストから、ベースラインで使用するトピックのバージョンを選択し、「OK」をクリックします。
{width="800"}
トピックと選択したバージョンに関する情報がバックエンドに保存されます。 この手順を繰り返して、複数のトピックの選択したバージョンを変更できます。
-
DITA マップから参照されるすべてのトピックとメディアファイルをロードするには、「すべてのトピックを参照」リンクをクリックします。 トピックとメディアファイルの UUID は、トピックのタイトルまたは\(media\)ファイル名の下にも表示されます。
note note NOTE DITA マップに非常に大きなファイル セットがあり、ネストされたマップとトピックがある場合、[ すべてのトピックを参照 ] をクリックすると、すべてのファイルがロードされるまでしばらく時間がかかることがあります。 マップの内容は、マップ ファイル、コンテンツ \(トピック参照\)、参照コンテンツ \(ネストされたトピック、マップ、その他のアセット\)の 3 つのセクションに表示されます。 参照されているコンテンツをすべて使用したら、ベースラインで使用するトピックのバージョンを個別に選択できます。
バージョン ドロップダウンリストには、トピックまたは参照コンテンツの使用可能なバージョンが表示されます。 参照されるコンテンツの場合は、バージョンを自動的に選択するオプションがあります。
参照されるコンテンツに対して 自動的に選択 を選択した場合、システムは、参照されるコンテンツのバージョンに対応する、参照されるコンテンツのバージョンを自動的に選択します。 例えば、トピック A に画像 B への参照があるとします。トピック A のバージョン 1.5 を作成した時点では、リポジトリ内の画像 B のバージョンは 1.2 でした。 これで、トピック A のバージョン 1.5 でイメージ B が 自動的に選択 に設定された状態でベースラインが作成されると、イメージ B のバージョン 1.2 が自動的に選択されます。
ラベルを使用してベースラインを作成すると、自動的に選択 がすべての参照コンテンツのバージョンに適用されます。
参照されているコンテンツまたはアセット\(トピック、サブマップ、画像またはビデオ\)がバージョン管理されていない場合(新しくアップロードされたコンテンツなど)、ベースラインを作成すると、そのようなファイルのバージョンが作成されます。 ただし、ファイルがバージョン管理されている場合、それらのファイルの増分バージョンは作成されません。 この動作は、バージョンを自動作成の設定で制御されます。この設定はデフォルトで有効になっています。 これは、翻訳プロセスですべてのファイルにバージョンが必要とされるコンテンツの翻訳にも必要です。
note note NOTE 特定のリソースに異なるバージョンを指定する場合は、「バージョン」ドロップダウンリストから目的のバージョンを選択します。 1. 「**保存**」をクリックします。
ベースラインの複製
「ベースライン」を選択し、「複製」をクリックして、既存のベースラインのコピーを作成します。 ベースラインに別の名前を指定し、トピックと参照コンテンツのバージョン番号を選択して、「保存」をクリックします。
ベースラインの削除
ベースラインのバージョンを選択し、「削除」をクリックしてベースラインを削除します。
ベースラインへのラベルの追加 id184KD0T305Z
すべてのトピックにラベルを追加するのは時間がかかる場合があります。 AEM Guidesには、DITA マップ内の複数のトピックおよび参照コンテンツにラベルを追加するシングルクリックメカニズムが用意されています。
次の手順を実行して、DITA マップ内の複数のトピックおよび参照コンテンツにラベルを追加します。
-
[ ベースライン ] ページで、ラベルを追加するトピックと参照コンテンツを含むベースラインを選択します。
note note NOTE ベースラインに最新バージョンのトピックまたはアセットがないことを確認します。 ラベルは、バージョン管理されたトピックまたはアセットにのみ追加できます。 -
ラベルを追加 をクリックします。
{width="800"}
-
ラベルを追加 ダイアログで、このベースラインに関連付ける一意のラベルを指定します。
管理者が事前定義済みのラベルを設定している場合は、それらのラベルがドロップダウンリストに表示されます。 リストからラベルを選択する必要があります。
-
サブマップから参照されるトピックにラベルを適用する場合は、[子マップと従属にラベルを適用] オプションを選択します。
-
追加 をクリックします。
指定したラベルが DITA マップに追加され、参照されるトピックとコンテンツが追加されます。{width="650"}
-
翻訳済みベースラインのエクスポート id196SE600GHS
ベースラインを使用してコンテンツを翻訳できます。 例えば、フランス語に翻訳できるバージョン 1.1 のベースラインを作成できます。 「翻訳」タブでは、ベースラインを使用してコンテンツをフィルタリングし、コンテンツのバージョン 1.1 のベースラインを選択する必要があります。 コンテンツの翻訳にベースラインを使用すると、コンテンツの管理が容易になります。
コンテンツが翻訳されたら、翻訳済みベースラインをエクスポートしてアーカイブしたり、組織内の様々なチームと共有したりできます。 翻訳済みベースラインをエクスポートする前に、次の点を考慮する必要があります。
- ベースラインの書き出しは、ベースラインのコンテンツが翻訳された後でのみ可能です。 翻訳が開始されていないか、完了していないベースラインを書き出そうとすると、エラーが発生します。
- ベースラインを転送できるのは、翻訳済みのバージョンに対してのみです。 例えば、コンテンツのバージョン 1.1 のベースラインを作成し、同じベースラインが翻訳されている場合、このベースラインを書き出すことができます。 ただし、バージョン 1.2 のベースラインを作成し、そのベースラインが翻訳されていない場合、このベースラインをエクスポートすることはできません。
- ベースラインがすでにエクスポートされている場合、エクスポート時に「既存ベースラインの上書き オプションを選択することで、既存のベースラインを上書きできます。
次の手順を実行して、翻訳済みベースラインをエクスポートします。
-
変換後のベースラインを含む DITA マップを開きます。
-
「翻訳」タブで、左側のパネルにある「ベースライン」オプションを展開します。
{width="800"}
-
「ベースラインを使用」オプションを選択し、エクスポートするベースラインを選択します。
-
ベースラインのエクスポート をクリックします。
書き出しステータスが表示されます。 処理が成功すると、ベースラインが書き出される言語を示すメッセージが表示されます。 エラーが発生した場合は、エラーの原因が表示されます。
既にエクスポートされているベースラインをエクスポートしようとすると、ベースライン作成の失敗メッセージも表示されます。
-
\(オプション\)既にエクスポートされているベースラインをエクスポートするには、「既存のベースラインを上書き」を選択し、「ベースラインのエクスポート」をクリックします。
親トピック: 出力生成