トピックのプレビュー id1696II000QR
トピックを作成すると、AEM Guidesがそのトピックのプレビューを生成します。 プレビューモードには、ドキュメントを操作するために使用できる様々な機能が用意されています。
トピックをプレビューするには、次の手順を実行します。
-
Assets UI で、表示するトピックに移動します。
-
表示するトピックをクリックします。
トピックのプレビューがAssets UI に表示されます。
note note NOTE アクティブなトピックまたは DITA マップのバージョンは、トピックの「ファイル」タブの右上隅に表示されます。 note important IMPORTANT プレビューツールバーでの次の機能の位置は、AEM サーバーの設定によって異なる場合があります。 一部の機能はメインツールバーで使用できますが、その他の機能は「その他」メニューで使用できます。
プレビューモードで使用できる機能
プレビューモードのツールバーから、次の操作を実行できます。
プロパティ
選択したトピックのプロパティを表示します。 AEMのバージョンに応じて、メタデータ、\（de\）アクティベーションのスケジュール、参照、ドキュメントの状態などのプロパティが表示されます。
title タグから自動入力されます。 プロパティウィンドウを使用してタイトルを変更すると、その変更は失われます。 title プロパティを更新する場合は、web エディターを使用して更新する必要があります。プロパティ ページには、マップやトピックが使用されている場所や、ドキュメントに含まれる参照など、参照に関する有用な情報が含まれています。 プロパティ ページには、ドキュメントに対する 2 種類の参照 Used In 参照 と Outgoing References が一覧表示されます。
使用されている場所 参照には、現在のファイルが参照または使用されているドキュメントが一覧表示されます。 外部参照 には、現在のドキュメントで参照されているドキュメントが一覧表示されます。
使用されている場所 参照セクションの\（+\） アイコンを使用すると、そのトピックが使用されている、または参照されている場所を探すために上に移動できます。
ドキュメントの横にある
条件付きフィルター\（A/B\）
トピックに条件付きコンテンツがある場合は、ツールバーに A/B アイコンが表示されます。 このアイコンをクリックすると、ポップアップが開き、トピックで使用可能な条件に従ってコンテンツをフィルタリングできます。
編集
- 編集するトピックを Web エディターで開きます。 管理者が チェックアウトせずに編集を無効にする オプションを有効にしている場合、編集 オプションは使用できません。 オプションを有効にすると、トピック ファイルをチェックアウトした後にのみ 編集 オプションが表示されます。
主な解決策
- トピックにキースペースファイルを使用する場合は、「キー解像度」アイコンをクリックします。 その後、キー解像度ポップアップからキースペースを選択します。
ソース
-
XML ソースコードを開きます。 マップ、トピック、または DITAVAL ファイルの基になる XML コードを表示するには、プレビューモードでファイルを開き、「Source」アイコンをクリックします。 「XML Source」ポップアップに、XML ソースコードが表示されます。 ファイルから特定のコードを選択するか、
Ctrl+aキーを押してコンテンツ全体を選択できます。note note NOTE DITA マップファイルのソースコードビューを取得するには、Assets UI でそのファイルを選択し、「Source」をクリックします。 
UUID リンクを共有
-
AEM Guidesでは、以下の場所から DITA マップ、トピック、およびイメージファイルの UUID ベースのリンクを共有できます。
- ASSETS UI
- DITA マップのコンソール
- トピックまたは画像のプレビュー
新しいオプション UUID リンクを共有 が、上記の領域のツールバーに表示されます。 次のスクリーンショットは、トピックのプレビューモードの UUID リンクを共有 オプションを示しています。
Asset UI では、このオプションはファイルを選択すると表示されます。 プレビューモードの間、このオプションはデフォルトでメインツールバーで使用できます。 DITA マップコンソールでは、このオプションは「出力プリセット」セクションに表示されます。
URL をコピーしたら、同じ項目を他のユーザーと共有して、他のユーザーがファイルに直接アクセスできるようにします。 このリンクは、ファイルがリポジトリ内の他の場所に移動された場合でも有効です。 リンクが失敗するのは、ファイルがリポジトリから削除されたときだけです。
DITA マップコンソールまたはファイルのプレビューモードからリンクを共有すると、ユーザーは同じファイルのビューに移動します。 ただし、Assets UI からマップファイルのリンクを共有すると、マップのコンソールに移動します。 同様に、トピックまたは画像ファイルの場合、ファイルのプレビューが表示されます。
チェックアウト/チェックイン
- チェックアウト機能とチェックイン機能を切り替えます。 ファイルがチェックアウトされると、現在のユーザーはそのファイルに対して排他的な書き込み権限を取得します。 チェックアウトしたファイルは、Web エディターで開いて編集できます。 必要な変更を加えたら、「チェックイン」アイコンをクリックしてファイルを DAM に保存します。
トピックをチェックアウトすると、ファイルのステータスがカード表示およびリスト表示でチェックアウト済みとして表示されます。
チェックアウトしたファイルをカード表示で表示：
チェックアウトされたファイル （リスト表示）:
「チェックアウト」列が表示されない場合は、「リスト表示」の「表示設定」を選択し 「列を設定 ダイアログで「チェックアウト」ステータスを選択します。
Web ベースバージョンの違い
-
トピックに変更が加えられている場合は、そのトピックの異なるバージョンで行われた変更を簡単に見つけることができます。 トピックの様々なバージョンの変更を検索するには、次の手順に従います。
note important IMPORTANT 以下の手順で説明する方法は、DITA ファイルにのみ適用できます。 DITA 以外のファイルの場合は、タイムラインビューを使用してバージョンを作成するか、ファイルの既存のバージョンを復元します。 -
トピックをプレビューモードで開きます。
-
左側のパネルで バージョン履歴 をクリックし、バージョンを選択します。
-
リストに表示されたバージョンから、ベースバージョンとして使用するバージョンを選択し、「バージョンをプレビュー」をクリックします。 選択したバージョンのプレビューがバージョンのプレビューウィンドウに表示されます。
-
差分を表示 リストから、ベースバージョンの比較に使用するバージョンを選択します。
トピックのプレビューで、変更されたコンテンツがハイライト表示されます。 緑色でハイライト表示されたコンテンツは新しく追加されたコンテンツを示し、赤色のコンテンツは削除されたコンテンツを示します。
-
ブランチ、元に戻す、後続のバージョン管理 id193PG0Y051X
-
通常のオーサリング環境では、特定のリリースに対応するトピックの新しいブランチを作成する必要があります。 他のバージョン管理システムと同様に、AEM Guidesでは、トピックの既存のバージョンからブランチを作成したり、トピックの古いバージョンに戻したりすることができます。 AEM Guidesに用意されているバージョン管理機能を使用して、次のタスクを実行できます。
- トピックの既存のバージョンから分岐を作成する
- 新しいブランチでの後続のバージョンの作成
- 特定のバージョンのトピックに戻す
次の図に、一般的なブランチと後続のバージョン管理システムを示します。
新しいトピックの場合、最初のバージョンには 1.0 という番号が付けられます。その後、トピックの新しいバージョンはすべて、1.1、1.2 などの増分番号で保存されます。 トピックのブランチを作成すると、ブランチの作成元のバージョン番号を取得して新しいブランチが作成され、バージョンの最後に。0 が追加されます。 図に示すように、トピックのバージョン 1.1 から新しいブランチが作成されます。 新しいブランチのバージョンは 1.1.0 になります。その後は、このブランチで新しいバージョンのトピックを保存するたびに、1.1.1、1.1.2 などの増分バージョン番号が取得されます。
ブランチと同様に、作業用バージョンまたは現在のバージョンを、リポジトリに存在する任意のバージョンに戻すこともできます。 バージョンに戻すには、トピックの目的のバージョンを選択し、バージョン履歴 パネルの このバージョンに戻る をクリックします。
ブランチを作成し、特定のバージョンに戻して、後続のバージョンのトピックを維持するには、以下の手順を実行します。
note important IMPORTANT 以下の手順で説明する方法は、DITA ファイルにのみ適用できます。 DITA 以外のファイルの場合は、タイムラインビューを使用してバージョンを作成するか、ファイルの既存のバージョンを復元します。 -
Assets UI のトピックにアクセスします。
note note NOTE トピックをプレビューモードで開いて、手順 3 に進むこともできます。 -
分岐を作成するトピックを選択します。
-
左側のパネルで、「バージョン履歴」をクリックします。
note note NOTE 選択したトピックで使用可能なバージョンのリストが表示されます。 各バージョンには、タイムスタンプ、ユーザー名、バージョンコメント、 ラベル情報が含まれます。 -
ブランチを作成するバージョンを選択します。 次のスクリーンショットでは、ブランチを作成するためにバージョン 1.2 が選択されています。
note note NOTE トピックの現在のバージョンには、バージョン番号の横に \（Current\） が記載されています。 -
「このバージョンに戻る」をクリックします。
新しいブランチの作成を確認するメッセージが表示されます。
-
\（オプション\） メッセージプロンプトには、「現在の作業コピーを新しいバージョンとして保存」を選択するオプションがあります。 このオプションの選択に基づいて、次の 2 つのアクションが可能です。
-
このオプションを選択すると、バージョン 1.1 からブランチが作成されます。また、トピックの新しいバージョンもトピックの現在の作業コピーから作成され、次のバージョンとして保存されます – 1.4。
バージョン 1.2 は、トピックの現在の作業用コピーになります。 この後に保存されたすべてのバージョンは、1.1 の新しいブランチの下に作成されます。例えば、このブランチの新しいトピックの後続バージョンは 1.2.0 として保存されます。
-
このオプションを選択しない場合、トピックの現在の作業コピーから新しいバージョンは作成されません。 トピックのバージョン 1.2 から新しいブランチが作成されます。 トピックの後続のバージョンは、1.2 ブランチに 1.2.0、1.2.1 などとして保存されます。
-
-
「OK」をクリックします。
選択したトピックのバージョンから新しいブランチが作成されます。 上記のプロセスは、トピックの特定のバージョンに戻す場合にも適用できます。 特定のバージョンへの復帰とは、技術的には、選択したバージョンから新しいブランチを作成し、そのバージョンをトピックの現在の作業コピーにすることを意味します。 元に戻したファイルの履歴は、バージョンへの戻しの履歴レポートでも確認できます。 このレポートの詳細については、「元に戻したファイルのバージョン履歴レポート を参照してください。
親トピック： トピックの作成とプレビュー