Add index for Asciidoc Book

目前 Asciidoctor 默认的 HTML5 引擎还不支持生成索引，要看索引效果，只能生成 PDF 或者 DocBook 文件。下面是生成 PDF 文件的过程。

首先安装 Asciidoctor PDF: gem install asciidoctor-pdf --pre。

创建字体定义文件：

cat << EOF > pdf-fonts.yml
extends: default
font:
  catalog:
    Noto Serif:
      normal: notoserif-regular-subset.ttf
      bold: notoserif-bold-subset.ttf
      italic: notoserif-italic-subset.ttf
      bold_italic: notoserif-bold_italic-subset.ttf
    M+ 1mn:
      normal: mplus1mn-regular-ascii-conums.ttf
      bold: mplus1mn-bold-ascii.ttf
      italic: mplus1mn-italic-ascii.ttf
      bold_italic: mplus1mn-bold_italic-ascii.ttf
    WenQuanYi:
      normal: /usr/share/fonts/truetype/wqy/wqy-microhei.ttc
      bold: /usr/share/fonts/truetype/wqy/wqy-zenhei.ttc
      italic: /usr/share/fonts/truetype/wqy/wqy-microhei.ttc
      bold_italic: /usr/share/fonts/truetype/wqy/wqy-microhei.ttc
  fallbacks:
  - WenQuanYi
EOF

其中前两段 Noto Serif 和 M+ 1mn 都是 asciidoctor pdf 自带的，最后的文泉驿字体的路径通过 fc-list|grep wqy 确定，如果还没有安装此字体，用 apt search wqy 查找后安装。

将正文中的关键词用双括号括起来，在文末加上索引章节：

[index]
= 索引

最后执行 asciidoctor-pdf -a pdf-style=./pdf-fonts.yml book.adoc 生成 PDF 文件就可以了。

参考：

Add index for Asciidoc Book

Published

Last Updated

Category

Tags

Contact