[ 高度なマップエディタ ] を使用する id1942D0S0IHS
[ 高度なマップエディタ ] は、直感的なユーザインタフェースを備え、Web エディタに似ています。 Web エディタでマップファイルを開くと、[ 高度なマップエディタ ] インタフェースを使用してマップファイルを編集するオプションが表示されます。 [ 高度なマップエディタ ] を使用すると、トピック参照、キー参照、コンテンツの構造などを追加できます。
Web エディタから直接マップファイルを編集する以外に、マップ内のトピックファイルを開いて Web エディタを編集することもできます。 このトピックでは、高度なマップエディタの機能、および Web エディタで DITA マップ内のファイルを開いて編集する方法について説明します。
マップファイルにトピックを追加する
[ 高度なマップエディタ ] を使用してマップファイルを作成するには、次の手順を実行します。
-
Assets UI で、編集するマップファイルに移動します。
note note NOTE アセットの選択モードが有効になっていないことを確認します。 -
マップファイルに排他ロックを設定するには、マップファイルを選択し、 チェックアウト.
note note NOTE マップファイルに排他的なロックを設定すると、他のユーザはマップを編集できなくなります。 ただし、マップファイル内のトピックでは作業できます。 管理者が、編集前にファイルをチェックアウトするように Web エディターを設定している場合、ファイルを編集するには、チェックアウトする必要があります。 同様に、設定した場合は、ファイルを閉じる前に、チェックアウトしたファイルをチェックインするように求められます。 -
マップファイルを選択した状態で、 トピックを編集.
img-md w-800 または、 トピックを編集 オプションを選択します。
img-md w-800 マップファイルが Web エディタで開き、編集できます。
-
編集 アイコンをクリックします。
img-md w-550 マップが [ 高度なマップエディタ ] インタフェースで開きます。 新しいマップファイルを開いた場合は、マップのタイトルだけがエディタに表示されます。
img-md w-800 -
A - (メインツールバー):これは、Web エディターのメインツールバーに似ています。 詳しくは、 メインツールバー ( Web エディター)を参照してください。
-
B - (セカンダリツールバー) これは、マップファイルを操作するためのセカンダリのツールバーです。 セカンダリのツールバーで使用できる機能について詳しくは、 [ 高度なマップエディタ ] のツールバーで使用できる機能.
-
C - (マップビュー):マップエディタをレイアウト、作成者、ソース、プレビューの間で切り替えることができます。 The レイアウト DITA マップでトピックを整理できます。 これにより、マップのツリーまたは階層ビューが表示されます。 The 作成者 [ 表示 ] を使用すると、マップエディタでトピックを編集できます。 これにより、マップファイルの WYSIWYG ビューも表示されます。 The ソース ビューを使用すると、マップファイルの基になる XML を操作できます。 プレビューは、マップファイル内のすべてのトピックとサブマップの統合表示を提供します。 The 閉じる リンクはマップファイルを閉じます。
-
D - (左パネル):左側のパネルにアクセスし、お気に入り、リポジトリ、マップ、アウトライン、およびその他の機能にアクセスできます。 サイドバーを展開アイコン ( ) です。 左側のパネルで使用できる機能について詳しくは、 左パネル をクリックします。
-
E - (中央の領域):コンテンツ編集領域をマッピングします。
-
金 - (右パネル):プロパティパネルにアクセスできます。 選択したトピックまたはマップのコンテンツプロパティとマッププロパティを確認できます。 このパネルで使用できる機能について詳しくは、 右パネル をクリックします。
-
-
左側のパネルで、 リポジトリ表示.
-
AEMリポジトリで、追加するトピックまたはサブマップを含むフォルダーに移動します。
-
でトピックまたはマップファイルを選択します。 リポジトリ表示 をクリックし、「(中央)マップコンテンツ編集領域」にドラッグ&ドロップします。
トピックがマップに追加されます。
img-md w-800 -
後続のトピックまたはサブマップを追加するには、トピックまたはサブマップをマップ内の必要な場所にドラッグ&ドロップします。
マップファイルを構築する際には、次の点を考慮してください。
-
ファイルは、マップ編集領域で横棒が表示される場所に追加されます。 次のスクリーンショットでは、 概要 次の間にトピックが追加されます: 一般的な説明 および ローンチとランディングサイト トピック。
img-md w-350 -
トピックを置き換えるには、置き換えるトピックの上、左または右にトピックを配置します。 トピックの左または右にある縦棒は、そのトピックがドロップされたトピックに置き換えられることを示します。
img-md w-550 ただし、トピックを置き換える前に、確認プロンプトが表示されます。 トピックは、確認をおこなった後でのみ置き換えられます。
img-md w-300 -
DITA マップにサブマップを追加すると、サブマップが DITA マップ内のリンクとして表示されます。 サブマップのすべてのトピックを表示するには、Crtl キーを押しながらサブマップリンクをクリックします。 サブマップのコンテンツが新しいタブに表示されます。 同様に、DITA マップからトピックを開くには、Crtl キーを押しながらトピックリンクをクリックし、新しいタブで開きます。
-
ツールバーのショートカットキー( Ctrl + Z キー、 Ctrl + Y キー、またはそれぞれのアイコン)を使用して、マップの変更を元に戻したり、やり直したりできます。
-
トピックの位置を変更するには、トピックを選択し(トピックアイコンをクリック)、マップファイル内の目的の場所にドラッグ&ドロップします。 トピックを配置する位置に横棒が表示されていることを確認します。 次のスクリーンショットでは、トピックが示されています。 ローンチとランディングサイト は、 概要 トピック。
img-md w-350 -
マップファイルのプロパティを確認するには、マップ編集領域の任意の場所を右クリックし、を選択します。 プロパティ を選択します。 AEMのバージョンに応じて、メタデータ、スケジュール(de) アクティベーション、参照、ドキュメント状態などのプロパティを表示できます。
-
-
「保存」をクリックします。
[ 高度なマップエディタ ] のツールバーで使用できる機能 id205DEC0005Z
[ 高度なマップエディタ ] のツールバーは、Web エディタのトピックに似ています。 左側のパネルの切り替え、マップの保存、マップの新しいバージョンの作成、最後の操作の取り消し/やり直し、選択した要素の削除などの基本的な操作は、両方のエディターで共通です。 これらの操作の仕組みについて詳しくは、 Web エディターの機能について 」セクションに入力します。
レイアウトビューと作成者ビューのツールバーでは、次のマップ固有の操作も使用できます。
レイアウト表示 id205DEC0005Z_layout_view
マップを編集用に開くと、マップエディタの [ レイアウト ] ビューが開きます。[ レイアウト ] ビューでは、マップ階層がツリービューで表示され、マップ内のトピックを整理できます。
レイアウトビューでは、次のタスクを実行できます。
トピック参照の挿入 -
トピック検索ダイアログを表示します。 挿入するトピック/マップファイルに移動し、[ 選択 ] をクリックしてマップに追加します。
トピックグループの挿入 -
を挿入します。 topicgroup
要素を選択します。 トピックのグループ化について詳しくは、 topicgroup OASIS DITA 言語仕様のドキュメント。
キー定義を挿入 -
[ キー定義を挿入 ] ダイアログボックスが表示されます。 このダイアログボックスを使用して、マップで使用する任意のキー定義を定義します。
前挿入/後挿入 - /
[ 要素を挿入 ] ダイアログボックスを表示します。 マップに挿入する要素を選択します。 操作に応じて、新しい要素はマップ内の現在の要素の前または後に挿入されます。
前面に挿入 -
このアイコンは、編集用にブックマップを開くと表示されます。 目次、索引、表の一覧など、ブックの先頭にコンポーネントを挿入できます。
マターの挿入 -
このアイコンは、編集用にブックマップを開くと表示されます。 索引、用語集、図表一覧など、本の末尾にコンポーネントを挿入できます。
選択した項目を左右に移動 - /
左向き矢印をクリックして、トピックを階層の左側に移動します。 これは基本的に、階層の 1 つ上のレベルの各トピックを昇格します。 例えば、子トピックを選択しているときに左向き矢印をクリックすると、そのトピックの上のトピックの兄弟になります。 同様に、右向き矢印をクリックすると、トピックが右側に押され、その上のトピックの子になります。
- /
トピックを階層内で上下に移動するには、上矢印アイコンまたは下矢印アイコンをクリックします。
ロック/ロック解除 - /
マップファイルのロックを取得し、ロックを解除します。 マップファイルに未保存の変更がある場合は、ロックを解除する際に、マップファイルを保存するよう求めるプロンプトが表示されます。 変更内容は、現在のバージョンのマップファイルに保存されます。
結合 -
同じファイルや別のファイルの異なるバージョンからコンテンツを結合する方法について詳しくは、 結合 をクリックします。
バージョン履歴 -
アクティブなトピックで使用可能なバージョンとラベルを確認し、エディター自体から任意のバージョンに戻ります。
バージョンラベル -
バージョンラベル管理ダイアログを表示します。 ドロップダウンリストからバージョンを選択します。 選択したバージョンに適用するラベルを選択し、「 」をクリックします。 ラベルを追加 をクリックして追加します。
表示オプション -
[ 行番号の表示 ]、[ チェックボックスの表示 ]、[ ファイル名の表示 ] の各オプションを選択できるドロップダウンが表示されます。
- 行番号を表示
各トピックの行番号の表示/非表示を切り替えます。 行番号は、階層のレベルに応じて表示されます。
- チェックボックスを表示
各トピックのチェックボックスの表示/非表示を切り替えます。 このチェックボックスを使用すると、トピックを選択し、オプションメニューを使用して様々なタスクを実行できます。 詳しくは、 オプション メニュー。
- ファイル名を表示
トピックのタイトルのファイル名が表示されます。
条件フィルターに基づくトピックの表示 トピックに条件を適用している場合、トピックの右側にフィルターアイコンが表示されます。 フィルターアイコンの上にマウスポインターを置くと、適用された条件とその属性値が表示されます。
レイアウト表示のオプションメニュー
マップファイル内のトピックを整理する以外に、レイアウトビューの要素に使用できる [ オプション ] メニューを使用して、次の操作を実行することもできます。
-
追加:新しいトピックを追加するか、空の参照をマップエディタから追加するかを選択できます。
-
移動:トピックを階層内で上下左右に移動することもできます。トピックまたはマップをリポジトリパネルからマップエディターで開いたマップにドラッグ&ドロップすることもできます。
-
取り消し:レイアウトビューの最後の操作を取り消します。
-
やり直し:レイアウトビューで最後の操作をやり直します。
-
コピー:選択した参照をマップファイルからコピーします。
note note NOTE 複数の参照をコピーする場合は、チェックボックスを表示してから選択できます。 -
貼り付け:コピーした参照を、階層の現在の場所に貼り付けます。
-
削除:選択した参照をマップファイルから削除します。
note note NOTE 複数の参照を削除する場合は、チェックボックスを表示してから選択できます。
[ マップエディタ ] の右パネル
右側のパネルでは、[ マップエディタ ] のレイアウトビューに [ コンテンツプロパティ ] と [ マッププロパティ ] が表示されます。
コンテンツのプロパティ
コンテンツのプロパティパネルには、マップで現在選択されているトピックのタイプ、リンク URL および属性に関する情報が含まれます。 詳しくは、 コンテンツのプロパティ をクリックします。
-
その他の属性 管理者が属性のプロファイルを作成している場合は、設定された値と共にこれらの属性が取得されます。 コンテンツプロパティパネルを使用すると、これらの属性を選択し、トピック内の関連するコンテンツに割り当てることができます。 また、管理者が設定した属性を、 属性を表示 」タブをクリックします。 要素に対して定義された属性は、レイアウトビューとアウトラインビューに表示されます。 これにより、特定の属性が定義されているマップ内のすべてのトピックをすばやく確認できます。 例えば、「Android」と定義された platform 属性を持つすべてのトピックの場合、
img-md w-650 詳しくは、 属性を表示 内 エディター設定 機能の説明 左パネル 」セクションに入力します。
-
メタデータ メタデータを使用して、メタデータ情報を設定できます。 ナビゲーションタイトル、リンクテキスト、短い説明およびキーワードを定義できます。
標準のトピックの属性とメタデータについて詳しくは、 topicref OASIS DITA 言語仕様のドキュメント。
マップのプロパティ
マップの属性とメタデータ情報を設定できる [ マッププロパティ ] ダイアログボックスが表示されます。
作成者表示 id205DEC0005Z_author_view
The 作成者 表示を使用すると、Web エディターで DITA マップを編集できます。 これは、マップエディタの WYSIWYG 表示を示し、オーサー表示に表示されるアイコンの一部がレイアウト表示と同じです。 詳しくは、 レイアウト表示. さらに、次のアイコンを使用して、オーサー表示から関連タスクを実行できます。
前挿入/後挿入 - /
[ 要素を挿入 ] ダイアログボックスを表示します。 マップに挿入する要素を選択します。 操作に応じて、新しい要素はマップ内の現在の要素の前または後に挿入されます。
要素を挿入 -
[ 要素を挿入 ] ダイアログボックスを表示します。 挿入する要素を選択します。 キーボードを使用して要素のリストをスクロールし、 Enter キーを押して必要な要素を挿入できます。 または、要素を直接クリックして、マップに挿入できます。
関係テーブルの挿入 -
マップに関係テーブルを挿入します。 関係テーブルを使用する概念は、基本的なマップエディタの節で説明したものと同じです。 基本マップエディタでの関係テーブルの操作 を参照してください。
再利用可能なコンテンツを挿入 -
[ コンテンツを再利用 ] ダイアログボックスを表示します。 このダイアログを使用して、マップで再利用するコンテンツを挿入します。
ナビゲーションタイトル属性を更新 -
を同期します。 title
マップ内の参照ファイルの要素で、その値が @navtitle
属性。 マップには、トピック、参照、タスク、(sub) マップなど、様々なタイプの参照ファイルを追加できます。 これらのファイルの大部分は @navtitle
属性。 ファイルに @navtitle
属性の場合、 @navtitle
マップ内の同じファイルの属性が更新されます。 例えば、 @navtitle
属性が存在しない場合、 @navtitle
属性が参照ファイルに追加され、 title
が更新され、 @navtitle
.
@navtitle
属性を、マップに追加するすべての参照ファイルに追加します。 自動追加の設定の詳細 @navtitle
属性: デフォルトで@navtitle属性を含める 「 Adobe Experience Manager Guides のインストールと設定」をas a Cloud Serviceします。ナビゲーションタイトル属性を更新アイコンをクリックして、 title
要素のおよび @navtitle
属性の値。
タグ表示を切り替え -
XML タグの表示/非表示を切り替えます。 タグは、要素の境界を示す視覚的なキューとして機能します。 このモードでトピック/マップ参照を挿入する場合は、タグの前または後に目的のファイルをドラッグ&ドロップします。 タグ表示モードでは、横棒は表示されません。
変更の追跡を有効/無効にする -
[ 変更をトラック ] モードを有効にすると、マップファイルで行われたすべての更新を追跡できます。 トラックの変更を有効にした後、ドキュメント内のすべての挿入と削除が取り込まれます。 詳しくは、 変更の追跡を有効/無効にする をクリックします。
レビュータスクを作成 -
現在のトピックまたはマップファイルのレビュータスクは、Web エディターから直接作成できます。 レビュータスクを作成するファイルを開き、「レビュータスクを作成」をクリックしてレビュー作成プロセスを開始します。 指示に従って、 トピックまたはマップのレビュー を参照してください。
DITA マップを使用したトピックの編集 id17ACJ0F0FHS
個々のトピックを編集しても、作成者には完全なコンテキストは提供されません。 作成者は、トピックが DITA マップ内のどこに配置されているかに関する情報を持ちません。 このコンテキスト情報がないと、作成者はコンテンツを作成するのが少し難しくなります。
AEMガイドを使用すると、作成者は Web エディターで DITA マップを開き、マップ内でのトピックの配置を確認できます。 これにより、作成者は、トピックがマップ内のどこに配置されているかを把握し、より関連性の高いコンテンツを作成できます。 また、1 つのプロジェクトで複数の作成者が作業している場合は、マップで使用可能なすべてのトピックを把握し、必要な場所でコンテンツを再利用できます。
DITA マップを使用してトピックを編集するには、次の手順を実行します。
-
Assets UI で、編集するトピックを含む DITA マップに移動します。
-
DITA マップをクリックして、DITA マップコンソールで開きます。
-
を選択します。 トピック タブをクリックして、DITA マップで使用可能なトピックのリストを表示します。
note tip TIP 「トピック」タブには、従属ファイルと共にマップファイルをダウンロードするオプションが表示されます。 詳しくは、 DITA マップファイルの書き出し. -
メインツールバーで、 トピックを編集.
Web エディターで DITA マップが開きます。
note note NOTE また、Assets UI で DITA マップファイルを選択し、 トピックを編集 をクリックして、Web エディターを起動します。 img-md w-350 -
(オプション) マップからトピックを選択し、編集前にファイルをチェックアウトすることもできます。 ファイルをチェックアウトするには、左のウィンドウから 1 つ以上のファイルを選択し、 チェックアウト. チェックアウトしたファイルを選択し、 チェックアウトとロック解除のキャンセル アイコンをクリックします。
note important IMPORTANT 管理者が チェックアウトなしで編集を無効にする 」オプションを選択した場合は、編集する前にファイルをチェックアウトする必要があります。 ファイルをチェックアウトしない場合、ドキュメントは読み取り専用モードでエディターで開きます。 次のスクリーンショットは、チェックアウトとロック(A)、チェックアウトのキャンセルとロック解除(B)、新しいバージョンとロック解除(C)、編集(D)、プレビュー(E)、異なる DITA ファイルタイプ(F)、チェックアウトされたファイルのアイコンを示しています。
img-md w-550 -
任意のトピックリンクをクリックして、Web エディターで編集用に開きます。
エディターで複数のトピックを開くことができ、各トピックはエディターの新しいタブで開かれます。 DITA マップにサブマップが含まれている場合でも、サブマップのトピックも新しいタブで開いて編集できます。 サブマップの下のトピックを表示する場合は、サブマップをクリックして展開できます。
img-md w-800 マップファイルをクリックすると、Web ブラウザの新しいタブにマップが開きます。
-
トピックの編集が完了したら、次の操作を実行できます。
-
これらは個別に保存できます。 次をクリックした場合: 保存せずに閉じる トピックが開くと、保存されていないトピックを保存するよう求めるダイアログが表示されます。
img-md w-550 選択したすべてのトピックを保存するか、保存しないトピックを選択解除するかを選択できます。
-
トピックをチェックインするには、 新しいバージョンとして保存し、ロックを解除 」ボタンをクリックします。 トピックのリビジョンを保存すると、新しいリビジョンが作成され、ロックも解除されます。
-
管理者が閉じるときにファイルをチェックインするオプションを有効にしている場合は、チェックアウトしたファイルが閉じられるたびに、ファイルを保存するよう求めるプロンプトが表示されます。 このオプションを有効にすると、変更したファイルを含むエディタを閉じたときに、保存する必要のあるチェックアウト済みファイルの一覧が表示されます。 チェックアウトしたファイルには、ロックアイコンが表示されます。
img-md w-550 -
クリック 保存せずに閉じる ボタンを押すと、変更内容は保存されずにファイルが閉じます。
-
クリック 保存 ボタンは変更を保存しますが、ファイルはチェックインしません。
-
の選択 ファイルの確認 」オプションを選択し、 保存 ボタンはファイル\(別のバージョンを作成\)をチェックインし、ファイルも保存します。
-
-
マップのプレビュー
マップ内の各トピックファイルの位置を見ることができるのに加えて、1 回の連続フローでマップコンテンツを見ることが望ましい。 [ マップをプレビュー ] 機能を使用すると、1 回のクリックでマップファイルのコンテンツ全体を表示できます。 マップ全体が公開された後にどのように表示されるかを確認するために、マップファイルの出力を生成する必要はありません。 単にマップのプレビューにアクセスし、すべてのトピックとサブマップが本の形式でレンダリングされます。
マップのプレビューには、次の場所からアクセスできます。
-
Assets UI:Assets UI で、マップの場所に移動し、マップファイルを選択して、「 」を選択します。 マップをプレビュー 」をクリックします。 マップのプレビューが新しいタブに表示されます。 すべてのトピックの内容は、プレビューモードで表示できます。 この表示では、トピックを編集できません。
note note NOTE 次の場合、 マップをプレビュー 」オプションがメインツールバーに表示されない場合は、 その他 ツールバーメニュー。 -
高度なマップエディタ:詳細マップエディタで、プレビューアイコンをクリックして、現在のマップのプレビューを表示します。
img-md w-350 プレビューモードでは、次の追加のタスクを実行できます。
-
トピックを右クリックし、「 」を選択します。 編集 をクリックして、トピックを編集用に新しいタブで開きます。
note note NOTE 編集権限がない場合、トピックは読み取り専用モードで開きます。 -
マップツリー(左パネル)のトピックタイトルをクリックして、目的のトピックに移動します。
-
マッププレビューの現在のトピックも、マップツリーでハイライト表示されます。
-
親トピック: マップエディタを使用する