使用路徑架構的 sidecar.xml 檔案匯入文章

匯入文章的主要方法有兩種：

從檔案夾匯入文章：使用這種方法時，您必須在「匯入文章」對話框中指定「匯入單一文章」或「匯入多個文章」，然後指向包含來源檔案的檔案夾。在這種方法中，正確建構的檔案名稱和檔案夾很重要。當您選取「匯入多個文章」時，指定包含文章中繼資料的 sidecar.xml 檔案是選擇性的。傳統的 sidecar.xml 檔案必須與文章子檔案夾位於相同的層級。如需有關使用此方法匯入文章的詳細資訊，請參閱「建構檔案夾以匯入文章」。

匯入 sidecar.xml 中指定的文章：當您在「匯入文章」對話框中選取「使用 sidecar.xml 匯入」時，必須指定包含特定檔案路徑名稱的 sidecar.xml 檔案。在匯入具有替代版面的 InDesign 文件或從不同的位置匯入檔案時，這個選項特別有用。這種方法僅適用於 InDesign CS6 和更新版本。

下面是雙向對開本的路徑架構 sidecar.xml 檔案範例。這個範例包含三種不同類型的文章：具有替代版面的 InDesign 文章、一組 _h 和 _v InDesign 文件，以及 HTML 文章。

遺憾的是，Sidecar.xml 產生器工具不支援建立新的路徑架構 sidecar.xml 格式。我們建議您下載並編輯 sidecar.xml 檔案範例。您可以視需要新增和移除元素。

設定路徑架構的 sidecar.xml 檔案

路徑架構 sidecar.xml 檔案中的項目包含定義來源檔案位置的 <contentSource> 元素。對於 InDesign 文章，您必須指定來源檔案的位置和版面。對於 HTML 文章，您必須指定包含 HTML 資產的檔案夾。

每個 <entry> 區段都會定義文章的位置和中繼資料。

路徑名稱資訊 (InDesign)

<contentSource> 區段就是指定文章來源檔案的類型和位置之處。

對於 <sourceFormat>，有效的值包括「indd」(代表 InDesign 來源檔案) 和「html」(代表 HTML 來源檔案)。

對於 <customTocIcon>，請視需要指定 TOC 影像檔案的路徑名稱。如果您想要產生 TOC 影像，請忽略此元素或者不要加入值。<customTocIcon> 元素僅適用於 InDesign 檔案，不適用於 HTML 檔案。對於 HTML 檔案，您只要將 TOC .png 檔案加入與 .html 檔案位於相同層級的目標檔案夾即可。

如果是僅限垂直對開本的文章，請建立 <sourceFile_v> 區段；如果是僅限水平對開本的文章，請建立 <sourceFile_h> 區段；如果是雙向對開本，請建立這兩個區段。請在 <location> 元素中指定 InDesign 檔案的路徑名稱。對於具有替代版面的文件，請在 <layoutName> 元素中指定版面名稱 (例如「iPad V」)，因為它會顯示在 InDesign「頁面」面板中。

只有具有替代版面的 InDesign 文件才需要 <layoutName> 元素。

有效的路徑名稱格式：

(Mac OS) /Users/johndoe/Documents/black box.indd
(Windows) C:\Users\johndoe\Documents\black box.indd

路徑名稱資訊 (HTML)

匯入 HTML 文章時，您必須在 <sourceFolder> 元素中指定檔案夾路徑。您所指定的檔案夾應該包含 .html 檔案、選擇性 TOC .png 檔案以及其他位於子檔案夾中的 HTML 資產。只有當您想要在水平和垂直版面中顯示不同的 HTML 內容時，才必須在 HTML 檔案名稱中使用 _v 和 _h 字尾。例如，您可以在同一個檔案夾中加入「index_v.html」和「index_h.html」檔案。

其他元素

有效的 <isAd>、<isFlattenedStack> 及 <isTrustedContent> 值是「true」和「false」。<isFlattenedStack> 值可決定是否開啟「僅限水平滑動」，而 <isTrustedContent> 可決定是否為 HTML 文章選取「允許存取權利資訊」選項。

有效的 <smoothScrolling> 值包括「always」、「portrait」、「landscape」和「never」。預設值為「never」，表示捲動靠齊至頁面。

有效的 <articleAccess> 值包括「free」(免費)、「metered」(計量) 和「protected」(受保護)。

您可在署名中繼資料中使用 <byline> 或 <author>。

針對 <section> 項目，請指定一連串字元，例如「Lifestyle」。

<entry> 區段的順序會決定您建立或更新對開本時對開本中的文章順序。每個 <entry> 內的元素順序不重要。

使用路徑架構的 sidecar.xml 檔案匯入文章

解決 sidecar.xml 錯誤訊息

sidecar.xml 中的 contentSource 元素無效

這則錯誤訊息會在下列情況中出現：

• 指定的來源檔案無法使用或無法正確開啟。
• 路徑名稱包含一個或多個無效的字元。例如，如果您使用「終端機介面」來複製路徑名稱，路徑名稱中的空格前面會加上反斜線 (\)。請移除這些反斜線。
• 您在 HTML 文章格式中指定了 <customTocIcon> 元素。
  

對於「使用 sidecar.xml 匯入」，folderName 元素是無效的

使用「使用 sidecar.xml 匯入」選項時，您指定了傳統的 sidecar.xml 檔案而非路徑架構的 sidecar.xml 檔案。請指定路徑架構的 sidecar.xml 檔案，或使用「匯入多個文章」選項，如「建構檔案夾以匯入文章」中所述。

對於「匯入多個文章」，sidecar.xml 中的 contentSource 是無效的

如果出現這則錯誤訊息，就表示您選取了「匯入多個文章」以匯入包含路徑架構 sidecar.xml 檔案的對開本檔案夾。請搭配「匯入多個文章」選項使用傳統的 sidecar.xml 檔案，或選取「使用 sidecar.xml 匯入」選項並指定路徑架構的 sidecar.xml 檔案。

無法在關聯的 InDesign 文件中找到此文章的縱向/橫向版面

您針對 <layoutName> 指定的值無效。請開啟 InDesign 文件並在「頁面」面板中檢查版面名稱，然後編輯 sidecar.xml 檔案。

使用路徑架構的 sidecar.xml 檔案更新中繼資料

您可以加入 <metadataUpdateOnly/> 元素成為 <sidecar> 元素的直屬子項，表示不要建立新的文章。如果 <metadataUpdateOnly/> 元素存在，匯入 sidecar.xml 檔案就會更新現有文章的中繼資料 (如 <articleName> 值所識別)。

指定 <metadataUpdateOnly/> 之後，<sourceFile_v>、<sourceFile_h> 和 <sourceFolder> 元素都是選擇性的，而且如果存在，就會被忽略。

若要更新現有文章的中繼資料，請編輯 sidecar.xml 檔案、緊接在 <sidecar> 元素後方插入 <metadataUpdateOnly/> 元素，然後使用「匯入文章」對話框中的「使用 sidecar.xml 匯入」選項來匯入 sidecar.xml 檔案。