antora是一个生成html和pdf的工具,要点是asciidoctor不要安装npm版,要用gem安装,具体原因没有详细调查,尝试过程中npm版会提示过时,出现Unable to layout item: JSHandle@node等奇怪问题。

npm install  [email protected]
npm install @antora/pdf-extension
npm install @antora/lunr-extension
npm install nodejieba //need cpp dev # sudo apt install build-essential

sudo yum install ruby # 3.2.3
sudo apt install gem
gem install asciidoctor-pdf
gem install rouge

# npm install @asciidoctor/core !!!nonono
# npm install asciidoctor-pdf  # --legacy-peer-deps !!!nonono

npx antora -v