将 icons 属性设置为 font 指示 AsciiDoc 处理器从图标字体中选择图标。

Caution
 不是所有的转换器都支持这种模式。如果转换器不支持这种模式，它将回退到图像模式。

启用基于字体的图标

要启用基于图片的图标，您需要在文档头部将`icons`属性设置为`font`值。

= 文档标题
图标字体

这个设置对解析AsciiDoc文档没有影响。它只影响转换器生成的输出。

Important
 在转换为HTML时，需要样式表以确保基于字体的图标能够正常工作。

默认图标字体

默认使用的图标字体由处理器决定。例如，Asciidoctor使用Font Awesome图标字体。您可以在https://fontawesome.com/v4/icons/[Font Awesome图标页面^]上查看可用的Font Awesome图标。在Asciidoctor中使用Font Awesome图标默认情况下需要在线访问。

默认的警示图标

由于警告的名称不一定与图标字体中的图标名称相匹配，因此AsciiDoc处理器必须将警告的CSS类映射到图标名称。

当使用 Font Awesome 作为图标集时，推荐以下映射：

  • 注释 → 信息圆圈

  • 提示 → 灯泡形标志

  • 警告

  • 警告 → 火灾

  • 重要 → 惊叹号圆圈

呼叫编号和字体图标模式

在字体图标模式下，标号 以封闭的数字形式显示。然而，并不使用图标字体来渲染这些字形。相反，它们是通过CSS来进行样式设置的。这样做是为了允许标号的范围是开放式的。