将asciidoc转换为html - 太大的结果文件

时间:2017-11-09 13:32:15

标签: asciidoc asciidoctor

我用Asciidoc创建了大量文档。 它包含大约600个.adoc文件。 当我将此文档保存为html文件时,我获得了~70MB的文件。这是大文件。

如何从.adoc文件创建htmls。有目录对我来说很重要。

我找到了asciidoc的插件(https://gist.github.com/mojavelinux/d94372393950ca76d594),但它没有正常工作

电贺, 亚当

1 个答案:

答案 0 :(得分:1)

生成的HTML文件如何显示?它不包含重复的样式表或类似的内容吗?

部分问题是内置的Asciidoctor“HTML5”转换器会产生非常臃肿和非语义的标记(除了doctype之外,它与HTML5没有任何共同之处)。内置的样式表并不是更好。结果很难为浏览器处理,因此大文档需要很长时间才能呈现。 HTML文件也很大,但我认为这不是你的70MiB文件的唯一原因。

您可以尝试替代转换器asciidoctor-html5s。它生成更清晰的标记,主要关注正确的语义,可访问性和与常见的排版CSS样式的兼容性。但是,我还没有完整的样式表,而且它不能(不能)与Asciidoctor内置样式兼容。