DITA以外のコンテンツの移行 id181AH0R02HT

この節では、DITA以外のドキュメントをDITA形式に移行する移行プロセスについて説明します。 AEM Guidesには、次のソースからの移行が用意されています。

Microsoft Word ドキュメントの移行 id1949B040Z5Z

AEM Guidesを使用すると、既存のWord ドキュメント \(.docx\)をDITA トピックタイプドキュメントに移行できます。 入力フォルダーと出力フォルダーの場所を他のパラメーターと共に指定する必要があり、ドキュメントがDITA ドキュメントに変換されます。 内容によっては、.dita ファイルと.ditamap ファイルがあります。

Word文書を正常に変換するには、文書を適切に構造化する必要があります。 例えば、文書にはタイトルを付け、その後に見出し1、見出し2などを付けます。 各見出しには、ある程度の内容を含める必要があります。 ドキュメントの構造が適切でない場合、プロセスが期待どおりに動作しない可能性があります。

デフォルトでは、AEM GuidesはWord-DITA \(Word2DITA\)変換フレームワーク ​を使用します。 この変換は、​ スタイルからタグへのマッピング ​設定ファイルによって異なります。 Word2DITA変換を正常に使用するには、変換のためにWord文書を準備するための次のガイドラインを考慮する必要があります。

NOTE
デフォルトのスタイルからタグへのマッピング設定ファイルで変更を行った場合は、更新したスタイルマッピングを確認するガイドラインを更新して使用する必要があります。
  • ドキュメントがタイトルで始まっていることを確認します。このタイトルはDITA マップタイトルにマッピングされます。 また、タイトルの後には、通常のコンテンツを使用する必要があります。

  • タイトルの後には、「見出し1」、「見出し2」などがあります。 各見出しには何らかのコンテンツが必要です。 見出しは、新しいコンセプトタイプのトピックに変換されます。 生成されたトピックの階層は、文書内の見出しレベルに従って表示されます。例えば、見出し1は見出し2の前に表示され、見出し2は見出し3のコンテンツの前に表示されます。

  • 文書には、少なくとも1つの見出しタイプのコンテンツが必要です。

  • グループ化された画像がないことを確認します。 ドキュメント内の画像をグループ化している場合は、そのような画像をすべてグループ化を解除します。

  • すべてのヘッダーとフッターを削除します。

  • 太字、斜体、下線などのインラインスタイルは、bi、およびu要素に変換されます。

  • 順序付けされたリストと順序付けされていないリストはすべて、olおよびul要素に変換されます。 これは、ネストされたリスト、テーブル内のリスト、メモ、または脚注にも適用されます。

  • すべてのハイパーリンクがxrefに変換されます。

  • 変換されたファイルのファイル名は、見出しテキストの後にファイル番号が付いたものに基づいています。 ファイル番号は、文書内の見出しテキストの位置に基づく連続番号です。 例えば、見出しテキストが「サンプル見出し」で、文書の見出しが10番目の場合、このトピックの結果のファイル名はSample_Heading_10.ditaと似ています。

既存のWord ドキュメントをDITA トピックタイプのドキュメントに変換

次のタブには、既存のWord ドキュメントをExperience Manager Guidesの設定に基づいてDITA トピックタイプドキュメントに変換する手順が示されています。Cloud Serviceまたはオンプレミス。

Cloud Service

既存のWord ドキュメントをDITA トピックタイプドキュメントに変換するには、次の手順を実行します。

  1. パッケージマネージャーを使用して、/libs/fmdita/config/w2d_io.xml ファイルをダウンロードします。

  2. ダウンロードしたw2d_io.xml ファイルをカスタマイズします。

  3. Cloud ManagerのGit リポジトリの次の場所にファイルを追加します。

    /apps/fmdita/config/w2d_io.xml

    w2d_io.xml ファイルには、次の設定可能なパラメーターが含まれています。

    • inputDir要素で、ソース Word ドキュメントが使用可能な入力フォルダーの場所を指定します。 例えば、Word文書がprojects フォルダーのwordtoditaという名前のフォルダーに保存されている場合、場所を/content/dam/projects/wordtodita/と指定します

    • outputDir要素で、出力フォルダーの場所を指定するか、デフォルトの出力場所を保持して、変換されたDITA ドキュメントを保存します。 指定した出力フォルダーがDAMに存在しない場合、変換ワークフローによって出力フォルダーが作成されます。

    • createRev要素について、変換されたDITA トピックの新しいバージョンを\(true\)作成するか、\(false\)作成しないかを指定します。

    • s2tMap要素で、Word文書スタイルからDITA要素へのマッピングを含むマップファイルの場所を指定します。 デフォルトのマッピングは、次の場所にあるファイルに保存されます。

      code language-none
      /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml
      
      note
      NOTE
      word-builtin-styles-style2tagmap.xml ファイルの構造とカスタマイズ方法について詳しくは、DITA For Publishers ユーザーガイド​の「​ タグマッピングのスタイル ​」を参照してください。
    • props2Propagate エレメントで、DITA マップに渡すプロパティを指定します。 このプロパティは、ドキュメントメタデータから変換されたDITA アセットにdc:title,dc:subject,dam:keywords,dam:categoryなどのデフォルトメタデータを渡すために必要です。

  4. Cloud Manager パイプラインを実行して、更新された設定をデプロイします。

  5. w2d_io.xml ファイルで必要なパラメーターを設定したら、AEMにログインし、Assets UIを開きます。

  6. 入力フォルダーの場所\(wordtodita\)に移動します。

  7. ソース Word ドキュメントをこのフォルダーにアップロードします。 DAMでのコンテンツのアップロードについて詳しくは、既存のDITA コンテンツのアップロード ​を参照してください。

config /config ブロックを使用すると、変換する設定の1つまたは複数のブロックを定義できます。 変換ワークフローが実行され、DITA トピック形式の最終出力がoutputDir要素で指定された場所に保存されます。

既存ユーザーのカスタマイズ更新

AEM Guides as a Cloud Serviceの既存のユーザーで、2021年8月リリースから2022年1月以降のバージョンにアップグレードする場合は、ファイルの移動数が少なくなるため、特定のプロパティを更新します。

note
NOTE
このアップデートは、既にMicrosoft WordからDITAへの変換ワークフローを使用している場合にのみ適用されます。
  • ファイルパス:/apps/fmdita/config/w2d_io.xml
  • <s2tMap>の値を/apps/dxml/word2dita/word-builtin-styles-style2tagmap.xmlから/libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xmlに変更します
  • Cloud Manager Git リポジトリで必要な変更を行います。クラウドサービスでは、/apps内のすべてのファイルがCloud Manager Gitを介してオーバーレイされます。
オンプレミス

既存のWord ドキュメントをDITA トピックタイプドキュメントに変換するには、次の手順を実行します。

  1. AEMにログインし、CRXDE Lite モードを開きます。

  2. 次の場所にあるデフォルトの設定ファイルに移動します。

    /libs/fmdita/config/w2d_io.xml

  3. apps ノード内にconfig フォルダーのオーバーレイノードを作成します。

  4. apps ノードで使用可能な設定ファイルに移動します。

    /apps/fmdita/config/w2d_io.xml

    w2d_io.xml ファイルには、次の設定可能なパラメーターが含まれています。

    • inputDir要素で、ソース Word ドキュメントが使用可能な入力フォルダーの場所を指定します。 例えば、Word文書がprojects フォルダーのwordtoditaという名前のフォルダーに保存されている場合、場所を/content/dam/projects/wordtodita/と指定します

    • outputDir要素で、出力フォルダーの場所を指定するか、デフォルトの出力場所を保持して、変換されたDITA ドキュメントを保存します。 指定した出力フォルダーがDAMに存在しない場合、変換ワークフローによって出力フォルダーが作成されます。

    • createRev要素について、変換されたDITA トピックの新しいバージョンを\(true\)作成するか、\(false\)作成しないかを指定します。

    • s2tMap要素で、Word文書スタイルからDITA要素へのマッピングを含むマップファイルの場所を指定します。 デフォルトのマッピングは、次の場所にあるファイルに保存されます。

      code language-xml
      /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml
      
      note
      NOTE
      word-builtin-styles-style2tagmap.xml ファイルの構造とカスタマイズ方法について詳しくは、DITA For Publishers ユーザーガイド​の「​ タグマッピングのスタイル ​」を参照してください。
    • props2Propagate エレメントで、DITA マップに渡すプロパティを指定します。 このプロパティは、ドキュメントメタデータから変換されたDITA アセットにdc:title,dc:subject,dam:keywords,dam:categoryなどのデフォルトメタデータを渡すために必要です。

  5. w2d_io.xml ファイルを保存します。

  6. w2d_io.xml ファイルで必要なパラメーターを設定したら、AEMにログインし、Assets UIを開きます。

  7. 入力フォルダーの場所\(wordtodita\)に移動します。

  8. ソース Word ドキュメントをこのフォルダーにアップロードします。 DAMでのコンテンツのアップロードについて詳しくは、既存のDITA コンテンツのアップロード ​を参照してください。

config /config ブロックを使用すると、変換する設定の1つまたは複数のブロックを定義できます。 変換ワークフローが実行され、DITA トピック形式の最終出力がoutputDir要素で指定された場所に保存されます。

Adobe InDesign ドキュメントの移行 id195AD0B0K5Z

AEM Guidesでは、InDesign ドキュメントを変換できます。 FrameMakerと同様に、InDesignでは非構造化ドキュメントや構造化ドキュメントも作成できます。 非構造化文書では、段落スタイルと文字スタイルを使用してコンテンツを書式設定します。 構造化文書では、要素とそれに対応する属性を使用します。

変換プロセスでは、段落スタイルおよび文字スタイル形式を関連するDITA要素にマッピングする必要があります。 同様に、構造化文書の場合、マッピングファイルには、InDesign要素とDITA要素および属性を持つ属性の1対1のマッピングが含まれます。

コンバージョンプロセスでは、バックエンドで次のアクションを実行します。

  • InDesign Markup Language \(IDML\) ファイルが作業用ディレクトリに展開されます。
  • designmap.xml ファイルが読み込まれ、個々のInDesign ストーリーが見つかります。
  • すべてのストーリーは単一のXML インスタンスにマージされ、「空」のストーリーは破棄されます。
  • 埋め込まれたすべてのグラフィックが書き出されます。
  • 表やグラフィックなどの標準構造をDITA形式に事前に変換します。
  • マッピングファイルに基づいて、最終出力にマッピングするスタイルまたは構造。
  • 個々のDITA トピックとDITA マップファイルの作成と検証。
  • 一時ファイルの削除。

一般に、変換プロセスでは、変換に向けてInDesign ファイルを準備し、InDesignからDITAへの移行用のマッピングファイルを準備する必要があります。変換プロセスを実行するには、指定した手順に従う必要があります。

既存のInDesign ドキュメントをDITA トピックタイプドキュメントに変換するには、次の手順を実行します。

  1. AEMにログインし、CRXDE Lite モードを開きます。

  2. 次の場所にあるデフォルトの設定ファイルに移動します。

    /libs/fmdita/config/idml2dita_io.xml

  3. 必要に応じてカスタム設定を作成するには、apps ノード内にconfig フォルダーのオーバーレイノードを作成します。

  4. 次のファイルまたはフォルダーをlibs フォルダーからapps フォルダーにコピーします。

    • /fmdita/config/idml2dita_io.xml
    • /fmdita/idml2dita/config
    • /fmdita/idml2dita/xsl
  5. apps ノードで使用可能な設定ファイルに移動します。

    /apps/fmdita/config/idml2dita_io.xml

  6. idml2dita_io.xml ファイル内のidml12dita フォルダーに存在する設定のマッピングを追加します。

  7. idml2dita_io.xml ファイルに次のプロパティを追加します。

    code language-none
    <entry key="idml2DitaConfig">/apps/fmdita/idml2dita/config</entry>
    
    <entry key="idml2DitaXsl">/apps/fmdita/idml2dita/xsl</entry>
    
  8. apps ノード内にconfig フォルダーのオーバーレイノードを作成します。

    idml2dita_io.xml ファイルで次のパラメーターを設定します。

    • inputDir要素で、ソース InDesign ドキュメントが使用可能な入力フォルダーの場所を指定します。 例えば、InDesign ドキュメントがprojects フォルダーのindesigntoditaという名前のフォルダーに保存されている場合、場所を/content/dam/idmlfiles/indesigntodita/と指定します

    • outputDir要素で、出力フォルダーの場所を指定するか、デフォルトの出力場所を保持して、変換されたDITA ドキュメントを保存します。 指定した出力フォルダーがDAMに存在しない場合、変換ワークフローによって出力フォルダーが作成されます。

    • mapStyle エレメントで、InDesign ドキュメントスタイルとDITA エレメントのマッピングを含むマップファイルの場所を指定します。 デフォルトのマッピングは、次の場所にあるファイルに保存されます。

      code language-none
      /stmap.adobeidml.xml
      
      note
      NOTE
      stmap.adobeidml.xml ファイルの構造とカスタマイズ方法について詳しくは、付録を参照してください。
  9. idml2dita_io.xml ファイルを保存します。

  10. idml2dita_io.xml ファイルで必要なパラメーターを設定したら、AEMにログインし、Assets UIを開きます。

  11. 入力フォルダーの場所\(indesigntodita\)に移動します。

  12. ソースのInDesign ドキュメントをこのフォルダーにアップロードします。 DAMでのコンテンツのアップロードについて詳しくは、既存のDITA コンテンツのアップロード ​を参照してください。

XHTML ドキュメントの移行 id1949B04L0Y4

AEM Guidesを使用すると、既存のXHTML ドキュメントをDITA トピックタイプドキュメントに変換できます。 入力フォルダーと出力フォルダーの場所を他のパラメーターと共に指定し、ドキュメントをDITA形式に変換する必要があります。 構造化HTML ドキュメントを変換するには、次の2つの方法があります。

  • すべてのドキュメントを入力フォルダーにアップロードするか、または
  • メディアファイルと一緒にすべてのドキュメントのZIP ファイルを作成し、入力フォルダーにアップロードします。 この方法は、通常、互いにリンクされ、目次\(index.html\)がある一連のHTML ファイルに使用されます。 index.html ファイルには、セット内のすべてのHTML ファイルへのリンクが含まれています。

すべてのファイルを個別にアップロードする場合でも、ZIPにバンドルする場合でも、変換プロセスでは、HTML ファイルと結果のDITA ファイルの間に1対1のマッピングが作成されます。 これは基本的に、入力フォルダー内の.html ファイルごとに.dita ファイルが作成されていることを意味します。

ドキュメントをZIP ファイルにアップロードするには、次の点を考慮する必要があります。

  • 参照されているすべてのトピックは、ZIP ファイル内に配置する必要があります。

  • 参照されているすべてのメディアファイルは、相対リンクを使用してトピックファイル内で参照する必要があります。

  • index.html ファイルを作成し、目次に追加するトピックへのリンクを追加します。 このindex.html ファイルは、DITA マップファイルの作成に使用されます。 index.html ファイルでは、次のコードサンプルに示すように、ネストされたトピックのリストを作成することもできます。

    code language-xml
    <?xml version="1.0" encoding="UTF-8"?>
    <html
    xmlns="http://www.w3.org/1999/xhtml">
        <head>
            <title>Sample Index File</title>
        </head>
        <body>
            <h1>Sample Index</h1>
            <div class="content">
                <ul class="book">
                    <li class="topicref">
                        <a href="Topic1.html">Topic 1</a>
                        <ul class="book">
                            <li class="topicref">
                                <a href="Topic1-1.html">Topic 1.1</a>
                            </li>
                            <li class="topicref">
                                <a href="Topic1-2.html">Topic 1.2</a>
                            </li>
                        </ul>
                    </li>
                    <li class="topicref">
                        <a href="Topic2.html">Topic 2</a>
                    </li>
                </ul>
            </div>
        </body>
    </html>
    

    すべてのul タグには、class属性がbookに設定されている必要があります。 同様に、すべてのli タグのclasstopicrefに設定する必要があります。

  • インラインスタイルを使用する場合は、インラインスタイルをXHTML ファイル内のCSS ベースのスタイルクラスに変換します。 次に、スタイル属性マッピングを使用して、これらのクラスベースのスタイルを、変換されたDITA ファイルのDITA outputclass属性に変換します。

    これらのDITA ファイルからHTMLまたはAEM サイト出力を生成する際に、outputclass属性を使用して、生成されたHTMLまたはAEM サイトにスタイルクラスを適用し、ソースのHTML コンテンツに一致させることができます。

ZIP ファイルを作成する際の考慮事項とは別に、XHTML ドキュメントも適切に構造化する必要があります。 例えば、文書には​ タイトル ​を付け、その後​見出し1見出し2​などを付けます。 各見出しには、ある程度の内容を含める必要があります。 ドキュメントの構造が適切でない場合、移行プロセスが期待どおりに機能しない可能性があります。

既存のXHTML ドキュメントをDITA トピックに変換する

次のタブには、既存のXHTML ドキュメントをExperience Manager Guidesの設定に基づいてDITA トピックに変換する手順が示されています。Cloud Serviceまたはオンプレミスです。

Cloud Service

既存のXHTML ドキュメントをDITA トピックに変換するには、次の手順を実行します。

  1. パッケージマネージャーを使用して、/libs/fmdita/config/h2d_io.xml ファイルをダウンロードします。

  2. ダウンロードしたh2d_io.xml ファイルをカスタマイズします。

  3. Cloud ManagerのGit リポジトリの次の場所にファイルを追加します。

    /apps/fmdita/config/h2d_io.xml

    h2d_io.xml ファイルには、次の設定可能なパラメーターが含まれています。

    • inputDir要素で、ソース XHTML ドキュメントが使用可能な入力フォルダーの場所を指定します。 例えば、XHTML ドキュメントがprojects フォルダーのxhtmltoditaという名前のフォルダーに保存されている場合、場所を/content/dam/projects/xhtmltodita/と指定します

    • outputDir要素で、出力フォルダーの場所を指定するか、デフォルトの出力場所を保持します。 指定した出力フォルダーがDAMに存在しない場合、変換ワークフローによって出力フォルダーが作成されます。

    • createRev要素について、変換されたDITA トピックの新しいバージョンを\(true\)作成するか、\(false\)作成しないかを指定します。

  4. Cloud Manager パイプラインを実行して、更新された設定をデプロイします。

  5. w2d_io.xml ファイルで必要なパラメーターを設定したら、AEMにログインし、Assets UIを開きます。

  6. \(Optional\)​変換された文書に関連リンクのセクションを追加することもできます。 この機能を有効にするには、次の手順を実行します。

    note
    NOTE
    デフォルトでは、変換された文書に関連リンクのセクションは作成されません。
    1. パッケージマネージャーを使用して、/libs/fmdita/html2dita/h2d.xsl ファイルをダウンロードします。

    2. 次のパラメーターを検索します。

      <xsl:param name="generate-related-links" select="false()"/>

    3. 上記のパラメーターの値をtrue()に設定します。

    4. Cloud ManagerのGit リポジトリの次の場所に、更新されたファイルをコミットします。

      /libs/fmdita/html2dita/

    5. Cloud Manager パイプラインを実行して、更新された設定をデプロイします。

  7. 入力フォルダーの場所\(xhtmltodita\)に移動します。

  8. ソース XHTML ドキュメントをこのフォルダーにアップロードします。 DAMでのコンテンツのアップロードについて詳しくは、既存のDITA コンテンツのアップロード ​を参照してください。

<config> </config> ブロックを使用すると、変換する設定の1つまたは複数のブロックを定義できます。 変換ワークフローが実行され、DITA トピック形式の最終出力がoutputDir要素で指定された場所に保存されます。

オンプレミス

既存のXHTML ドキュメントをDITA トピックに変換するには、次の手順を実行します。

  1. AEMにログインし、CRXDE Lite モードを開きます。

  2. 次の場所にあるデフォルトの設定ファイルに移動します。

    /libs/fmdita/config/h2d_io.xml

  3. apps ノード内にconfig フォルダーのオーバーレイノードを作成します。

  4. apps ノードで使用可能な設定ファイルに移動します。

    /apps/fmdita/config/h2d_io.xml

    h2d_io.xml ファイルには、次の設定可能なパラメーターが含まれています。

    • inputDir要素で、ソース XHTML ドキュメントが使用可能な入力フォルダーの場所を指定します。 例えば、XHTML ドキュメントがprojects フォルダーのxhtmltoditaという名前のフォルダーに保存されている場合、場所を/content/dam/projects/xhtmltodita/と指定します

    • outputDir要素で、出力フォルダーの場所を指定するか、デフォルトの出力場所を保持します。 指定した出力フォルダーがDAMに存在しない場合、変換ワークフローによって出力フォルダーが作成されます。

    • createRev要素について、変換されたDITA トピックの新しいバージョンを\(true\)作成するか、\(false\)作成しないかを指定します。

  5. h2d_io.xml ファイルを保存します。

  6. h2d_io.xml ファイルで必要なパラメーターを設定したら、AEMにログインし、Assets UIを開きます。

  7. \(Optional\)​変換された文書に関連リンクのセクションを追加することもできます。 この機能を有効にするには、次の手順を実行します。

    note
    NOTE
    デフォルトでは、変換された文書に関連リンクのセクションは作成されません。
    1. 次の場所にあるh2d.xsl ファイルに移動します。

      /libs/fmdita/html2dita/

    2. 次のパラメーターを検索します。

      <xsl:param name="generate-related-links" select="false()"/>

    3. 上記のパラメーターの値をtrue()に設定します。

    4. ファイルを保存して閉じます。

  8. 入力フォルダーの場所\(xhtmltodita\)に移動します。

  9. ソース XHTML ドキュメントをこのフォルダーにアップロードします。 DAMでのコンテンツのアップロードについて詳しくは、既存のDITA コンテンツのアップロード ​を参照してください。

<config> </config> ブロックを使用すると、変換する設定の1つまたは複数のブロックを定義できます。 変換ワークフローが実行され、DITA トピック形式の最終出力がoutputDir要素で指定された場所に保存されます。

非構造化FrameMaker ドキュメントの移行 id1949B050VUI

非構造化Adobe FrameMaker コンテンツ(.fmおよび.book)を構造化DITAに変換するには、FrameMakerの変換テーブルメカニズムを使用できます。 このプロセスでは、テンプレートベースのアプローチを使用して既存のコンテンツを評価し、コンバージョンテーブルを通じてFrameMaker スタイルをDITAにマッピングすることに重点を置きます。 詳しくは、Adobe FrameMakerの非構造化ドキュメントからDITAへのテクニカルドキュメントの移行を参照してください。

変換後、構造化コンテンツをAEM Guidesに移行できます。 詳しくは、WebDAV ツールとFrameMakerを使用して既存のDITA コンテンツをアップロードするを参照してください。

その他の構造化文書の移行 id1949B0590YK

AEM Guidesを使用すると、既存の構造化ドキュメントを有効なDITA ドキュメントに変換できます。 入力と出力フォルダーの場所、変換ファイルの場所、最終出力を保存する拡張子、新しいバージョンのドキュメントが必要かどうかを指定する必要があります。

次のタブには、Experience Manager Guidesの設定に基づいて他の構造化ドキュメントを移行する手順が表示されます。Cloud Serviceまたはオンプレミス。

Cloud Service

既存の構造化文書をDITA形式に変換するには、次の手順を実行します。

  1. パッケージマネージャーを使用して、/libs/fmdita/config/XSLConfig.xml ファイルをダウンロードします。

  2. Cloud ManagerのGit リポジトリの次の場所にXSLConfig.xml ファイルのコピーを作成します。

    /apps/fmdita/config/XSLConfig.xml

    XSLConfig.xml ファイルには、次の設定可能なパラメーターが含まれています。

    • inputDir要素で、ソース構造化文書が使用可能な入力フォルダーの場所を指定します。 例えば、構造化文書がprojects フォルダーのxsltoditaという名前のフォルダーに保存されている場合、場所を/content/dam/projects/xsltodita/と指定します

    • outputDir要素で、出力フォルダーの場所を指定するか、デフォルトの出力場所を保持します。 指定した出力フォルダーがDAMに存在しない場合、変換ワークフローによって出力フォルダーが作成されます。

    • xslFolder要素で、XSL変換ファイルが保存されるフォルダーの場所を指定します。

    • xslPath要素で、変換プロセスの開始に使用するプライマリ .XSL ファイルの場所を指定します。

    • outputExt要素で、変換ストリームから作成される最終出力ファイルのファイル拡張子を指定します。

    • createRev要素について、変換されたDITA トピックの新しいバージョンを\(true\)作成するか、\(false\)作成しないかを指定します。

  3. XSLConfig.xml ファイルを保存します。

  4. XSLConfig.xml ファイルで必要なパラメーターを設定したら、AEMにログインし、Assets UIを開きます。

  5. 入力フォルダーの場所\(xsltodita\)に移動します。

  6. ソース構造化文書をこのフォルダーにアップロードします。 DAMでのコンテンツのアップロードについて詳しくは、既存のDITA コンテンツのアップロード ​を参照してください。

<config> </config> ブロックを使用すると、変換する設定の1つまたは複数のブロックを定義できます。 変換ワークフローが実行され、DITA トピック形式の最終出力がoutputDir要素で指定された場所に保存されます。

オンプレミス
  1. AEMにログインし、CRXDE Lite モードを開きます。

  2. 次の場所にあるデフォルトの設定ファイルに移動します。

    /libs/fmdita/config/XSLConfig.xml

  3. apps ノード内にconfig フォルダーのオーバーレイノードを作成します。

  4. apps ノードで使用可能な設定ファイルに移動します。

    /apps/fmdita/config/XSLConfig.xml

    XSLConfig.xml ファイルには、次の設定可能なパラメーターが含まれています。

    • inputDir要素で、ソース構造化文書が使用可能な入力フォルダーの場所を指定します。 例えば、構造化文書がprojects フォルダーのxsltoditaという名前のフォルダーに保存されている場合、場所を/content/dam/projects/xsltodita/と指定します

    • outputDir要素で、出力フォルダーの場所を指定するか、デフォルトの出力場所を保持します。 指定した出力フォルダーがDAMに存在しない場合、変換ワークフローによって出力フォルダーが作成されます。

    • xslFolder要素で、XSL変換ファイルが保存されるフォルダーの場所を指定します。

    • xslPath要素で、変換プロセスの開始に使用するプライマリ .XSL ファイルの場所を指定します。

    • outputExt要素で、変換ストリームから作成される最終出力ファイルのファイル拡張子を指定します。

    • createRev要素について、変換されたDITA トピックの新しいバージョンを\(true\)作成するか、\(false\)作成しないかを指定します。

  5. XSLConfig.xml ファイルを保存します。

  6. XSLConfig.xml ファイルで必要なパラメーターを設定したら、AEMにログインし、Assets UIを開きます。

  7. 入力フォルダーの場所\(xsltodita\)に移動します。

  8. ソース構造化文書をこのフォルダーにアップロードします。 DAMでのコンテンツのアップロードについて詳しくは、既存のDITA コンテンツのアップロード ​を参照してください。

<config> </config> ブロックを使用すると、変換する設定の1つまたは複数のブロックを定義できます。 変換ワークフローが実行され、DITA トピック形式の最終出力がoutputDir要素で指定された場所に保存されます。

親トピック:​既存のコンテンツを移行

recommendation-more-help
experience-manager-guides-help-product-guide