图标是一种有用的方式，可以在视觉上传达信息，同时消除可能分散主要文本注意力的文字。图标还能为您的文档增添一些装饰效果。在AsciiDoc中，有许多方式可以通过图标来装饰文档的输出（对于支持此功能的后端）。

对于某些元素，当启用时处理器会自动添加图标，如提醒图标。您也可以使用特殊标记直接在内容中添加图标。

这一部分将向您展示如何启用图标，涵盖了各种图标模式，并向您介绍了图标宏，用于将自定义图标添加到您的内容中。

启用图标

有三种图标模式：文本、图像和字体。

输出中包含图标是通过使用`icons`文档属性来控制的。默认情况下，此属性未设置。因此，所有图标都以文本形式显示。在文本图标模式下，图标实际上是被禁用的。

为了启用图标，请在文档头部设置 icons 属性。

= 文件标题
图标

icons` 属性的有效值如下：

图像（或空白）

图标通过`iconsdir`属性指定的目录解析为图像文件。

字体

图标是从图标字体库（如 Font Awesome）中加载的。并不是所有的后端都支持这种模式，比如 DocBook。

图标被使用的地方

设置 icon 属性将在以下位置开启图标：

  • 警告标签被图标替换（即，警告图标）

  • 图标宏

  • 呼叫号码

接下来的页面将会更深入地覆盖这些图标模式。