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

Question

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

奇怪的是，开发人员如何吹嘘Asciidoctor能够导出到PDF，HTML.但同时他们没有提供一个很好的PDF文档供脱机使用..。

Answer 1

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

可以直接从以下网站获取结果：

• https://sqli.dev/asciidoctor/user-manual.pdf (Asciidoctor)在这个文档中抛出了一些错误，我还没有对此进行调查，所以有些东西可能不会显示为intended)
• 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上打开一个问题，建议他们提供离线下载选项。