当使用Asciidoctor生成独立的HTML文档（即`standalone`选项为`true`时），你可以通过在文档头部设置favicon属性来指示处理器包含一个指向favicon的链接。
= 文档标题 :favicon:
默认情况下，处理器会添加一个类型为“icon”的链接引用，它引用一个名为_favicon.ico_的文件（相对于HTML文档）。
<link rel="icon" type="image/x-icon" href="favicon.ico">
这个引用被添加到HTML的`<head>`元素中（这也解释了为什么在生成嵌入式HTML文档时，这个功能不可用）。
要修改图标文件的名称或位置，只需给favicon属性赋一个值即可。
= 文档标题 :favicon: ./images/favicon/favicon.png
这将生成以下HTML元素：
<link rel="icon" type="image/png" href="./images/favicon/favicon.png">
请注意，图片的mimetype会根据文件扩展名自动设置。
iconsdir` 属性的值不会像内容中的图标那样前置到 favicon 路径中。如果你想在 favicon 路径中包含这个目录，你必须显式地引用它：
:favicon: {iconsdir}/favicon.png
|
Tip
|
如果你为了创建网站而将多个目录中的一组AsciiDoc文件转换，并且网站图标（favicon）位于一个共享位置，那么你很可能想要在网站图标的路径前面使用正斜杠（/）。
|
如果您希望对如何声明网站图标有更多的控制权，您应该使用一个头部文档信息文件。请记住，如果您在头部文档信息文件中添加了一个图标链接，同时也设置了favicon属性，那么在生成的HTML文档中将会出现两个图标链接。