エディターの左パネル

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

{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>

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

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

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

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

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

   {width="350"}

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

   {width="350"}

   • ファイルタイプ：テキストを検索するファイルタイプとして、トピック および マップ を選択します

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

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

     • 過去 2 時間
     • 過去 1 週間
     • 過去 1 か月
     • 過去 1 年間

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

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

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

   {width="350"}

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

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

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

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

   {width="350"}

8. トピック内で現在ハイライト表示されている検索文字列を置き換えるには、「オカレンスを置換」を選択します。また、テキストの次のオカレンスまたは前のオカレンスに移動するには、上下の矢印を選択します。

   {width="350"}

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

   {width="350"}

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

10. 検索結果リストのファイルの上にマウスポインターを置くと、その右側に ファイル内のすべてを置換 アイコンが表示され、1 つのファイル内で該当する用語をすべて置換することができます。

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

    {width="350"}

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

    {width="350"}

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

{width="350"}

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

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

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

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

   {width="350"}

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

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

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

   {width="350"}

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

   {width="350"}

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

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

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

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

   {width="350"}

7. トピック内で現在ハイライト表示されている検索文字列を置き換えるには、「オカレンスを置換」を選択します。テキストの次のオカレンスまたは前のオカレンスに移動するには、上下の矢印を選択します

   {width="350"}

8. 「すべてを置換」を選択すると、1 つのファイル内で検索された語句をすべて、1 回の操作で置換語句に置き換えることができます。 選択したファイル内のすべてのオカレンスを置き換えると、通知が表示されます。

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

   {width="350"}

9. また、検索結果リストのファイルの上にマウスポインターを置くと、その右側に ファイル内のすべてを置換 アイコンが表示され、1 つのファイル内で該当する用語をすべて置換することができます。

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

   {width="350"}

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

{width="350"}

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

{width="650"}

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

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

   {width="300"}

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

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

   {width="300"}

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

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

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

     {width="300"}

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

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

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

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

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

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

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

   

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