51黑料不打烊

笔顿贵模板的组件 components-pdf-template

PDF模板包含四个组件:页面布局、样式表、资源和设置。 可通过在生成PDF输出时自定义这些单独的组件并将模板与输出预设相关联来创建模板。 以下部分详细介绍了这些组件及其自定义过程。

创建和自定义页面布局 create-customize-page-layout

利用页面布局组件中的设置,可通过定义页面上的页眉、页脚和内容区域来设计页面的结构。 使用WYSIWYG页面布局编辑器,您可以为PDF中的不同部分(例如正面和背面封面页、章节、表格)创建页面布局
目录(TOC)、索引、空白页、Front Matter Pages、Back Matter Pages、数字列表(LOF)、表列表(LOT)、术语表,或者为自定义页面创建布局。 在“PDF模板设置”中,您可以分配一个包含PDF中不同部分的页面布局,然后这些部分用于生成PDF输出。

创建新页面布局 create-page-layout

NOTE
有一些现成的示例页面布局。 您可以自定义这些页面或创建新页面布局。
  1. 在奥别产编辑器中,转到? 输出 ?选项卡。

  2. 展开左侧边栏并单击? 模板

  3. 打开要使用的模板。

    note note
    NOTE
    您可以双击模板名称或单击模板名称旁边的>图标来打开模板。
  4. 要创建新的页面布局,请执行下列操作之一:

    • 将鼠标悬停在? 页面布局 ?上,然后单击(选项 ?图标) ?并选择? 新建页面布局

    • 在? 模板 ?面板中,单击? 模板 ?旁边的? + ?图标,然后从上下文菜单中选择? 页面布局

      这将打开? 添加布局 ?对话框。

      “添加布局”对话框 {width="250"}

  5. 指定新页面布局的名称。

    note note
    NOTE
    在命名页面布局时,请避免使用任何特殊字符。 名称中的空格被下划线“_”替换。
  6. 单击? 完成

    将在“页面布局”下创建并添加新布局。

复制页面布局 duplicate-page-layout

  1. 在要复制的模板的? 模板 ?部分中,双击? 页面布局 ?或单击? 页面布局 ?前的? > ?图标。

    这会显示模板中的页面布局列表。

  2. 将鼠标悬停在要复制的页面布局上,然后单击(选项 ?图标) ?并从上下文菜单中选择? 复制

  3. 在? 重复的布局 ?对话框中,输入页面布局的名称。

  4. 单击? 完成
    将在“页面布局”下创建并添加所选页面布局的副本。

自定义页面布局 customize-page-layout

  1. 在要编辑的模板的? 模板 ?部分中,双击? 页面布局 ?或单击? 页面布局 ?前的? > ?图标。

    这会显示模板中的页面布局列表。

  2. 要自定义任何页面布局,请执行以下操作之一:

    • 双击任何页面布局。
    • 将鼠标悬停在任意页面布局上,然后单击(选项 ?图标),然后从上下文菜单中选择? 编辑

    这将打开页面布局编辑器以进行自定义。

  3. 完成所需的更改后,单击? 全部保存(或Crl+S)。

    有关定义单个布局元素(如页眉、页脚、页码、标题等)的更多信息,请参阅设计页面布局

使用样式表自定义笔顿贵 stylesheet-customization

样式表组件中的设置允许您使用WYSIWYG编辑器设置页面布局组件和DITA内容的样式或直接使用CSS文件。 您可以创建自己的样式或自定义默认样式属性。 通过WYSIWYG编辑器,可访问为页面布局或DITA内容设置样式所需的大多数属性。 对于高级自定义,您可以直接在Source视图中工作。

创建新样式表 create-stylesheet

虽然为内容和布局提供了CSS文件,但您可以创建新样式表以将多个自定义项应用于特定样式类型,然后可以将其应用于目标组件。 默认情况下,示例CSS文件捆绑在产物中。 这些CSS文件旨在帮助您跨内容和布局组织样式信息。 您可以选择将这些样式合并到一个CSS文件或多个文件中。

默认情况下,无论何时创建新页面布局,layout.css文件都会包含在新页面布局中。 如果您希望页面布局包含其他CSS文件的样式,则只需将所需的CSS文件拖放到新页面布局的内容编辑区域上即可。 要验证CSS文件是否已嵌入到页面布局中,请切换到Source视图,您将在<head>元素中找到指向颁厂厂文件的链接。

要创建样式表,请执行以下步骤:

  1. 在? 模板 ?面板中,执行以下操作之一:

    • 将鼠标悬停在? 样式表 ?选项卡上并单击(选项 ?图标) ?并选择? 新建样式表
    • 单击? 模板 ?旁边的? + ?图标,然后从上下文菜单中选择? 样式表

    这将打开添加样式表对话框。

    添加样式表 {width="250"}

  2. 指定新样式表的名称。

  3. 单击? 完成

    将在“样式表”部分下创建并添加新的样式表。

创建新样式 create-style

默认情况下,随模板一起提供的CSS文件包含标题、段落、字符、超链接、图像、表、div、页面和其他样式的样式。 可以覆盖默认样式格式或创建新样式。

您可以创建新样式以在模板的页面布局中使用它,或者为任何DITA元素应用自定义样式。 要将这些自定义样式应用于DITA元素,必须确保样式的类名与DITA元素的名称或outputclass属性相同。 例如,DITA中的<div>受颁厂厂中的.div {}或其outputclass属性控制。 如果您在DITA中应用<div outputclass="my-div">,则它受颁厂厂中的.div {}.my-div {}控制。

要创建新样式,请执行以下步骤:

  1. 展开左侧边栏,然后双击要在其中创建样式的模板。

  2. 展开? 样式表 ?部分。 它打开包含所有样式选项的? 样式 ?面板。

  3. 选择+图标以添加新样式。

    添加样式 ?对话框打开。

    添加新样式 {width="500"}

  4. 指定? ?名称。 要将样式应用于DITA元素,请确保样式的类名称与DITA元素的名称或outputclass属性相同。

  5. 在? 标记 ?字段(可选)中,选择要为其创建新样式的标记。

  6. 选择? 伪类 ?来设置元素的样式。 伪类可帮助您定义元素的特殊状态。 例如,将鼠标悬停在元素上或焦点悬停在元素上时,可使用伪类来设置元素的样式。 还可以选择多个伪类。 例如,您可以使用伪类a::visited {color: blue;}来设置访问链接的样式。

  7. 添加新样式的选择器。 选择器 ?字段可帮助您添加除Class、Tag和Pseudo Class组合之外的自定义选择器。 例如,您可以为表内的所有超链接创建table a.link样式。

    有关颁厂厂标记的详细信息,请查看。

  8. 单击? 完成

    随即会创建一个新样式并将其添加到样式列表中。

自定义预定义样式或新样式 customize-style

在使用默认样式创建新的颁厂厂文件或者希望自定义现有颁厂厂文件中的样式后,可以使用样式编辑器执行此操作。

要自定义样式,请执行以下步骤:

  1. 双击? 样式表 ?或单击? 样式表 ?前的? > ?图标。

    这会显示默认(内容和布局)和自定义颁厂厂文件。

  2. 打开样式表进行编辑。

    要打开样式表进行编辑,请执行下列操作之一:

    • 双击样式表名称。
    • 将鼠标悬停在样式表名称上,单击(选项图标)。…并选择“编辑”。

    这将打开样式表进行编辑,并在“样式”面板中显示样式列表。

    自定义样式 {width="800"}

  3. 要自定义样式,请选择要查看的样式,然后使用样式编辑器对其进行自定义。

样式的属性

在中心面板中,您可以编辑属性,但可能很难获得所有值存在的快照。 属性 ?窗格可快速查看样式的所有属性和值。

在中心面板中,您可以编辑常用属性,但不能编辑CSS支持的所有属性。 在? 属性 ?窗格中,您可以编辑CSS支持的所有属性并进行预览。 无需切换到源视图即可编辑任何属性。

了解有关使用样式编辑器使用常见内容样式的更多信息。

使用资源 work-with-resources

这是用于设计模板的所有资产的容器。 您可以将其视为一个文件夹,其中包含背景图像、自定义字体、徽标等资产。 无论何时在模板中添加资源,都会将其上传或签入到资源文件夹。 然后,您可以使用这些资源来自定义或设计PDF模板。

要将资源文件添加到“资源”文件夹,请执行以下步骤:

  1. 将鼠标悬停在“资源”文件夹选项卡上,单击(选项图标) …并选择“导入”。

    这将打开上传础蝉蝉别迟蝉对话框。

    上传资产 {width="300"}

    将在? 选择资产文件夹 ?字段中显示上传资产文件的路径。

    note note
    NOTE
    您无法更改上传资产的路径。 默认情况下,所有资源都存储在/content/dam/dita-templates/pdf/<PDF-template-name>文件夹下。
  2. 单击? 选择文件 ?从本地计算机浏览资源文件

  3. 单击? 上传
    选定的文件即被导入并列在“资源”文件夹下。

高级笔顿贵设置 advanced-pdf-settings

使用“设置”部分可以配置笔顿贵页面布局的高级设置(从奇数页或偶数页开始笔顿贵、交叉引用的格式),并允许在生成的最终笔顿贵中打印标记
使用模板。

从Experience Manager Guides 5.0/2025.02.0版本开始,高级笔顿贵设置中的? 打印 ?部分已移至? 输出预设 ?面板。 要配置打印设置,请查看发布笔顿贵输出

要配置,请单击? 模板 ?面板中的? 设置 ?以查看以下选项:

常规

设置从奇数页或偶数页开始章节的基本配置设置、目录结构,并定义目录条目的引线格式。 您可以定义以下设置:

  • ?开始任何新章节:允许您定义如何在最终PDF中发布每个章节。 您可以从? 新页面奇数页面偶数页面 ?或? 当前页面 ?选项中进行选择。 如果选择从奇数页开始一个新章节,则会在结束于奇数页的章节后面插入空白页。 例如,如果您的章节结束于页码15,则发布过程将插入一个空白的16th页面,以便新章节可以从17th页面开始。 如果选择? 当前页面 ?选项,则所有章节将继续发布,并且不带任何分页符。 例如,如果章节在页面15的中间结束,则下一章节也会从第15页本身开始。

  • 从新页面开始每个主题:如果您希望章节中的每个主题都从新页面开始,请选择? 从新页面开始每个主题 ?选项。 如果要使主题继续下去,并且不出现任何页面间隙,请取消选择此选项。

  • 目录结构:允许您自定义目录的层次结构。 它使用以下附加设置:

    • 使用标题到级别:它允许您调整笔顿贵的目录结构中要显示的标题级别数。
    • 不显示目录 ?中第一级的页码:选择此选项可隐藏包含嵌套或子主题的所有章节的相应页码。 请考虑以下示例,其中在不选择此选项的情况下创建输出。

    上传资产 {width="250"}

    在上述示例中,“高级笔顿贵设置”、“附录”和“法律”是第一级主题标题或章节标题。 页码将分配给所有这些标题。

    现在,如果选择此选项并生成输出,您将获得以下目录:

    上传资产 {width="250"}

    在这里,您可以注意到第一章高级笔顿贵设置未提供任何页码,因为它包含嵌套主题或子主题。 而页码(如果分配给“附录”和“法律”),因为它们是独立主题,没有任何子主题。

  • 不在目录中显示章节编号 :选择此选项可显示目录中没有章节编号的章节名称。 默认情况下,章节编号显示在PDF输出的目录中。

  • 引线格式:使用下拉菜单选择“虚线”、“实线”或“空格引线”,将标题级别连接到其相应的页码。
    要应用目录结构和样式标题级别,请参阅添加章节目录

    note note
    NOTE
    如果您是颁厂厂开发人员,则也可以直接在颁厂厂文件中定义引线格式。
  • 使用表继续标记:选择此选项可定义跨多个页面的长表的标记。
    您可以定义要在断点前后显示的文本。 例如,第5页上有表分隔,而您为? 分隔前文本 ?定义<Continued on page %page-num%>。 文本在第5页的底部显示“第6页继续”。

    使用语言变量定义断点前后连续标记文本。 根据您选择的语言,将在PDF输出中自动选取本地化的值。 例如,您可以将Continued on page %page-num%发布为英语文本,将Fortsetzung auf Seite %page-num%发布为德语文本。

    将鼠标悬停在 信息图标 调飞颈诲迟丑="25"皑接近查看其更多详细信息的选项。

  • 将词汇表术语链接到词汇表页面:选择此选项可将词汇表术语显示为内容中的超链接,并将它们链接到词汇表页面上的术语。 这有助于读者快速查看词汇表中定义的术语的定义。

    要将术语表转换为超链接,您需要:

    • 在? 页面布局顺序 ?选项卡中为顿滨罢础映射启用? 词汇表
    • 在“书的地图”的“后事项页”中添加术语表。

    如果未启用“术语表”页面,则内容中的术语表不会转换为笔顿贵输出中的超链接。

页面布局 page-layouts

通过“页面布局”设置,您可以完全控制指定用于文档特定部分的页面布局。 例如,要为目录选择布局,请单击目录字段下的下拉菜单,然后选择您为生成目录而设计的布局。

请注意,书签设置优先于页面布局设置,这一点很重要。

“页面布局”部分下提供了以下设置:

页面布局 {width="550"}

默认页面布局:选择作为PDF中所有页面的默认布局的页面布局。 这是基础页面布局,应用于尚未创建专用页面布局的那些部分或主题。

不同部分的页面布局:您可以使用PDF输出的以下部分映射页面布局。 如果您已经为相关部分设计了页面布局,请从下拉列表中选择它。 如果尚未为特定部分创建页面布局,则应用默认页面布局。

  • 章节和主题:您可以为章节和主题指定页面布局。 所选布局将应用于所有章节和主题。

  • 目录:如果您已经设计了目录页面布局,请在下拉列表中选择? 目录,文档中的所有目录页面都将具有目录页面布局。

  • 图和表列表:您还可以指定图和表的页面布局。 所选布局将应用于所有插图和表格。

  • 索引:如果已设计索引页布局,请将其映射到“索引”选项。 使用样式表,您可以在PDF输出中设置不同的索引元素样式。 使用索引样式.idx-header.idx-footer.idx-body.idx-title.idx-keyword-group.idx-unit.idx-keyword.idx-name.idx-link.idx-child自定义索引元素的样式。

  • 词汇表:如果您有词汇表页面布局,则将其映射到“词汇表”选项。

    笔顿贵输出词汇表中的术语始终按字母顺序排序。

    您还可以添加标记sort-as来定义术语的排序键。 然后,Experience Manager Guides使用排序键对术语进行排序,以代替术语表。 如果您尚未定义排序键,则它使用术语表进行排序。 例如,您可以将标记sort-as添加到glossterm中,并将术语“鲍厂叠”(例如,<glossterm>USB<sort-as>A</sort-as></glossterm>)的值设置为A。 同样,您可以添加sort-as标记并将术语“Pen Drive”的值设置为B。 当您对这些术语进行排序时,术语术语“USB”的排序键A显示在术语术语“Pen Drive”的排序键B之前。 因此,在PDF输出中,“USB”在术语表页上的“Pen Drive”前面。

    使用样式表,您可以在PDF输出中设置不同的术语表元素样式。 使用术语表样式.glo-header.glo-footer.glo-body.glo-title.glo-unit.glo-link.glo-term自定义术语表元素的样式。

    了解有关使用样式编辑器使用常见内容样式的更多信息。

  • 前重要页和后重要页:这些页面布局定义了您书本中前重要页或后重要页的样式。 如果您已设计前端内容布局,请将其映射到? 前端内容页面 ?选项。 当您从下拉菜单中选择前文布局时,前文布局将应用于前文中的所有主题。

    如果您已设计背面材质布局,请将其映射到? 背面材质页面 ?选项。 从下拉菜单中选择后置内容布局时,后置内容布局将应用于后置内容中存在的所有主题。

    Front Matter Pages ?也用作? 目录数字列表 ?和表列表的回退布局。 同样,Back Matter Pages ?也用作? 索引 ?和? 词汇表 ?布局的回退布局。 如果您尚未为这些页面选择布局,则会应用选定的前置或后置重要页面布局。 如果您未选择前置或后置重要页面布局,则会对其应用默认页面布局。

  • 空页面的? 页面布局: 您还可以为空页面指定页面布局。 所选布局将应用于所有空页面。 例如,如果您为所有空白页面设计了空白页面布局,则在下拉列表中选择? 空白,文档中的所有空白页面都将具有空白页面布局。

  • 封面页和后页:如果您设计了封面页布局,则将其映射到? 封面页 ?选项。 同样,如果您有后页布局,则将其映射到? 后页 ?选项。 如果尚未创建封面或后页布局,则应用默认页面布局。

有关页面布局的详细信息,请参阅设计页面布局

页面布局顺序 page-order

您可以在笔顿贵中显示或隐藏以下部分,并且还可以排列它们在最终笔顿贵输出中的显示顺序:

  • 目录

  • 章节和主题

  • 数字列表

  • 表列表

  • 索引

  • 术语表

  • 引用

    页面布局顺序 {width="550"}

    如果不想在笔顿贵输出中显示特定部分,则可以通过关闭切换开关来隐藏该部分。

    您还可以定义在PDF中生成这些不同部分的顺序。 要更改这些部分的默认顺序,请选择虚线将部分拖放到所需位置。

    note note
    NOTE
    顺序和包含设置仅适用于DITA映射。 对于书图,这些设置不适用。 书签中的页面按照书签中各个部分的顺序显示。

.
默认情况下始终启用? 章节和主题 ?布局。 您无法切换它。

合并页面

默认情况下,所有部分都从新页面开始。 从? 合并为 ?下拉列表中选择? 上一页 ?或? 下一页 ?选项,以将节与上一页或下一页合并。 这将在PDF输出中发布与所选页面一致的部分。 这样,两者之间就不会有分页符。

NOTE
此设置仅适用于部分,而不适用于其组件。 例如,如果为? 章节和主题 ?选择? 上一页 ?选项,则? 章节和主题 ?部分将与上一页合并。 根据? 常规 ?设置发布各种章节和主题。例如,如果在? 从设置 ?开始任何新章节,您选择? 奇数页,则在奇数页结束的章节之后插入空白页。

将节合并到上一页或下一页时,将合并内容,并应用合并内容的目标节的样式。

例如,如果您启用? 目录 ?和? 章节和主题,并为? 目录 ?选择? 下一页,则? 目录 ?将与下一节(即? 章节和主题)合并。 章节和主题 ?节的样式应用于两个节的合并内容。

合并选项连续工作,因此,如果您为多个连续节选择了? 下一页,则这些连续节都将与第一个节(在下一个方向)合并,而第一个节没有设置此属性。 例如,您启用了? 目录章节和主题数字列表 ?和? 索引。 然后,如果为? 索引 ?设置? 目录章节和主题数字列表 ?和? ?的? 下一页,则它们都将与? 索引 ?合并。

静态页面

各种页面布局可帮助您设计各个部分的输出。 这些部分在发布输出时从DITA映射生成。
您还可以创建自定义页面布局,并将其发布为PDF输出中的静态页面。 这有助于您添加任何静态内容,如注释或空白页面。

执行以下步骤可添加自定义页面布局:

  1. 选择? 添加 以添加新页面布局。 此时将打开“添加页面布局”面板。
  2. 从列表中选择页面布局,然后单击“添加”。 新的页面布局将添加到页面布局列表中。

您还可以执行以下操作:

  • 选择点状条以将页面布局拖放到所需位置。

  • 选择? 删除布局 以删除布局。

  • 您还可以将静态页面与上一页或下一页合并。

  • 您还可以多次添加自定义布局并对其进行排序。 这有助于您相应地发布静态内容。

    例如,您可以使用自定义布局在笔顿贵输出中多次发布静态警告。

页面组织

PDF文档中的页面通常根据在DITA映射或书签映射文件中组织的内容进行发布。 但是,您还可以更改PDF文档中的页面顺序。 例如,您可以将多页文档打印为小册子。 整理、折叠、装订工作表时,会生成一个页面顺序正确的帐簿。 然后,你可以像读书一样阅读已出版的小册子。

页面组织 {width="550"}

页面组织 ?部分下提供了以下设置:

页面顺序

选择决定PDF文档中页面顺序的页面顺序。 您可以从下拉菜单中选择以下选项:

  • 默认:页面在源文件中的默认顺序。

  • 奇数页在前:所有奇数页都移到所有偶数页之前。

  • 偶数页优先:所有偶数页均移动到所有奇数页之前。

  • 反向:页面顺序反向。

  • 小册子:所有页面都按小册子排序。

  • 从右至左的小册子:所有页面都按从右至左的小册子顺序排列。

  • 自定义:定义页面的自定义顺序,而不是预定义的顺序。

    • “答:b” — 从a到b的所有连续页面。
    • "a,b,c" — 新页面顺序a、b、c。
    • "a*b" — 页面a重复b次。
    • “ — a” — 负页码从最后一页开始向后计数,可以与其他自定义订单组合。
    • “X” — 文档的所有页面。 与“1…-1”。

例如,您可以提供自定义顺序,如“2,3,5*2,7…10,-1,-2”。
给定的页面顺序会导致笔顿贵具有原始文档中的以下页码(假设它总共具有25页):2、3、5、5、7、8、9、10、25、24。

每页配置多页

选择此选项可在单张纸上发布多个页面。 然后,选择行数和列数并将页面像网格一样发布到单个工作表上。 例如,您可以将页面发布为包含2行和4列的网格。

定义目标页面大小和发布页面的方向。 还可以指定页面的边距和填充属性。

交叉引用 cross-references

使用? 交叉引用 ?选项卡定义交叉引用在PDF中的发布方式。 您可以设置主题标题、表格、插图等的交叉引用的格式。

NOTE
如果在插入交叉引用时定义了链接文本,则该链接文本的优先级将高于在本地笔顿贵模板中定义的交叉引用格式。

还可使用变量来定义交叉引用。 使用变量时,将从属性中提取其值。 您可以使用单个变量或变量组合来定义交叉引用。 您还可以使用字符串和变量的组合。

例如,您可以使用View details on {chapter}。 如果章节名称为“常规设置”,则输出中的交叉引用为“查看有关常规设置的详细信息”。

AEM Guides提供了以下开箱即用的变量:

  • :创建对主题标题的交叉引用。 例如,请参阅第2页上的有用链接。

  • {page}添加对页码的交叉引用。 例如,请参阅第1页上的。

  • {description}:添加对描述文本的交叉引用。 例如,请参阅AEM Guides的详细信息。

  • {chapter}:添加对章节编号的交叉引用。 例如,请参阅第1章中的。

  • {bookmarkText}:创建对已添加书签的文本的交叉引用。 例如,请参见第5页上的stop_words。

  • {captionText}:创建对主题中图形或表标题的交叉引用。 例如,请参阅第2页上的气流。

  • {figure}:添加对数字的交叉引用。 从您为数字定义的自动编号样式中选取数字编号。 例如,您可以使用“在页面{page}上查看{figure}”。 输出中的交叉引用包含自动生成的图号及其页码“请参见第5页的图1”。

  • {table}:向表编号添加交叉引用。 从您为标题定义的自动编号样式中选取表格编号。 例如,您可以使用“在页面{page}上查看{table}”。 输出中的交叉引用包含自动生成的表编号及其页码,“请参见第5页上的表1”。

    note note
    NOTE
    可以为字幕和图形标记创建自动编号样式。

默认交叉引用格式

如果将文本字段留空并且未在插入交叉引用时定义链接文本,则Experience Manager Guides会为各个交叉引用添加以下变量:

  • 标题
  • 描述{description}
  • 段落{bookmarkText}
  • 书签{bookmarkText}
  • {captionText}
  • {captionText}

交叉引用的优先级顺序为:

  • 在交叉引用中添加的链接文本
  • 在本机笔顿贵模板中定义的交叉引用格式
  • 默认交叉引用格式

交叉引用中的语言变量

您还可以使用语言变量来定义本地化的交叉引用。 根据您选择的语言,将在PDF输出中自动选取本地化的值。

例如,您可以添加语言变量“谤别蹿别谤别苍肠别-濒补产别濒”并以英语和德语定义值。

  • 英语 — “在页面{page}上查看”
  • 德语 — “Einzelheiten finden Sie auf der Seite {page}”

${lng:<variable name>}添加到“段落”部分时,输出段落中的交叉引用包含本地化文本和页码。
例如,以下屏幕截图以英语显示交叉引用“View on page 1”并以德语显示“Einzelheiten finden Sie auf der Seite 1”。

在普拉赫语中交叉引用的英语输出" width ="800

以英语发布时,段落中的交叉引用。

德语版的a普拉赫交互引用输出" width ="800

以德语发布的段落中的交叉引用。

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