エディターの左パネル

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

{width="300"}

作成するコレクションのタイトルと説明を入力します。 「パブリック」を選択すると、このユーザーは他のユーザーにも表示されます。

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

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

  {width="300"}

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

  

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

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

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

   {width="300"}

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

   • トピックのタイトル。

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

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

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

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

新しいDITA マップの作成手順：

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

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

   {width="300"}

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

   • マップのタイトル。
   • \（Optional\） マップのファイル名。 ファイル名は、マップタイトルに基づいて自動的に提案されます。 管理者が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
   親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_2.ditamapに存在する間、subject_scheme_map_1.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>

グローバル検索を実行してSource モードに置き換えるには、次の手順を実行します。

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

2. 「ソースモードを使用」オプションを有効にします。

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

   • パス：選択したパスを検索するには
   • Map: リポジトリまたはコレクションから特定のマップを検索するには
   • 現在のマップ：現在開いているマップを検索するには

   {width="350"}

4. 検索 フィールドに検索文字列を入力します。 結果を絞り込むには、検索フィールドの横にある​フィルター アイコンを選択し、次の目的のフィルターを選択します。

   {width="350"}

   • ファイルの種類: テキストを検索するファイルの種類、トピック​および​ マップ ​を選択します

   • ドキュメントの状態：使用可能なオプションからドキュメントの状態を選択できます。 表示されるドキュメント状態オプションは、フォルダープロファイルから派生しています。 これらのプロファイル全体のすべての可能なドキュメント状態を組み合わせたセットを表します。 デフォルトの状態には、「レビュー中」、「完了」、「ドラフト」、「承認済み」、「編集」、「レビュー済み」などがあります。

   • 最終変更日：変更日に基づいてコンテンツをフィルタリングします。 カレンダーから日付範囲を選択するか、次のいずれかの時間枠オプションを選択します。

     • 過去2時間で
     • 先週
     • 「先月」
     • 昨年

   • その他：次の項目を設定できます。

     • タグ: タグに基づいてコンテンツをフィルタリングします。
     • 大文字と小文字を区別する検索：指定した大文字と小文字が一致することを確認して検索を有効にします。
     • 他のユーザーによってロックされているファイルを一覧表示：現在、他のユーザーによってロックされているファイルを表示し、ロックが解除されるまで編集を禁止します。

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

   {width="350"}

6. 検索結果リストからファイルを選択します。 検索された用語がコンテンツでハイライト表示された状態で、ファイルがSource ビューで開きます。

7. 「次で置き換え」フィールドに、置き換え用の用語を入力します。 置換の適用方法をカスタマイズするには、フィールドの横にある​設定 アイコンをクリックし、使用可能なオプションから選択します。

   • ロック解除されたファイルの置換：ロック解除されたファイルでの置換を許可するには、このオプションを選択します。

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

   {width="350"}

8. トピック内で現在強調表示されている検索文字列を置き換えるには、出現を置換​を選択するか、テキストの次または前の出現に移動するには、上下の矢印を選択します。

   {width="350"}

9. 「すべてを置換」を選択すると、検索されたすべてのファイルで検索された文字列のすべての出現箇所を、指定された置換文字列に置き換えることができます。 すべてのオカレンスが置き換えられると、通知が表示されます。

   {width="350"}

   note
   NOTE
   すべてを置換 ボタンを有効にするには、フォルダープロファイル管理者またはシステム管理者が、Workspace設定​の​一般 タブで「すべてを置換を有効にする」オプションを選択する必要があります（オンプレミス​の場合は​ Settings ​と表示）。

10. 検索結果リストのファイルにカーソルを合わせると、その右側にある「ファイル内のすべてを置換」アイコンを表示できます。これにより、1つのファイル内のすべての用語を置換できます。

    note
    NOTE
    また、削除 アイコンを使用して、検索結果からファイルを削除することもできます。 削除したファイルはリストから削除され、検索した用語は置き換えられません。

    {width="350"}

11. 「すべての置換」操作が完了すると、ダウンロード可能なCSV レポートが生成され、実行されたすべての置換アクションのスナップショットが提供されます。 このレポートをダウンロードすると、正常に置換された回数や、各エラーの詳細、およびそれに対応する理由など、置換操作に関する詳細な情報を確認できます。 ファイルが別のユーザーによってロックされている、操作中にファイルに加えられた変更による検証エラー、その他の同様の問題など、特定の理由で操作が失敗する場合があります。

    {width="350"}

システム全体で一度に1回の置換操作のみを実行できます。操作が実行されるまでは、「処理中のすべての置換操作」ステータスが表示されます。 また、間にあるすべての置換の操作を中止することもできます。 操作を中止すると、その操作に関する通知がインボックスに届きます。

{width="350"}

Source モードを使用せずにグローバル検索と置換を実行するには、次の手順を実行します。

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

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

   • パス：選択したパスを検索するには
   • Map: リポジトリまたはコレクションから特定のマップを検索するには
   • 現在のマップ：現在開いているマップを検索するには

   {width="350"}

3. 検索 フィールドに検索文字列を入力します。 結果を絞り込むには、検索フィールドの横にある​フィルター アイコンを選択し、次の目的のフィルターを選択します。

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

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

   {width="350"}

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

   {width="350"}

5. 検索結果リストからファイルを選択します。 ファイルがコンテンツ編集領域の作成者ビューで開き、検索された用語がコンテンツでハイライト表示されます。

6. 「次で置き換え」フィールドに、置き換え用の用語を入力します。 置換の適用方法をカスタマイズするには、フィールドの横にある​設定 アイコンをクリックし、使用可能なオプションから選択します。

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

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

   {width="350"}

7. トピック内で現在強調表示されている検索文字列を置き換えるには、出現を置換​を選択するか、テキストの次または前の出現に移動するには、上下の矢印を選択します

   {width="350"}

8. 「すべてを置換」を選択すると、1回の移動で、1つのファイル内で検索された用語のすべての出現箇所が、置換用語に置き換わります。 選択したファイルのすべての出現を置き換えると、通知が表示されます。

   note
   NOTE
   次に​すべてを置換 アイコンを有効にするには、フォルダープロファイル管理者またはシステム管理者が、Workspace設定​の​一般 タブで「すべてを置換を有効にする」オプションを選択する必要があります（オンプレミス​の場合は​ Settings ​と表示）。 置換操作中にエラーが発生した場合、XML解析の問題やDITA関連のエラーが原因で、これらのファイルはスキップされます。

   {width="350"}

9. 検索結果リストのファイルにカーソルを合わせると、その右側にある「ファイル内のすべてを置換」アイコンを表示できます。これにより、1つのファイル内のすべての用語を置換できます。

   note
   NOTE
   また、削除 アイコンを使用して、検索結果からファイルを削除することもできます。 削除したファイルはリストから削除され、検索した用語は置き換えられません。

   {width="350"}

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

{width="350"}

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

{width="650"}

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

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

   {width="300"}

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

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

   {width="300"}

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

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

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

     {width="300"}

     フィルター ダイアログには、トグルを使用して有効または無効にできる次のオプションも含まれています。

     • 自分が開始したタスク：有効にすると、開始したタスクのみが表示されます。
     • アクティブなタスクのみを表示：有効にすると、プロジェクトリストがフィルター処理され、現在アクティブなタスクのみが表示されます。

     デフォルトでは、両方のオプションは無効になっています。 また、ページを更新した後でも、選択した切り替え状態は維持されます。

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

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

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

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

   

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