Web エディタからの DITA マップレポート id231HF0Z0NXA
AEM Guidesには、参照の全体的な整合性を確認し、参照のレポートを生成できる web エディターの機能が付属しています。
トピック リストの表示、すべての参照のメタデータの管理、および現在のマップのマルチメディア リストの表示は、Web エディタの レポート タブで行えます。
トピックリスト表示からの CSV の生成
トピックリスト ビューには、参照タイプ、ドキュメントの状態、作成者など、トピックに関する詳細情報が表示されます。
次の手順を実行して、トピックのレポートを作成できます。
-
リポジトリ パネルで、DITA マップファイルをマップビューで開きます。
-
「管理 タブをクリックします。
-
左側の トピックリスト をダブルクリックします。 DITA マップに存在するトピックのリストが表示されます。
{width="800"}
-
フィルター パネルから、参照タイプ\(直接または間接\)、ドキュメントの状態\(トピックの現在の状態)に基づいてトピックをフィルタリングできます。 例えば、トピックの状態が編集、レビュー中またはレビュー済みの場合、リストは\)またはトピックの 作成者 となります。
-
また、次のトピックのフィルタリングオプションを使用して、リストに次の列を表示するように選択することもできます。
- トピック トピックのタイトルは DITA マップで指定されます。 トピックをクリックして編集できます。
- ファイル名 ファイルの名前。
- UUID ファイルのユニバーサル固有識別子\(UUID\)。
- ファイルの場所 トピックの完全パス。
- 参照タイプ 参照のタイプ(直接または間接)。
- ドキュメントの状態 トピックの現在の状態。
- 作成者 トピックに対して最後に作業したユーザー。
- 親マップ トピックが直接参照されているすべてのマップのリスト。
note note NOTE 更新 をクリックすると、トピックのリストが更新され、マップ ファイル内の変更や、トピック ファイル内の参照が更新された場合に表示されます。 -
「CSV をダウンロード」をクリックして、DITA マップ内のトピックの現在のスナップショットをダウンロードします。 CSV には、選択した列と、トピックリスト ビューでフィルタリングされたトピックが含まれています。 その後、このトピックリストの CSV ファイルを任意の CSV エディターで開くことができます。
メタデータレポートからのメタデータの一括管理
AEM Guidesを使用すると、Web エディタから DITA コンテンツにタグを付けることができます。 個々のトピックにタグを適用したり、一括タグ付け機能を使用して、複数のトピック、DITA マップ、またはサブマップに複数のタグを適用できます。 選択したすべてのトピックのドキュメント状態を、次に使用可能な共通ドキュメント状態に変更することもできます。
メタデータの表示
現在の DITA マップ内の参照のメタデータを表示するには、次の手順を実行します。
-
リポジトリパネルで、マップビューで DITA マップファイルを開きます。
-
「管理 タブをクリックします。
-
左側の メタデータ をダブルクリックします。 DITA マップ内のすべての参照のメタデータリストが表示されます。 これにはメディア参照も含まれます。
{width="800"}
-
フィルター パネルでは、ドキュメントの状態\(トピックの現在の状態)に基づいてトピックをフィルタリングできます。 たとえば、トピックの状態が [ 編集 ]、[ レビュー中 ]、または [ レビュー済み ] の場合、参照の状態 参照 \(直接または間接\)、ファイルの種類 \(マップ、トピック、およびイメージ\)が一覧表示されます。
-
また、タグのないファイル のみを表示するように選択したり、タグ フィルターから特定のタグを選択して関連付けられたファイルを表示したりすることもできます。
-
また、次のトピックのフィルタリングオプションを使用して、メタデータリストに次の列を表示するように選択することもできます。
-
タイトル \(デフォルトで選択\)参照ファイルのタイトルは DITA マップで指定されます。 ファイルをクリックして編集できます。また、オーディオ ファイルやビデオ ファイルをクリックして、Web エディターで再生することもできます。 ビデオのボリュームまたはビューを変更できます。 ショートカット メニューには、ダウンロード、再生速度の変更、または画像内の画像の表示を行うためのオプションもあります。
note note NOTE チェックアウト済みファイルのタイトルの近くに、チェックアウト済みアイコンも表示されます。 アイコンの上にマウスポインターを置くと、ユーザーの名前が表示されます。 -
ファイル名 ファイルの名前。
-
ファイルの場所 ファイルの完全パス。
-
タグ\(デフォルトで選択\)ファイルに適用されるタグ。
note note NOTE デフォルトでは、1 つのファイルに対して 2 つのタグを表示できます。 さらにタグを表示するには、「さらに表示」をクリックします。 「表示を減らす」をクリックして、リストを再度縮小します。 -
参照タイプ 参照のタイプ(直接または間接)。
-
ドキュメントの状態 \(デフォルトで選択\)参照ファイルの現在の状態。
-
ファイルタイプ \(デフォルトで選択\)ソースファイルのタイプ。 使用できるオプションは、マップ、トピック、画像です。
-
チェックアウト者 ファイルをチェックアウトしたユーザー。
-
-
-
「CSV をダウンロード」をクリックして、DITA マップ内の参照の現在のスナップショットをダウンロードします。 CSV には、選択した列と、トピックリスト表示でフィルタリングされた参照が含まれています。 その後、このメタデータ CSV ファイルを任意の CSV エディターで開くことができます。
メタデータを更新
-
メタデータを更新するには、更新するファイルを選択します。
note note NOTE チェックアウトしたファイルは選択できません。 チェックアウト済みファイルのタイトルの近くに、チェックアウト済みアイコンも表示されます。 アイコンの上にマウスポインターを置くと、ユーザーの名前が表示されます。 -
上部の「管理」を選択します。
{width="350"}
-
新しいタグを追加する場合は、ドロップダウンリストから「新しいタグ」を選択し、選択したすべてのトピックに適用します。 タグの近くにある十字アイコンをクリックして、タグを削除することもできます。
note note NOTE 選択したすべてのトピックに適用されている共通のタグが一覧表示されます。 -
選択したすべての参照のドキュメント状態を変更する場合は、新しいドキュメント状態を選択します。 ドロップダウンには、選択したすべてのトピックに共通する可能な状態が表示されます。 例えば、トピックの現在の状態がレビュー中の場合は、ドラフト、承認済み、またはレビュー済みの状態を表示できます。
-
「更新」をクリックして、メタデータを更新します。 正常に更新されたか、更新に失敗したかに関わらず、メタデータに対する確認メッセージが表示されます。 また、「レポートをダウンロード」をクリックして、確認ダイアログからメタデータ CSV をダウンロードします。 この CSV には、選択した参照の更新ステータスの詳細が含まれています。
マルチメディアレポートの生成
マルチメディア レポートは、タイトル、タイプ \(audio, video, and images\)、マルチメディアが使用されているファイル、およびマルチメディアが使用されているファイルの参照タイプなど、マップで使用されているマルチメディアに関する詳細情報を提供します。 また、リポジトリー内の UUID とマルチメディアの場所を表示することもできます。 次の手順を実行して、マルチメディアのレポートを作成できます。
-
リポジトリ パネルで、DITA マップファイルをマップビューで開きます。
-
「管理 タブをクリックします。
-
左側の [マルチメディア をダブルクリックします。 DITA マップに存在するマルチメディアのリストが表示されます。
-
フィルター パネルから、マルチメディア別または参照で使用されるの名前別にリストを並べ替えることができます。
-
マルチメディア で並べ替えると、最初の列にマルチメディアの 名が表示され、そのマルチメディアが使用されたすべての参照の名前が同じ行の別の列に表示されます。 例えば、次のスクリーンショットは、最初の列にマルチメディア WarmCoolForC.gif を示しており、同じ行の 3 番目の列には使用されている 3 つの参照が表示されています。
{width="650"}
-
Used In 列で並べ替えると、転置ビューが表示されます。このビューでは、マルチメディアが使用された参照の名前が最初の列に表示され、マルチメディアの名前が別の行の別の列に表示されます。 例えば、次のスクリーンショットは 3 つの参照の名前(座席温度を調整、座席温度の表示を変更、乗務員領域\)を 1 列目に表示し、3 列目の 3 つの異なる行にマルチメディアの WarmCoolForC.gif を表示しています。
{width="650"}
-
-
マルチメディアタイプ と 参照タイプ に基づいてマルチメディアをフィルタリングできます。 ドロップダウンでの選択に基づいて、マルチメディアファイルのリストが表示されます。 たとえば、DITA マップ内のオーディオ参照のみを表示するように選択したり、ファイルに使用されているオーディオ参照のみを表示することができます。
note note NOTE マップで使用されるマルチメディアの種類に応じて、[ 画像 ]、[ ビデオ ]、[ オーディオ ] が [ マルチメディアの種類 ] ドロップダウンに表示され [ 直接参照の種類 ] または [ 間接参照 ] が [参照の種類] ドロップダウンに表示されます。 -
また、次のフィルタリングオプションを使用して、リストに次の列を表示するように選択することもできます。
- マルチメディア\(デフォルトで選択\)マルチメディアのタイトルは DITA マップで指定されます。 マルチメディアをクリックして編集できます。
- マルチメディアの場所 マルチメディアの完全なパス。
- マルチメディア UUID ファイルのユニバーサル固有識別子\(UUID\)。
- マルチメディアの種類 \(デフォルトで選択\)マルチメディアの種類。 使用できるオプションは、オーディオ、ビデオまたは画像です。
- 使用\(デフォルトで選択\)マルチメディアが使用された参照。 参照をクリックして編集できます。
- 参照タイプ\(デフォルトで選択\)参照のタイプ(直接または間接)。
note note NOTE 更新 をクリックして、マルチメディアの新しいリストを取得し、マップファイルの変更を表示します。または、DITA マップ内のマルチメディアが更新された場合に表示します。 -
また、Web エディターでオーディオまたはビデオファイルをクリックして再生することもできます。 ビデオのボリュームまたはビューを変更できます。 ショートカット メニューには、ダウンロード、再生速度の変更、または画像内の画像の表示を行うためのオプションもあります。
{width="800"}
-
「CSV をダウンロード」をクリックして、マルチメディアの現在のスナップショットを DITA マップにダウンロードします。 この CSV には、選択した列と、「マルチメディア ビューでフィルタリングされたマルチメディアが含まれ います。 その後、このマルチメディア CSV ファイルを任意の CSV エディターで開くことができます。
壊れたリンクの表示と修正 report-broken-links
リンク切れ は、現在のマップに存在するリンク切れの詳細を提供する便利なレポートです。 DITA トピック、マルチメディアファイル参照、コンテンツキー参照などのリンク切れを表示できます。 また、ここでそれらを修正する機能もあります。
このレポートには、壊れたリンク、リンクの種類、参照が使用されているファイル、使用されているファイルの種類などの詳細情報が表示されます。
次の手順を実行すると、壊れたリンクのレポートを表示できます。
-
リポジトリ パネルで、DITA マップファイルをマップビューで開きます。
-
「管理 タブをクリックします。
-
左側の リンク切れ をダブルクリックします。 DITA マップに存在するリンク切れまたは参照のリストが表示されます。
-
フィルター パネルでは、リンク別または参照で使用されるの名前別にリストを並べ替えることができます。
- リンク切れ で並べ替えると、リンク切れのパスが最初の列に表示され、それらが使用されているすべての参照の名前が別の列の別々の行に表示されます。 同じ壊れたリンクが複数のファイルで使用されている場合は、1 行に表示され、グループ化またはサブ行として表示されます。 例えば、次のスクリーンショットは、最初の列と
TestMap.ditamap
れらが使用される参照で 3 つの壊れたリンクを示しており、3 つの異なる行の 3 番目の列に表示されています。
{width="800"}
- Used In 列で並べ替えると、切れ離されたリンクが使用された参照の名前が最初の列にリストされ、切れ離されたリンクが同じ行の別の列にリストされる転置ビューが表示されます。 例えば、次のスクリーンショットは、(壊れたリンクが使用されている)参照
TestMap.ditamap
最初の列に表示され、壊れたリンクは同じ行の 3 番目の列に表示されます。
{width="800"}
- リンク切れ で並べ替えると、リンク切れのパスが最初の列に表示され、それらが使用されているすべての参照の名前が別の列の別々の行に表示されます。 同じ壊れたリンクが複数のファイルで使用されている場合は、1 行に表示され、グループ化またはサブ行として表示されます。 例えば、次のスクリーンショットは、最初の列と
-
ファイルタイプ と リンクタイプ に基づいて、壊れたリンクをフィルタリングできます。 ドロップダウンでの選択に基づいて、壊れたリンクのリストが表示されます。 たとえば、DITA マップ内のコンテンツ参照のみを表示するように選択したり、ファイルで使用されるコンテンツ参照のみを表示することができます。
マップで使用されている参照のタイプに応じて、「ファイル参照」、「キー参照」、「コンテンツ参照」、「コンテンツキー参照」、「イメージ参照」、「マルチメディアファイル参照」が「リンクタイプ」ドロップダウンに表示され、「DITA トピック」または「DITA Map」が「ファイルタイプ」ドロップダウンに表示されます。
-
また、次のフィルタリングオプションを使用して、リストに次の列を表示するように選択することもできます。
-
リンク切れ (デフォルトで選択) リンク切れのパスは DITA マップで指定されます。
-
リンクタイプ (デフォルトで選択)リンクのタイプ。 使用可能なオプションは、「コンテンツキー参照」、「コンテンツ参照」、「DITA トピック」、「ファイル参照」、「イメージ参照」、「キー参照」、「マルチメディアファイル参照」です。
-
使用 (デフォルトで選択)切断リンクが使用された参照。 参照をクリックすると、オーサーモードで表示できます。
-
ファイルタイプ (デフォルトで選択)参照のタイプ - DITA Map または DITA Topic。
更新 をクリックすると、壊れたリンクのリストが更新され、マップ ファイル内の変更や DITA マップ内の壊れたリンクが更新された場合に表示されます。
-
-
リンクを修正 アイコン( )をクリックして、壊れたリンクを修正できます。
note note NOTE 「リンク切れ」列の下のリンク切れパスにポインタを合わせると、「リンクを修正( )」アイコンが表示されます。 壊れたリンク または 使用されている場所 で注文した場合、両方のビューでリンクを修正できます。
note note NOTE 壊れたリンクで注文している間に壊れたリンクを修正すると、そのリンクが使用されているすべてのファイル(1 行にグループ化されているファイル)でリンクが修正されます。 -
リンクを更新 ダイアログで、必要な参照の詳細を更新する必要があります。 リンクを更新 ダイアログで必要な詳細は、参照のタイプによって異なります。
リンクを修正すると、壊れたリンクのリストの下に表示されなくなります。 代わりに、トピックリストまたはメタデータで表示できます。 -
「CSV をダウンロード」をクリックして、DITA マップ内の壊れたリンクの現在のスナップショットをダウンロードします。 CSV には、選択した列と、Broken Links ビューでフィルタリングされた壊れたリンクが含まれています。 その後、この CSV ファイルを任意の CSV エディターで開いて表示できます。
親トピック: Reports