原生PDF输出预设
在创作内容时,必须确保内容针对查看、编辑和打印进行了优化。 通过使用诸如W3C CSS3之类的用于内容样式设置的标准和诸如Size、边距、方向、分页符、页眉、页脚和页码等页面定义属性的CSS分页媒体标准,您可以为PDF文档设置视图和布局,以确保一致性和可用性。 原生PDF发布功能使用这些标准生成PDF。
在本机PDF发布中,您可以使用预定义模板来确保内容布局和结构的一致性,应用样式表来更改输出的外观,优化PDF,设置打印机标记,允许屏幕阅读器支持,设置PDF符合性,嵌入字体等等。
使用本机PDF发布功能生成PDF的过程包括两个方面:
-
使用模板将样式应用于内容、设置页面布局和各种设置以微调PDF。 作者可以选择使用/修改提供的示例模板,也可以创建自定义模板并设置发布者和开发人员使用的高级配置选项。
-
创建或配置PDF输出预设以控制PDF设置。 创建PDF输出预设后,即可生成PDF。
创建输出预设
执行以下步骤,从“地图”控制台中创建PDF预设:
-
在映射控制台中打开DITA映射文件。
您还可以从概述部分中的 最近使用的文件 构件访问映射文件。 选定的映射文件将在映射控制台中打开。
-
在 输出预设 选项卡中,选择+图标以创建输出预设。
-
从 新建输出预设 对话框的“类型”下拉列表中选择PDF。
-
在 名称 字段中,提供此预设的名称。
-
在 使用 生成PDF字段中,选择Native-PDF。
-
选择 添加到当前文件夹配置文件 选项可在当前文件夹配置文件中创建输出预设。
表示文件夹配置文件级别的预设。了解有关管理全局和文件夹配置文件输出预设的更多信息。
-
选择添加。
将创建PDF的预设。
本机PDF预设配置
创建预设后,配置本机PDF预设设置。 DITA-OT的预设配置选项在常规、元数据、布局、安全性、打印和 高级 选项卡下组织。
常规
用于指定基本输出设置,如指定输出路径、PDF文件名等。
${base_output_path}设置的。 要配置输出路径,请查看为云服务配置基本输出位置或根据您使用的服务为本地服务配置基本输出位置。您还可以使用以下现成的变量来定义输出路径。 您可以使用单个变量或变量组合来定义此选项。
${map_filename}:使用DITA映射文件名称创建目标路径。${map_title}:使用DITA映射标题创建目标路径。${preset_name}:使用输出预设名称创建目标路径。${language_code}:使用映射文件所在的语言代码创建目标路径。${map_parentpath}:使用映射文件的完整路径创建目标路径。${path_after_langfolder}:使用语言文件夹之后的映射文件路径创建目标路径。您还可以使用以下现成的变量来定义PDF文件。 您可以使用单个变量或变量组合来定义此选项。
${map_filename}${map_title}${preset_name}${language_code}。对于条件化内容,请从以下选项中选择以根据这些条件生成PDF输出:
- 未应用如果不想对映射和源内容应用任何条件,请选择此选项。
- DITAVAL文件选择DITAVAL文件以生成条件内容。 您可以使用浏览对话框或手动输入文件路径来选择多个DITAVAL文件。 要删除选定的文件,请单击其名称旁边的交叉图标。 如果选择了无效文件,则会显示一条错误消息,说明选择了无效的DITAVAL文件。
每个DITAVAL文件都可以包含一系列属性,如筛选条件和标记样式。 标记允许您使用开始和结束标记直观地标记内容,这些标记可以包括图像或文本格式,如粗体或斜体。 如果出现重叠条件或样式冲突,可以使用“样式”冲突设置定义背景颜色。 有关更多详细信息,请查看使用DITAVAL编辑器。 - 条件预设从下拉列表中选择条件预设,以在发布输出时应用条件。 如果为DITA映射文件添加了条件,则此选项可见。 条件设置在DITA映射控制台的条件预设选项卡中可用。 要了解有关条件预设的更多信息,请查看使用条件预设。
使用以下选项创建一个PDF,它使用更改栏显示两个版本之间的内容差异:
- 以前版本的基线选择要与当前版本或其他基线进行比较的基线版本。 PDF中将显示一个更改栏,以指示修改的内容。 更改条是一条垂直线,用于直观地标识新内容或修订的内容。 更改栏显示在已插入、更改或删除的内容左侧。
注意:如果您选择 使用基线 并选择要发布的基线,将在两个选定的基线版本之间进行比较。 例如,如果您在 使用基线 下选择基线版本1.3,在 以前版本的基线 下选择基线版本1.1,则将在基线版本1.1和基线版本1.3之间进行比较。 - 显示添加的文本选择以绿色显示插入的文本并加下划线。 默认情况下,该选项处于选中状态。
- 显示已删除的文本选择以红色显示已删除的文本并标记删除线。 默认情况下,该选项处于选中状态。
注意您还可以使用样式表自定义更改栏、插入的内容或删除内容的样式。
xml:lang属性相同的语言,请选择 使用映射语言 选项,而不是显式选择语言。如果映射未定义
xml:lang,则默认将输出设置为英语(en_US)。 当父映射已设置xml:lang属性时,这很有用,因此您不需要为每种语言设置单独的输出预设。 要了解此设置如何影响不同类型的内容,请查看DITA内容的语言解析度与输出模板变量。注意:
默认情况下,本机PDF输出中不包括在DITA关系表(
<reltable>)中定义的相关链接。 使用-Dargs.rellinks=nofamily DITA-OT参数在本机PDF输出中包含此类相关链接。对于嵌套映射,默认情况下,映射引用上设置的
toc="no"属性不会从目录中排除其子主题。 使用-Dpreprocess.move-meta-entries.skip=false DITA-OT参数确保从此类映射的TOC中排除子主题。- 默认情况下,在DITA关系表(
<reltable>)中定义的相关链接不包括在Native PDF输出中。 使用此字段传递-Dargs.rellinks=nofamilyDITA-OT参数并在输出中包含此类相关链接。
元数据
元数据是内容的描述或定义。 元数据有助于内容管理,也有助于在Internet上搜索文件。
使用“元数据”选项卡可设置元数据字段,例如作者的姓名、文档标题、关键字、版权信息以及PDF输出的其他数据字段。 您还可以为PDF输出添加自定义元数据。
此元数据映射到输出PDF 文档属性的 描述 选项卡中的元数据。
从输出预设中,选择PDF > Native-PDF > 元数据以添加和自定义元数据选项。
-
使用添加在topicmeta中的元数据
默认情况下,该选项处于选中状态。 您可以使用在DITA映射的topicmeta元素中添加的元数据来填充PDF输出的元数据字段。
-
提供XMP文件
您还可以通过导入XMP(可扩展元数据平台)文件直接填充元数据字段。 您可以从此处下载示例XMP文件。
或者,您可以使用Adobe Acrobat生成XMP文件。
- 在Acrobat中选择文件 > 属性。
- 在 描述 下,选择其他元数据。
- 从左侧面板中选择高级。
- 选择保存。
XMP文件将保存在设备上。
-
提供元数据名称和值
- 从下拉列表中选择以添加名称,或直接在名称字段中键入以添加自定义元数据。
- 输入元数据的值并选择“+”图标。
元数据将添加到PDF的元数据列表中。
您还可以使用变量来定义元数据值。 可以将为DITA映射或书图文件定义的元数据用作变量。 可以在DITA映射或书签映射文件的/jcr:content/metadata节点下找到元数据。
使用变量时,将从元数据属性中选取变量的值。
要使用变量,您需要以${<variable>}格式定义它。
例如,在/jcr:content/metadata节点中定义的元数据属性之一是dc:title. 您可以指定${dc:title},并在最终输出中使用标题值。
您可以使用单个变量或变量组合来定义元数据。 例如,${dc:title} ${dc:docstate}。 您还可以使用变量和字符串的组合。 例如 View ${dc:title} in ${dc:language}。
使用语言变量定义元数据属性的本地化值。 根据您选择的语言,将在PDF输出中自动选取本地化的值。 例如,您可以将“Author”作为元数据值打印在英语中,将“Autorin”作为元数据值打印在德语中。
格式: ${lng:<variable name>}。 例如,${lng:author-label}其中author-label是语言变量。
将鼠标悬停在
布局
用于设置页面布局并指定PDF输出的页面查看选项(如“页面显示”)和设置缩放级别。
您还可以选择浏览模板
使用“页面显示”进行页面查看,以显示PDF在打开时的显示方式。 从“页面显示”下拉选项中进行选择,以选择首选视图。
- 默认值根据用户计算机上PDF查看器的默认设置显示。
- 单页视图一次显示一个页面。
- 单页滚动在连续的垂直列中显示单个页面。
- 两个页面视图一次并排显示两个页面跨页。 .
- 两页滚动显示两页跨页并排连续滚动。
选择可调整页面视图的大小,以显示PDF在打开时的显示方式。
- 默认值根据用户计算机
上PDF查看器的默认设置显示 - 100%使页面以实际大小显示。
- 适合页面使页面宽度和高度适合文档窗格。 .
- 调整页面宽度使页面宽度填充文档窗格的宽度。
- 适合页面高度使页面高度填充文档窗格的高度。
安全性
通过添加对打开和读取文件的限制来保护您的PDF。 使用以下选项以避免未经授权的访问。
选择以限制用户与您的PDF的交互方式。 在 所有者密码 字段中指定密码以使以下限制设置生效。
- 正在打印选择此项可允许用户打印PDF。
- 草稿质量打印选择此项可允许用户以较低的分辨率打印PDF。
- 内容复制选择此项可允许用户从PDF复制内容。
- 批注选择此项可允许用户在PDF中添加注释或评论。
- 内容修改选择此项可允许用户更改PDF中的内容。
- 为辅助功能复制内容选择此项可允许屏幕阅读器在PDF中阅读和导航内容。
文档程序集选择此项可允许用户在PDF中插入页面。
注意:用户需要输入所有者密码才能更改Adobe Acrobat中“文件”>“属性”的任何限制。
打印
配置打印生产设置以分配打印机标记、定义页框以及为PDF输出设置颜色和ICC配置文件选项。 “打印”选项卡分为三个部分,顺序为:打印机标记、页框和颜色和ICC。
打印机标记
在准备文档以进行打印生产时,打印机标记会添加到页面边界中,以帮助在打印期间正确对齐、修剪和颜色选择。 选择打印机标记时,会扩展页面边界以容纳标记,并在打印后修剪扩展区域。
使用以下设置为PDF输出配置打印机标记:
页面框
使用此部分可定义PDF输出的整体页面大小和出血区域。
使用以下设置配置页面框:
颜色和ICC
使用此部分选择用于打印的色彩空间,并(可选)使用ICC配置文件管理跨设备的色彩准确度。 使用CMYK色彩空间时,需要使用ICC色彩配置文件才能符合需要色彩管理的PDF要求。
使用以下设置配置色彩空间和ICC配置文件:
- 默认:使用默认渲染行为。
- 可感知:调整颜色以保留它们的整体视觉外观。
- 相对比色:根据目标色彩空间调整颜色,同时尽可能保持颜色准确性。
注意:将此功能与Adobe Experience Manager Guides本地设置一起使用时,请确保基础本机PDF引擎可以使用Java 20或更高版本,以应用指定的渲染方法。
.icc或.icm)。 启用 为配置文件 使用URL时,此字段被禁用。高级
使用以下选项指定合并PDF、使用压缩、选择合规性标准等内容的高级设置。
注意:字体只有包含允许嵌入的字体供应商设置的字体才能嵌入。 在嵌入字体之前,请确保您具有所需的设置或许可证。
使用静态文本或语言变量发布水印的本地化版本。 根据您选择的语言,将在PDF输出中自动选取本地化的值。 例如,您可以将“Publisher”作为水印以英语打印,将“Auteure”作为水印以法语打印。
格式:
${lng:<variable name>}。 例如,$ {lng:publisher-label}其中publisher-label是语言变量。将鼠标悬停在
注意:仅启用此选项不会使草稿注释出现在输出中。 管理员还必须在用于映射的输出模板中将草稿注释样式的display属性设置为可见值(如
block、inline-block、grid等)。 有关详细信息,请查看在本机PDF输出中显示或隐藏草稿注释。system_config.xml文件,该文件为您提供了有关作者URL、本地URL和发布URL的信息。 这些URL是在AEM外部化设置中配置的,并反映在system_config.xml文件中。dc:description、dc:language、dc:title和docstate是默认属性,而您可以将author作为自定义属性。 所选元数据属性将传递到使用本机PDF生成的PDF文件。这些属性是从位于
/libs/fmdita/config/metadataList的metadataList文件中选取的。此文件可以覆盖在:
/apps/fmdita/config/metadataList。