使用基于路径的 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>，如果需要，可指定目录图像文件的路径名。如果希望生成目录图像，请省略此元素或不包含值。请仅对 InDesign 文件（而不要对 HTML 文件）使用 <customTocIcon> 元素。对于 HTML 文件，您只需在与 .html 文件相同级别的目标文件夹中包括目录 .png 文件。

为仅垂直方向作品集中的文章创建 <sourceFile_v> 部分、为仅水平方向作品集中的文章创建 <sourceFile_h> 部分，或对双向作品集同时创建这两个部分。在 <location> 元素中指定 InDesign 文件的路径名。对于具有替代布局的文档，在 <layoutName> 元素（当它在 InDesign 的“页面”面板中时）中指定布局名称（例如“iPad V”）。

只有具有替代布局的 InDesign 文档才需要 <layoutName> 元素。 

有效的路径名格式：

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

路径名信息 (HTML)

当您导入 HTML 文章时，请在 <sourceFolder> 元素中指定文件夹路径。您指定的文件夹应包括一个 .html 文件、一个可选的 .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> 用于 Byline 元数据。

对于 <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 文件。