添加网站图标

当使用 Asciidoctor 生成独立的 HTML 文档时（即 standalone 选项为 true），您可以通过在文档头部设置 favicon 属性来指示处理器包含指向 favicon 的链接。

= Document Title
:favicon:

默认情况下，处理器会添加一个类型为“icon”的链接引用，该引用指向一个名为 favicon.ico 的文件（相对于 HTML 文档）。

<link rel="icon" type="image/x-icon" href="favicon.ico">

此引用会添加到 HTML <head> 元素内部（这就是为什么在生成可嵌入的 HTML 文档时此功能不可用的原因）。

要修改图标文件的名称或位置，只需为 favicon 属性赋一个值。

= Document Title
: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

如果您是为了制作网站而转换多个目录中的 AsciiDoc 文件集，并且 favicon 位于共享位置，那么您很可能希望在 favicon 路径的开头使用正斜杠 (/)。

如果您需要更多关于如何声明 favicon 的控制，您应该使用 head docinfo 文件。请注意，如果您在 head docinfo 文件中添加了一个图标链接，并且同时设置了 favicon 属性，那么生成的 HTML 文档中将会有两个图标链接。