asciidoc-pdf:如何使用自定义样式

Question

如何在asciidoctor-pdf中使用自定义样式(font-size，font-color等)。我已经阅读了主题指南，并尝试在xxx-heme.yml中添加设置，但没有成功。此外，在我的pdf示例中，标记的样式(带有#)也不起作用。

Answer 1

您应该创建自己的YAML主题，然后使用pdf-style选项，如下所示

$ asciidoctor-pdf src/main.adoc -a pdf-style=themes/my-theme.yml

Documentation here

Answer 2

如果您想了解如何在maven构建中使用xxx-theme.yml，可以参考asciidoctor-pdf-with-theme-example项目。它生成两个pdf文件(其中一个使用yml文件样式，并使用默认PDF样式)

Answer 3

如果您希望得到与导出为html或epub3时得到的结果类似的结果，则必须使用自定义样式，因为默认主题不映射来自asciidoc的默认(css/html)样式。

像"my-theme.yml"一样，

• 创建一个带有"-theme.yml“后缀的文件

• 然后插入：

extends: default
  role:
    red: 
      font-color: #c5000c
    maroon:
      font-color: #4f2400
    green:
      font-color: #366251
    navy:
      font-color: #4974a5

在这个yaml中，一定要引用所有的颜色名称及其相应的编码(本例中的编码并不准确)，并像*.adoc文件中的[.green]#SomeTextThatSouldLookGreen#那样使用它们。(为了简单起见，我在这个示例主题中使用了role，但其他方式可能适合您的需求，请参阅theming-guide，它以自定义字体的说明开头)

然后，

• 可以使用命令行选项调用它：

pdf-style=my -pdf src/main.adoc -a pdf-style=themes/my-teme.yml asciidoctor-pdf src/main.adoc -a pdf-style src=./themes -a asciidoctor

或者在源*.adoc文件中插入以下特定于in的标记：

:pdf-theme: themes/pdf-theme.yml