使用带有 asciidoctor-pdf 的自定义图标字体

Question

通过执行以下操作，我设法使用自定义图标字体替换 AsciiDoc 中的 FontAwesome。

我已将我的字体文件放在我的 AsciiDoc 根目录中：

• 图标.css
• 字体/图标.eot
• 字体/图标.svg
• 字体/图标.ttf
• 字体/图标.woff

我在 AsciiDoc 文档中设置了以下属性：

:icons: font
:iconfont-remote!:
:iconfont-name: icons

该图标在 HTML 输出和 VS 代码插件预览中正确呈现。但是，从 asciidoc 创建 pdf 时，图标不会出现。我使用此命令生成 pdf：

bundle exec asciidoctor-pdf book.adoc -o out/book.pdf

我收到此错误（未呈现图标）：

asciidoctor: WARNING: my-icon is not a valid icon name in the fa icon set

asciidoctor-pdf 是否需要以某种方式指向自定义图标字体？我曾尝试在文档中寻找答案，但找不到任何答案（事实上，使用 HTML 进行这项工作也需要一些实验）。

Answer 1

asciidoctor-pdf 对于图标字体没有 asciidoctor 那样的灵活性，请参阅https://docs.asciidoctor.org/pdf-converter/latest/icons/#font

基于图标的字体由 prawn-icon gem 处理。

如果您想使用其中一个可用的集合，您需要设置:icons: 和:icon-set: 文档属性，最好从命令行设置，这样您就不会与HTML 转换发生冲突。

asciidoctor-pdf -a icons=font -a icon-set=fas sample.adoc

可用的字体有：

• fa - Font Awesome 4（默认，已弃用）
• fas - 字体真棒 - 纯色
• fab - 字体真棒 - 品牌
• far - 字体真棒 - 常规
• fi - 基础图标
• pf - 付款字体（已弃用）