文件AEM GuidesAEM Guides 文件

移轉非DITA內容 id181AH0R02HT

Last update: Thu Sep 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 經驗豐富
  • 管理員

本節將引導您完成移轉程式，將非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 map標題。 此外，「標題」後面必須接著一些一般內容。

  • 在標題之後，應該有標題1、標題2等。 每個標題中都必須有一些內容。 標題會轉換為新的概念型別主題。 產生之主題的階層會根據檔案中的標題層級而定，例如，標題1會位在標題2之前，而標題2會位在標題3內容之前。

  • 檔案必須至少有一個標題型別內容。

  • 確定您沒有任何分組的影像。 如果您已將檔案中的影像分組，請取消所有此類影像的分組。

  • 移除所有頁首和頁尾。

  • 粗體、斜體和底線等內嵌樣式會轉換為b、i和u元素。

  • 所有已排序和未排序的清單都會轉換為ol和ul元素。 這也適用於巢狀清單、表格、附註或註腳內的清單。

  • 所有超連結都會轉換為xref。

  • 轉換檔案的檔案名稱是以標題文字及檔案編號為基礎。 檔案編號是根據檔案中標題文字位置的連續數字。 例如，如果標題文字是「範例標題」，且是檔案中的第10個標題，則此主題的結果檔案名稱將類似於Sample_Heading_10.dita。

執行下列步驟，將您現有的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
      NOTE
      如需有關word-builtin-styles-style2tagmap.xml檔案的結構以及如何自訂的詳細資訊，請參閱​ DITA For Publishers使用手冊 ​中的樣式到標籤對應。

    • 在props2Propagate元素中，指定應傳遞至DITA map的屬性。 若要將預設中繼資料（例如dc：title、dc：subject、dam：keywords、dam：category）從檔案中繼資料傳遞至轉換的DITA資產，需要此屬性。

  5. 儲存 w2d_io.xml 檔案。

  6. 在w2d_io.xml檔案中設定必要的引數後，登入AEM並開啟Assets UI。

  7. 導覽至輸入資料夾位置(wordtodita)。

  8. 將來源Word檔案上傳至此資料夾。 如需在DAM上傳內容的資訊，請參閱上傳現有DITA內容。

使用config /config區塊，您可以定義一或多個轉換組態區塊。 會執行轉換工作流程，並以DITA主題形式的最終輸出儲存在outputDir元素中指定的位置。

移轉Adobe InDesign檔案 id195AD0B0K5Z

AEM Guides可讓您轉換InDesign檔案。 與FrameMaker類似，InDesign也可讓您建立非結構化和結構化檔案。 非結構化檔案使用段落和字元樣式來格式化內容。 結構化檔案使用元素及其對應的屬性。

轉換程式需要將段落和字元樣式格式對應到相關的DITA元素。 同樣地，如果是結構化檔案，對應檔案將包含具有DITA元素和屬性的InDesign元素和屬性的一對一對應。

轉換程式涉及後端中的下列動作：

  • InDesign標籤語言 (IDML)檔案已解壓縮至工作目錄。
  • 會讀取designmap.xml檔案，以找出個別InDesign內文。
  • 所有內文都會合併至單一XML例項，捨棄「空白」內文。
  • 所有內嵌圖形都會匯出。
  • 將標準結構（例如表格和圖形）預先轉換成DITA格式。
  • 根據對應檔案將樣式或結構對應到最終輸出。
  • 建立及驗證個別DITA主題與DITA map檔案。
  • 刪除暫存檔案。

大致上，轉換程式需要您準備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>

在idml2dita_io.xml檔案中設定下列引數：

  • 在inputDir元素中，指定可以使用來源InDesign檔案的輸入資料夾位置。 例如，如果您的InDesign檔案儲存在projects資料夾中名為indesigntodita的資料夾中，則指定位置為： /content/dam/idmlfiles/indesigntodita/

  • 在outputDir元素中，指定輸出資料夾的位置，或保留預設輸出位置以儲存轉換的DITA檔案。 如果DAM上不存在指定的輸出資料夾，則轉換工作流程會建立輸出資料夾。

  • 在mapStyle元素中，指定對應檔案的位置，該對應檔案包含InDesign檔案樣式至DITA元素的對應。 預設對應儲存在檔案中，檔案位於：

    /stmap.adobeidml.xml
NOTE
如需有關stmap.adobeidml.xml檔案的結構以及如何自訂的詳細資訊，請參閱​ 附錄 ​中的準備對應檔案以InDesign到DITA移轉區段。

  1. 儲存 idml2dita_io.xml 檔案。

  2. 在idml2dita_io.xml檔案中設定必要的引數後，登入AEM並開啟Assets UI。

  3. 導覽至輸入資料夾位置(indesigntodita)。

  4. 將來源InDesign檔案上傳至此資料夾。 如需在DAM上傳內容的資訊，請參閱上傳現有DITA內容。

移轉XHTML檔案 id1949B04L0Y4

AEM Guides可讓您將現有的XHTML檔案轉換為DITA主題型別檔案。 您需要指定輸入和輸出資料夾位置以及其他引數，檔案會轉換為DITA格式。 轉換結構化HTML檔案有兩種方法：

  • 將所有檔案上傳到輸入資料夾，或
  • 建立包含所有檔案及媒體檔案的ZIP檔，並將其上傳至輸入資料夾。 這種方法通常用於一組相互連結的HTML檔案，而且有一個目錄(index.html)。 index.html檔案包含集合中所有HTML檔案的連結。

無論您是個別上傳所有檔案，還是以ZIP格式組合上傳所有檔案，轉換程式都會在HTML檔案與產生的DITA檔案之間建立一對一的對應。 這基本上表示會針對輸入資料夾中的每個.html檔案建立.dita檔案。

在ZIP檔案中上傳檔案時，必須考量下列幾點：

  • 所有參考的主題都應放在ZIP檔案中。

  • 所有參照的媒體檔案應該使用相對連結在主題檔案中參照。

  • 建立index.html檔案，並將連結新增至您要在目錄中新增的主題。 此index.html檔案用於建立DITA map檔案。 在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標籤的class都必須設定為topicref。

  • 如果您使用內嵌樣式，請在XHTML檔案中將內嵌樣式轉換為CSS型樣式類別。 然後使用樣式屬性對應，將這些以類別為基礎的樣式轉換成轉換的DITA檔案中的DITA outputclass屬性。

    從這些DITA檔案產生HTML或AEM Site輸出時，outputclass屬性可用於在產生的HTML或AEM Site上套用樣式類別，以符合您的來源HTML內容。

除了建立ZIP檔案的考量以外，您的XHTML檔案也必須結構良好。 例如，您的檔案應該有​ 標題，後面接著​ 標題1、標題2，依此類推。 每個標題都應該有一些內容。 如果您的檔案結構不正確，移轉程式可能無法如預期運作。

若要將現有的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. \（選擇性\） ​您也可以將相關連結區段新增至轉換的檔案。 執行以下步驟來啟用此功能：

    note 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>區塊，您可以定義一或多個轉換組態區塊。 會執行轉換工作流程，並以DITA主題形式的最終輸出儲存在outputDir元素中指定的位置。

移轉非結構化FrameMaker檔案 id1949B050VUI

AEM Guides可讓您將現有的非結構化FrameMaker\（.fm與.book\）檔案轉換為DITA檔案。 第一步是使用FrameMaker建立樣式對應，並將這些設定儲存在.sts檔案中。 接下來，如果您使用自訂DITA，則您可以在ditaElems.xml檔案中將自訂元素與來源FrameMaker格式對應。 例如，如果您已建立名為impnote的自訂元素來處理所有重要附註，則您可以在ditaElems.xml檔案中定義此自訂元素。 定義此自訂元素後，在轉換包含impnote元素的FrameMaker檔案時，AEM Guides將不會引發錯誤。

此外，如果您想要使用自訂或有效的DITA元素指定一些其他屬性，可以在style2attrMap.xml檔案中定義這些屬性。 例如，您可以指定要與impnote元素一起傳遞且值為important的type屬性。 您可以在style2attrMap.xml檔案中指定此額外資訊。

除了指定

若要將現有的非結構化FrameMaker檔案轉換為DITA格式，請執行下列步驟：

  1. 以FrameMaker建立樣式對應，並將這些設定儲存在.sts檔案中。

  2. 登入AEM並開啟CRXDE Lite模式。

  3. 如果您有自訂DITA元素，請在ditaElems.xml檔案中定義可在下列位置使用的元素：

    /libs/fmdita/config/ditaElems.xml

  4. 在apps節點內建立config資料夾的覆蓋節點。

  5. 導覽至apps節點中可用的組態檔：

    /apps/fmdita/config/ditaElems.xml

    ditaElems.xml檔案包含單一可設定引數：

    • 在elem引數中，指定您要在轉換的DITA檔案中使用的自訂元素名稱。 此元素會像在產生的DITA檔案中一樣傳遞。

  6. 如果您想要指定其他屬性，請在下列位置可用的style2attrMap.xml檔案中定義這些屬性：

    /libs/fmdita/config/style2attrMap.xml

  7. 在apps節點內建立config資料夾的覆蓋節點。

  8. 導覽至apps節點中可用的組態檔：

    /apps/fmdita/config/style2attrMap.xml

    style2attrMap.xml檔案包含下列可設定的引數：

    • 在fmStyle引數中，指定您要對應之FrameMaker檔案中使用的來源格式。

    • 在ditaAttr元素中，指定您要與來源格式對應的DITA屬性。

    • 在ditaVal元素中，指定對應屬性的值。 如果您沒有任何值，可將此專案保留空白。

  9. 儲存 style2attrMap.xml 檔案。

  10. 在style2attrMap.xml檔案中設定必要的引數後，登入AEM並開啟Assets UI。

  11. 瀏覽至您要轉換的FrameMaker檔案，並按一下該檔案。

    DITA map主控台隨即出現，顯示可用於產生輸出的輸出預設集清單。

  12. 選取DITA輸出格式並設定必要的引數。

    note note
    NOTE
    您必須使用您在FrameMaker中建立的相同設定檔案(.sts)。 此外，請指定設定名稱和目的地路徑。

  13. 按一下​ 產生 ​圖示以啟動輸出產生程式。

使用<attrMap> </attrMap>區塊，您可以定義一或多個轉換組態區塊。 根據內容的不同，您可能會有.dita檔案和.ditamap檔案作為轉換的檔案。

移轉任何其他結構化檔案 id1949B0590YK

AEM Guides可讓您將現有的結構化檔案轉換為有效的DITA檔案。 您需要指定輸入和輸出資料夾位置、轉換檔案的位置、儲存最終輸出的副檔名，以及是否需要檔案的新版本。

若要將現有的結構化檔案轉換為DITA格式，請執行下列步驟：

  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>區塊，您可以定義一或多個轉換組態區塊。 會執行轉換工作流程，並以DITA主題形式的最終輸出儲存在outputDir元素中指定的位置。

上層主題： ​​移轉現有內容

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178