エディターの左パネル

新しいコレクションを作成するには、コレクションパネルの横にある+ アイコンを選択すると 新規コレクション ダイアログボックスが表示されます。

{width="300"}

作成するコレクションのタイトルと説明を入力します。 「公開」を選択すると、このお気に入りが他のユーザーにも表示されます。

コレクションにファイルを追加するには、次のいずれかの方法を使用します。

• リポジトリ表示で必要なファイルまたはフォルダーに移動し、オプション アイコンを選択してコンテキストメニューを開き、追加先/コレクション を選択します。 コレクションに追加 ダイアログボックスで、ファイルやフォルダーを既存のお気に入りに追加するか、新しいお気に入りに作成するかを選択できます。

  {width="300"}

• エディターでファイルのタブを右クリックして、コンテキストメニューを開きます。 追加先/コレクション を選択して、ファイルをお気に入りリストに追加します。

  

新しいトピックを作成する手順：

1. 新規/トピック を選択します。

2. 新規トピック ダイアログボックスが表示されます。

   {width="300"}

3. 新規トピック ダイアログボックスで、次の詳細を入力します。

   • トピックのタイトル。

   • \（オプション\）* トピックのファイル名。 ファイル名は、トピックのタイトルに基づいて自動的に提示されます。 管理者が UUID 設定に基づく自動ファイル名を有効にしている場合、「名前」フィールドは表示されません。

   • トピックの基になるテンプレート。 例えば、標準の設定の場合は、「空白」、「概念」、「DITAVAL」、「参照」、「タスク」、「トピック」、「マークダウン」、「用語集」、「トラブルシューティング」の各テンプレートから選択できます。 フォルダーにフォルダープロファイルが設定されている場合は、フォルダープロファイルで設定されているトピックテンプレートのみが表示されます。

   • トピック ファイルを保存するパス。 デフォルトでは、リポジトリで現在選択されているフォルダーのパスが「パス」フィールドに表示されます。

4. 「作成」を選択します。指定したパスにトピックが作成されます。 また、エディターでトピックが開いて編集できます。

新規 DITA マップを作成する手順：

1. 新規 > DITA マップ を選択します。

2. 新規マップ ダイアログボックスが表示されます。

   {width="300"}

3. 新しいマップ ダイアログボックスで、次の詳細を指定します。

   • マップのタイトル。
   • \（オプション\） マップのファイル名。 ファイル名は、マップのタイトルに基づいて自動的に提案されます。 管理者が UUID 設定に基づく自動ファイル名を有効にしている場合、「名前」フィールドは表示されません。
   • マップのベースとなるテンプレート。 たとえば、既製の設定の場合は、ブックマップまたは DITA マップのテンプレートから選択できます。
   • マップ ファイルを保存するパス。 デフォルトでは、リポジトリで現在選択されているフォルダーのパスが「パス」フィールドに表示されます。

4. 「作成」を選択します。マップが作成され、「パス」フィールドで指定したフォルダー内に追加されます。 また、マップはマップ ビューで開きます。 マップ エディタでマップ ファイルを開き、トピックを追加できます。 マップ ファイルにトピックを追加する方法の詳細は、 マップを作成を参照してください。 または、「マップコンソールで開く」を選択して、マップをマップコンソールで開きます。

新しいフォルダーを作成する手順：

1. 新規/フォルダー を選択します。

2. 新規フォルダー ダイアログボックスが表示されます。

   {width="300"}

3. 新規フォルダー ダイアログボックスで、次の詳細を入力します。

   • フォルダー名に自動変換される、フォルダーのタイトル。
   • フォルダーを保存するパス。 デフォルトでは、リポジトリで現在選択されているフォルダーのパスが「パス」フィールドに表示されます。

4. 「作成」を選択します。フォルダーが作成され、「フォルダーを作成」オプションを実行したフォルダー内に追加されます。

次の手順を実行してテキスト用語を検索し、用語集の略語に置き換えます。

1. テキストまたは用語を検索して変換する DITA トピックまたはマップを開きます。
2. 用語集パネルを選択して、ルートマップに存在する用語集の用語を表示します。 これらの用語をドラッグ&ドロップして、開いているトピックに追加できます。
3. 用語集パネルの ホットスポット ツール\（ \）を選択して、特定のテキスト用語を検索し、リンクされた用語集の略語に変換します。 また、逆に、用語集の略語を検索したり、テキスト用語に変換したりすることもできます。

1. 選択したツールでサブジェクト スキーム ファイルを作成します。 次の XML コードは、platform 属性の値をバインドする件名スキームを作成します。

   code language-xml

   <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "subjectScheme.dtd"> <subjectScheme id="GUID-4f942f63-9a20-4355-999f-eab7c6273270"> <title>rw</title> <!-- Define new OS values that are merged with those in the unixOS scheme --> <subjectdef keys="os"> <subjectdef keys="linux"> </subjectdef> <subjectdef keys="mswin"> </subjectdef> <subjectdef keys="zos"> </subjectdef> </subjectdef> <!-- Define application values --> <subjectdef keys="app" navtitle="Applications"> <subjectdef keys="apacheserv"> </subjectdef> <subjectdef keys="mysql"> </subjectdef> </subjectdef> <!-- Define an enumeration of the platform attribute, equal to each value in the OS subject. This makes the following values valid for the platform attribute: linux, mswin, zos --> <enumerationdef> <attributedef name="platform"> </attributedef> <subjectdef keyref="os"> </subjectdef> </enumerationdef> <!-- Define an enumeration of the otherprops attribute, equal to each value in the application subjects. This makes the following values valid for the otherprops attribute: apacheserv, mysql --> <enumerationdef> <attributedef name="otherprops"> </attributedef> <subjectdef keyref="app"> </subjectdef> </enumerationdef> </subjectScheme>

   {width="300"}

2. ファイルを.ditamap 拡張子で保存して、DAM の任意のフォルダーにアップロードします。

   note note
   NOTE
   親 DITA マップにサブジェクトスキーマファイルへの参照を追加できます。

   {width="550"}

3. ユーザー環境設定 で親マップをルートマップとして設定します。 このマップをルート マップとして追加すると、サブジェクト スキームが [ サブジェクト スキーム ] パネルに表示されます。

   {width="650"}

4. エディタで、サブジェクト スキーム定義を使用するファイルを開きます。

5. 目的の件名スキームをコンテンツにドラッグ&ドロップするだけで、件名スキームをコンテンツに適用できます。 次に、定義されたカラーでコンテンツがハイライト表示されます。

Experience Manager Guidesは、同じマップに存在する定義済みリストと件名定義を処理する以外に、2 つの異なるマップで定義済みリストと件名定義を定義する機能も提供します。 マップ内に 1 つ以上のサブジェクト定義を定義し、別のマップ内に定義済みリスト定義を定義してから、マップ参照を追加できます。 例えば、次の XML コードは、サブジェクト定義と列挙定義を 2 つの異なるマップに作成します。

件名の定義は、subject_scheme_map_1.ditamap で定義されます

  <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "../dtd/libs/fmdita/dita_resources/DITA-1.3/dtd/subjectScheme/dtd/subjectScheme.dtd">
    <subjectScheme id="subject-scheme.ditamap_f0bfda58-377b-446f-bf49-e31bc87792b3">

    <title>subject_scheme_map_1</title>

    <subjectdef keys="os" navtitle="Operating system">
        <subjectdef keys="linux" navtitle="Linux">
        <subjectdef keys="redhat" navtitle="RedHat Linux">
        </subjectdef>
        <subjectdef keys="suse" navtitle="SuSE Linux">
        </subjectdef>
        </subjectdef>
        <subjectdef keys="windows" navtitle="Windows">
        </subjectdef>
        <subjectdef keys="zos" navtitle="z/OS">
        </subjectdef>
        </subjectdef>
        <subjectdef keys="deliveryTargetValues">
        <subjectdef keys="print">
        </subjectdef>
        <subjectdef keys="online">
        </subjectdef>
    </subjectdef>
    <subjectdef keys="mobile" navtitle="Mobile">
        <subjectdef keys="android" navtitle="Android">
        </subjectdef>
        <subjectdef keys="ios" navtitle="iOS">
    </subjectdef>
    </subjectdef>
    <subjectdef keys="cloud" navtitle="Cloud">
        <subjectdef keys="aws" navtitle="Amazon Web Services">
        </subjectdef>
        <subjectdef keys="azure" navtitle="Microsoft Azure">
        </subjectdef>
        <subjectdef keys="gcp" navtitle="Google Cloud Platform">
        </subjectdef>
    </subjectdef>
    </subjectScheme>

定義済みリストの定義は、 subject_scheme_map_2.ditamap.

    ?xml version="1.0" encoding="UTF-8"?>
        <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "../dtd/libs/fmdita/dita_resources/DITA-1.3/dtd/subjectScheme/dtd/subjectScheme.dtd">
        <subjectScheme id="subject-scheme.ditamap_17c433d9-0558-44d4-826e-3a3373a4c5ae">
        <title>subject_scheme_map_2</title>
        <mapref format="ditamap" href="subject_scheme_map_1.ditamap" type="subjectScheme">
        </mapref>
        <enumerationdef>
        <attributedef name="platform">
        </attributedef>
        <subjectdef keyref="mobile">
        </subjectdef>
        <subjectdef keyref="cloud">
        </subjectdef>
        </enumerationdef>
        </subjectScheme>

ここでは、サブジェクト定義は subject_scheme_map_1.ditamap で定義され、定義済みリスト定義は subject_scheme_map_2.ditamap で存在します。 subject_scheme_map_1.ditamap への参照も subject_scheme_map_2.ditamap に追加されます。

件名 – 定義済みリストの参照は、次の優先順位で解決されます。

1. 同じマップ
2. 参照マップ

同じマップと参照先のマップで列挙が見つからない場合、参照は解決されません。

また、トピック内の一部の要素に条件を制限することもできます。 <elementdef> タグを使用して要素を定義し、<attributedef> タグを使用して要素に適用できる条件を定義します。 <elementdef> タグを追加しない場合は、条件をすべての要素に適用できます。
例えば、次の列挙を使用して、@platform 属性を <shortdesc> 要素に制限します。 その他の条件は、すべての要素に対して表示されます。

<enumerationdef>
    <elementdef name="shortdesc">
    </elementdef>
    <attributedef name="platform">
    </attributedef>
    <subjectdef keyref="deliveryTargetValues">
    </subjectdef>
    <subjectdef keyref="os">
    </subjectdef>
  </enumerationdef>

グローバル検索と置換を実行するには、次の手順に従います。

1. グローバル 検索と置換 パネルを開きます。

2. 検索先 ドロップダウンを選択し、次のいずれかのオプションを選択して検索を実行します。

   • 現在のマップ：現在開いているマップを検索します。

     note note
     NOTE
     このオプションは、編集用にマップを開いている場合に表示されます。

   • パス：選択したパスを検索します。

   • マップを選択：選択したマップを検索します。

3. オプション ドロップダウンを使用して、次のいずれかのオプションを選択できます。

   • 置換前にファイルをロック：検索語句を置換する前にファイルを自動的にロックする場合は、このオプションを選択します。 この設定は、管理者が編集前にファイルをロックする設定を有効にした場合により関連性が高くなります。 バックエンド設定を有効にした場合、このオプションを選択する必要があります。 これにより、変更を加える前にすべてのファイルをロックするように求めるファイルロックダイアログが表示されなくなります。 このオプションを選択しない場合、ファイルを編集用に開く前にプロンプトが表示されます。

   • 単語全体のみ：検索文字列全体を検索する場合は、このオプションを選択します。 例えば、検索文字列に「over」と入力すると、over や overview などの単語を含んだすべてのファイルが検索結果に返されます。 入力したとおりの語句を返すように検索を制限する場合は、このオプションを選択します。

   • 置換後に新しいバージョンを作成：テキストを置き換えることを選択したトピックの新しいバージョンを作成する場合は、このオプションを選択します。 また、更新された各ファイルに追加されるバージョンコメントを指定することもできます。

     このオプションを選択しない場合、変更内容はトピックの現在のバージョンに保存され、新しいバージョンは作成されません。

   • 間接参照を含める：間接参照の文字列を DITA マップ内でも検索する場合は、このオプションを選択します。 デフォルトでは、これは無効になっているので、直接参照に対してのみ検索が実行されます。

4. 検索する検索語句またはテキストを入力します。

5. 検索語を置き換えるテキストを入力します。

6. Enter キーを押すか、検索 アイコン \（ \）を選択して検索を実行します。

7. 検索結果リストからファイルを選択します。 コンテンツ編集領域にファイルが開き、検索された語句がコンテンツ内でハイライト表示されます。

8. トピック内で現在ハイライト表示されている検索語を置き換えるには、「1 つのオカレンスを置換\（ \）」を選択します。テキストの次のオカレンスまたは前のオカレンスに移動するには、「次の一致 」または「前の一致 」を選択します。

9. すべて置換\（ \）を選択すると、1 つのファイル内の検索された語句をすべて、1 回のクリックで置換語句に置き換えることができます。 選択したファイル内のすべてのオカレンスを置き換えると、通知が表示されます。

すべて置換 アイコンを有効にするには、システム管理者が 設定 の ​ ​一般 タブにある「すべて置換を有効にする オプションを選択する必要があります。

<div class="extension note">
<div>NOTE</div>
<div>
<p>検索結果リストのファイルの上にマウスポインターを置くと、その右側に「ファイル内のすべてを置換」アイコンが表示されます。 また、「ファイルを無視」アイコンをクリックして、検索結果からファイルを削除します。 無視したファイルはリストから削除され、検索された語句は置き換えられません。</p>
</div>
</div>

システム全体で一度に実行できるのは「すべてを置換」操作 1 つのみです。操作が実行されるまで、「すべてを置換中」ステータスが表示されます。 また、の間にすべてを置換の操作を中止したり、ログレポートを表示したりできます。 操作を中止すると、その操作に関する通知がインボックスに届きます。 選択したファイル内のすべてのオカレンスを置き換えると、成功通知が表示されます。

{width="300"}

また、マップの オプション メニューから マップ内を検索 オプションを使用して、マップ内のテキストを検索および置換することもできます。 このオプションは、リポジトリパネルまたはマップビューで開かれたマップに対して表示されます。

{width="550"}

プロジェクトに存在するアクティブなレビュータスクのレビューコメントを表示するには、次の手順を実行します。

1. 左パネルで「レビュー」を選択します。 レビュー パネルが開きます。 すべてのレビュープロジェクトと、自分が属しているレビュープロジェクト内のアクティブなレビュータスクが表示されます。

   {width="300"}

2. レビュープロジェクトを選択し、リストからレビュータスクを選択して開きます。

3. プロジェクトダッシュボードを開く アイコンを選択して、プロジェクトコンソール でプロジェクトを開くことができます。

   {width="300"}

4. 次の方法でプロジェクトをフィルタリングすることもできます。

   • プロジェクトのタイトルで検索する検索語句またはテキストを入力します。 次に、Enter キーを押して検索を実行します。 例えば、タイトルに「space」という単語を含むすべてのプロジェクトを検索できます。

   • 「 」を選択して フィルター ダイアログボックスを開きます。 すべてのプロジェクトを選択することも、特定のプロジェクトのみを選択することもできます。 選択したプロジェクトが レビュー パネルに表示されます。

     {width="300"}

     自分が開始したタスク オプションを有効にして、開始したタスクのみを表示します。 このオプションの切り替え状態は、ページを更新した後も維持されます。 アクティブなタスクのみを表示 オプションを有効にして、プロジェクトリストをフィルタリングし、現在アクティブなタスクを表示します。

5. デフォルトでは、レビュープロジェクトには、コメントが関連付けられているトピックのフラットリストが表示されます。 左側のパネルから必要なフィルターを適用し、そこに含まれるレビューコメントに基づいてトピックをフィルタリングします。

   • すべてのトピックを表示：プロジェクトに存在するすべてのトピックを一覧表示します。
   • コメント付きのトピックを表示：レビューのコメントが含まれているトピックのみをリストします。

6. 検索する検索語句やテキストをトピックのタイトルまたはファイルパスに入力することもできます。 タイトルまたはファイルパスに語句を含むトピックが一覧表示されます。

7. 任意のトピックをダブルクリックして、オーサービューで開きます。 コメントは、コメント パネルに表示されます。

   

   note note
   NOTE
   レビュー パネルと コメント パネルは常に同期されています。 コメントパネルでは、レビュー画面にロードされたレビュータスクに基づいてコメントがロードされます。 アクティブなレビュータスクと共に、レビューパネルの左側のパネルで、閉じられたレビュータスクを表示できます。 また、クローズドレビュータスクの場合、レビューのコメントを右側のコメントパネルで表示できますが、「コメントをインポート 」ボタンと バージョンを元に戻す ボタンは無効 なります。 コメントへの対処方法の詳細については、 コメントへの対処を参照してください。