附錄 id195AD0L60Y4

準備InDesign檔案以進行轉換 id195DBF0045Z

InDesign為作者提供一套豐富的功能，用於建立吸引人且複雜的檔案。 這通常表示檔案的不同部分會以視覺化方式放置在頁面上，但不會嘗試在這些文字框之間提供任何流量。 未定義文字框的'讀取順序'時，IDML檔案會包含可能未遵循任何有意義的順序的內文。 最終結果將是一個或多個DITA主題，其中包含以隨機順序排列的段落、表格和圖形。

雖然可以在DITA編輯器中將DITA內容編輯成合理的順序，但在建立IDML檔案之前修正InDesign檔案會容易得多。 這可以在不改變來原始檔外觀的情況下完成。 透過正確定義閱讀順序，也有助於使來原始檔可存取。

串連文字框

InDesign使用字詞​ '執行緒' ​來連結一個影格到另一個影格的程式。 如需串連文字框的詳細資訊，請參閱InDesign檔案中的​ 串連文字 ​主題。

重疊影格

有些InDesign檔案會因版面配置原因而使用非執行緒式重疊框架。 將此內容合併到主對話串中可能非常困難。 最佳選項可能是在DITA環境中編輯結果。

InDesign劇本

InDesign檔案中的每個串連內容流程都稱為'story'。 為獲得最佳結果，建議限制內文數量。 但是，在DITA輸出中可能不需要檔案的某些部分。 例如，很少需要頁尾，但如果未小心處理，它們可能會出現在主題的中間。

排除檔案中不需要的文字最簡單的方法是為其指定一個特殊的​ 段落標籤，該標籤只用於不需要的內容。 例如，不要在頁尾重複使用​ [基本段落]，請建立專用的​ 頁尾 ​標籤。 然後在MapStyle檔案中，設定要捨棄的​ 頁尾 ​段落，如下所示：

<paraRule style="Footer" local="0" refactor="drop">
   <attributeRules createID="false"/>
</paraRule>

對應到DITA doctypes

您的來原始檔至少必須有一個段落樣式或元素可以標示主題的開頭。 檔案通常使用​ Heading1 ​作為檔案最上層標題的名稱。 然後，您可以建立該樣式到特定DITA doctype的對應。 如果您的檔案組織良好，而且始終使用​ 標題1，那麼您將會獲得良好的結果。

多個DITA doctypes

如果需要將某些​ 標題1 ​段落轉換為其他DITA doctypes，請複製InDesign的段落樣式。 視情況提供這些樣式易於辨識的名稱，例如​ Heading1_genTask ​或​ Heading1_troubleshooting。 然後，設定mapStyle檔案，如下所示：

<doctypes>
   <doctypeParaRule style="Heading1" local="0" mapToDoctype="concept">
      <attributeRules createID="true"/>
   </doctypeParaRule>
   <doctypeParaRule style="Heading1_genTask" local="0" mapToDoctype=" generalTask">
      <attributeRules createID="true"/>
   </doctypeParaRule>
   <doctypeParaRule style="Heading1_troubleshooting" local="0"mapToDoctype=" troubleshooting">
      <attributeRules createID="true"/>
   </doctypeParaRule>
</doctypes>

結構化InDesign檔案

InDesign與XML的關係不密切。 雖然檔案可以包含XML DTD，且主要內文可能對該DTD有效，但也可以建立混合式檔案，其中某些內容為XML，但不包含DTD。 這些是不希望成功轉換為DITA的情況。 如果檔案包含XML零件，請嘗試將輸出儲存為XML並檢視結果是否可接受。 如果不包含，則DITA內容也將包含無效的內容，或可能完全失敗。

表格格式

從InDesign表格格式規則轉換成DITA中的對等表格格式是一個複雜的過程。 這是因為與DITA中使用的Oasis (CALS)表格模型所提供的基本選項相比，來源檔案中提供了豐富的格式功能。 提供垂直和水平文字對齊方式，雖然「對齊」文字一律根據文字方向對齊，而「InDesign」則允許「靠左對齊」和「靠右對齊」，但結果類似。

InDesign處理欄和列分隔符號的能力再次遠勝於Oasis表格模型的基本選項。 InDesign提供四種儲存格邊框 — 邊框型別\（實線或圖樣\）、邊框粗細、邊框顏色、邊框色調、邊框間隙顏色和邊框間隙色調。 所有這些都必須向下對應至每個儲存格右下方的框線(entry element)，其中唯一選項為0或1 — 隱藏框線或顯示框線。

InDesign的邊框規則可套用至下列層級：

InDesign至DITA轉換程式會套用邊界規則，如下所示：

交替模式

InDesign表格樣式允許欄和儲存格的排版遵循交替模式。 雖然轉換支援此功能，但只有當一個圖樣群組對應到顯示正線(1)，而另一個圖樣群組對應到隱藏正線(0)時，結果才會很明顯。

準備對應檔案以InDesign至DITA移轉 id194AF0003HT

正確的DITA轉換需要符合來原始檔內容的對應檔案。 對於非結構化InDesign檔案，這表示所有可用的段落樣式和字元樣式都需要對應。 對於XML結構化InDesign檔案，其關聯DTD中的所有元素都必須對應。

非結構化和結構化InDesign檔案的對應檔案不同。 這是因為將非結構化來源內容轉換為DITA的處理要求較為複雜。

以下提供對應檔案的範例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE styleMap SYSTEM "mapStyle.dtd">
<styleMap xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="mapStyle.xsd" >
   <doctypes>
      <mapDoctypeParaRule root="itpx:stories" mapToDoctype="map">
         <attributeRules createID="true">
            <addNew name="outputclass" value="map"/>
         </attributeRules>
      </mapDoctypeParaRule>
      <doctypeParaRule style="Heading 1" local="0" mapToDoctype="concept">
         <attributeRules createID="true"/>
      </doctypeParaRule>
      <doctypeParaRule style="Heading A" local="0" mapToDoctype="topic">
         <attributeRules createID="true"/>
      </doctypeParaRule>
   </doctypes>
   <wrappingRules>
      <wrap elements="li+" context="number" wrapper="ol">
         <attributeRules createID="true"/>
      </wrap>
      <wrap elements="li+" context="bullet" wrapper="ul">
         <attributeRules createID="true"/>
      </wrap>
   </wrappingRules>
   <paragraphStyleRules>
      <paraRule style="Heading 2" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Heading 3" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="p[-|-|-|-|-|b|-|-]" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="p[-|-|-|-|-|n|-|-]" context="number" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="0" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Normal" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Normal" local="p[-|-|-|-|-|b|-|-]" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Title" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
   </paragraphStyleRules>
   <characterStyleRules>
      <charRule style="Bold" local="0" mapTo="b">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="Code" local="0" mapTo="codeph">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="[No character style]" local="c[Bold|-|-|-|-|-|-|-]" mapTo="b">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="[No character style]" local="c[Italic|-|-|-|-|-|-|-]" mapTo="i">
         <attributeRules createID="false"/>
      </charRule>
   </characterStyleRules>
</styleMap>

對應檔案是結構簡單的XML檔案，列出所有來源段落樣式和字元樣式代碼。 檔案內容說明如下：

樣式對應

在styleMap元素中，您可以指定兩個選擇性屬性 — @map_date和@map_version，以記錄對應檔案的版本。

檔案型別

doctypes元素列出支援的DITA map和主題對應。

對應檔案型別段落規則

mapDoctypeParaRule專案為必要專案。 不可編輯這個專案的屬性，因為來源XML的根專案永遠對應到DITA map的根map專案。

檔案型別段落規則

doctypeParaRule專案為必要專案。 這可提供轉換程式來識別新主題開始的方式。 通常@style屬性會單獨使用，且@local屬性會設為0。 但是，如果所選樣式上永遠有本機格式覆寫，則必須為每個樣式新增規則及其本機覆寫。 在產生的對應檔案中，這很容易識別，其中可能找到以下內容或類似內容：

<paraRule style="Heading 1" local="0" mapTo="p">
   <attributeRules createID="true"/>
</paraRule>
<paraRule style="Heading 1" local="p[Italic|-|-|-|-|-|-|-]" mapTo="p">
   <attributeRules createID="true"/>
</paraRule>

在上述範例中，@style = "Heading1"有兩個paraRule元素。 只要建立具有@mapToDoctype屬性設定的對等doctypeParaRule專案（視需要而定）。

doctypeParaRule中使用的屬性說明如下：

元素包裝規則

元素環繞規則會根據一組屬性值，定義將傳入檔案中的元素環繞或移動至預先定義元素的方法。

wrap元素

這是選用元素。 wrap元素列出將包裝或移動的元素。 封裝通常用於必須為一系列元素指定通用父元素的情況。 例如，多個li元素將包裝在ol元素中。 此外，wrap可用於移動元素，例如插圖和表格的標題。

wrap中使用的屬性說明如下：

下列範例顯示如何從title和image專案建立fig專案：

下列範例顯示如何將title移入table：

段落樣式規則

<paragraphStyleRule>元素說明如下：

paraRule元素

paraRule專案為必要專案。 這會指定所有段落樣式的對應規則。 在InDesign檔案中，所有文字都包含在段落樣式的子結構內，即使沒有任何樣式的段落也命名為[No paragraph style]。 方括弧，表示內建的InDesign樣式名稱。

paraRule中使用的屬性說明如下：

字元樣式規則

charRule元素說明如下：

charRule元素

這是選用元素。

這些是所有字元樣式的對應規則。 在InDesign檔案中，所有文字都包含在字元樣式的子元素中。

charRule中使用的屬性說明如下：

屬性規則

此元素可以是下列元素前後關聯的子項：

屬性規則的用途是管理相符元素的屬性。

根據內容，attributeRules元素可使用下列屬性：

attributeRules中使用的屬性說明如下：

本機格式碼

在任何InDesign檔案中，段落樣式和字元樣式都可以包含數百種不同的格式覆寫。 這些屬性大多在轉換過程中不提供有用的角色。 不過，我們已找出一組會影響檔案語意且需要影響轉換程式的核心格式化功能。

@local屬性以特殊分隔格式顯示，其中有8個欄位與前置字元一起提供，以顯示格式覆寫型別。 格式代碼欄位列示如下：

謹慎使用此功能，否則會遺失本機格式，有助於改善從已設定樣式的內容轉入DITA的品質。 此範例可解析為專案符號清單中表示斜體、16pt文字： p[Italic|16|-|-|-|b|-|-]。

結構對應

結構對應檔案類似於「樣式對應」檔案，其簡單結構會列出所有來源元素和相關屬性型別。 提供兩個屬性@map_date和@map_version來記錄要使用的對應檔案版本。

檔案型別

doctypes元素列出支援的DITA map和主題對應。

對應檔案型別元素規則

mapDoctypeElemRule專案為必要專案。 不可編輯這個專案的屬性，因為來源XML的根專案永遠對應到DITA map的根map專案。

元素包裝規則

elementRules元素 ​這會列出所有元素。

elementRule元素 elementRule元素是必要的。 這些是所有來源元素的對應規則。 雖然InDesign檔案確實包含非結構化的樣式元素，但除非啟用'混合模式'處理，否則結構化的內容會忽略這些元素。

elementRule中使用的屬性說明如下：

疑難排解AEM Guides

安裝及設定AEM Guides後，您就可以疑難排解問題。

驗證引用

您可以執行指定的指令碼來驗證參考。 這些指令碼可協助您識別中斷的參照，然後修補或修正它們。

驗證指令碼

使用產品套件中可用的驗證指令碼，執行以下步驟來檢查參考：

修補程式指令碼

使用產品套件中可用的修補程式指令碼，執行下列步驟來修補任何中斷的參照：

記錄器

您也可以為此指令碼執行建立單獨的記錄器，如下所示：

建立的記錄檔將記錄與指令碼執行相關的所有資訊，並在瀏覽器工作階段逾時從瀏覽器觸發指令碼時很有用。