Word 文書を DITA に変換

Microsoft Word 文書を DITA 文書および DITA マップに変換する方法について説明します。

FrameMaker を使用すると、既存の Word 文書（.docx）を DITA トピックタイプの文書に移行できます。入力フォルダーと出力フォルダーの場所を他のパラメーターとともに指定すると、Word 文書が DITA 文書に変換されます。コンテンツの種類によって、 .dita ファイルおよび .ditamap ファイルを開こうとします。

Word 文書の正常な変換には、文書が適切に構造化されている必要があります。例えば、文書にはタイトルがあり、見出し 1、見出し 2 などが続いている必要があります。各見出しには、コンテンツがいくつか含まれている必要があります。文書が適切に構造化されていない場合には、プロセスが正常に機能しない可能性があります。

デフォルトでは、FrameMaker では、「Word-to-DITA（Word2DITA）翻訳フレームワーク」が使用されます。変換は、「style-to-tag マッピング」設定ファイルに依存しています。Word2DITA 変換を正常に使用できるようにするために、次の Word 文書変換の準備のためのガイドラインを検討する必要があります。

• 文書がタイトルで始まっていることを確認します。このタイトルは DITA マップのタイトルにマップされます。また、タイトルの後には通常のコンテンツが続いている必要があります。

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

• 文書には、最低 1 つの見出しタイプのコンテンツが必要です。

• グループ化された画像が含まれていないことを確認します。文書内にグループ化された画像が含まれている場合には、グループ化されているすべての画像のグループ化を解除します。

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

• 太字、斜体、下線などのインラインスタイルは、それぞれ、<b> 、< i > 、< u > のエレメントに変換されます。

• すべての番号付きリストと番号なしリストは、< ol > および< ul > エレメントに変換されます。これは、入れ子のリスト、表、ノート、脚注内のリストにも適用されます。

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

• 変換されたファイルのファイル名は、ファイル番号の前の見出しのテキストに基づいています。

Word 文書を DITA に変換するには、次の手順を実行します。

1. 構造 > ユーティリティ > Word（.docx）を DITA に変換 を選択します。

   Word（.docx）を DITA に変換 ダイアログボックスが表示されます。

   Figure 1. Word を DITA に変換ダイアログボックス
   
   

2. Word（.docx）を DITA に変換 ダイアログボックスで、以下を指定します。

   • ファイル：変換したいソース Word ファイルのパス。

   • Style to Tag Map ：変換のために使用するマッピングファイル。デフォルトのマッピングファイルは、次の場所で入手できます。

     C:\Users\<ユーザー名>\AppData\Roaming\Adobe\FrameMaker\16\X2DITA\Word2DITA\style2tagMap.xml

     デフォルトのマッピングファイルにカスタマイズを加えることもできます。ソースマッピングファイルとは異なるファイルを使用している場合には、Style to Tag Map の場所でファイルのパスを更新します。

   • DITA ファイルを出力／ディレクトリ：変換された DITA 文書を保存するための出力場所。デフォルトで、DITA マップファイルはソース Word 文書の名前で作成されます。 トピック フォルダーには、マッピングファイルの設定に基づいて作成される .dita ファイルが含まれています。 トピック ディレクトリには、 ソース Word 文書で使用されていたすべてのメディアファイルが含まれる、メディア サブディレクトリが含まれます。