移轉非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 map標題。 此外,「標題」後面必須接著一些一般內容。

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

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

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

  • 移除所有頁首和頁尾。

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

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

  • 所有超連結都會轉換為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. 導覽至apps節點中可用的組態檔:

    /apps/fmdita/config/idml2dita_io.xml

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

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

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

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

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

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

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

  8. 將來源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元素一起傳遞且值為importanttype屬性。 您可以在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