asciidoctor

Question

有谁知道在哪里可以获得 Asciidoctor 用户手册的离线版本：https://asciidoctor.org/docs/user-manual/

很奇怪，开发人员如何吹嘘 Asciidoctor 能够导出为 PDF，HTML...但与此同时，他们无法提供一个漂亮的 PDF 文档供离线使用...

Answer 1

您可以从以下位置获取原始 adoc 源：https://github.com/asciidoctor/asciidoctor.org/blob/master/docs/user-manual.adoc 并使用 asciidoctor 进行转换。

随意直接从以下位置获取结果：

https://sqli.dev/asciidoctor/user-manual.pdf（asciidoctor-pdf 在此文档中抛出了一些错误，我没有调查过，所以有些东西可能不会按预期显示）
https://sqli.dev/asciidoctor/user-manual.html（这个html仍然会获取字体、mathjax等在线资源）

您可以使用以下方法来限制所需在线资源的数量：

git clone https://github.com/asciidoctor/asciidoctor.org.git
cd asciidoctor.org/docs
curl -O https://fontawesome.com/v4.7.0/assets/font-awesome-4.7.0.zip
7z x font-awesome-4.7.0.zip
asciidoctor -a !iconfont-remote=@ -a icons=font -a stylesdir=font-awesome-4.7.0/css -a !webfonts=@ user-manual.adoc

生成的用户-manual.html 只会尝试从远程站点获取 MathJax.js。

我建议在 https://github.com/asciidoctor/asciidoctor.org 打开一个问题，建议他们提供离线下载选项。

asciidoctor - 离线用户手册无处可寻

asciidoctor - offline user manual is nowhere to be found