将 ASCIIDOC 转换为 HTML - 结果文件太大



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

我该怎么做才能从 .adoc 文件创建 html。对我来说,拥有目录很重要。

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

迎接亚当

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

部分问题在于内置的Asciidoctor"HTML5"转换器生成了非常臃肿和非语义标记(除了文档类型之外,它与HTML5没有任何共同之处)。而且内置样式表也好不到哪里去。结果对于浏览器来说很难处理,因此大型文档需要很长时间才能呈现。而且HTML文件也很大,但我不认为这是你70MiB文件的唯一原因。

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

最新更新