AsciiDoc/AsciiDoctor 文档中图像尺寸的度量单位

Question

文档和 Google 搜索结果的前三页都没有说明 AsciiDoc 文档中图像的度量单位是什么。这是一个重要的话题，因为 AsciiDoc 既可以转换为 HTML（原始单位是像素）也可以转换为 PDF（原始单位是 cm 或 pt）。

那么，有人可以回答和/或在文档中添加关于以下内容的部分：

• 当我写image::path/to/image.png["Caption",300,200]时，那些300和200是什么？像素？
• 当我从 AsciiDoc 文档生成 PDF 时，如果我们使用像素，它使用什么 DPI？我可以在某些配置设置中控制它吗？
• 如果这些尺寸是在一些抽象单位中，那么在这些单位中 HTML 和 PDF 页面的宽度是多少？
• 有没有办法用图像制作与输出无关的 AsciiDoc 文档？我不希望两种格式都有像素完美的相同布局，但至少保留图像的相对大小会很好。

我将asciidoctor -b html 用于HTML 输出，asciidoctor-fopub 用于PDF。在asciidoctor-pdf 至少支持与 fopub 相同的功能集之前，我不会使用它。

先谢谢你了。

Answer 1

对于 html，它是像素：https://github.com/asciidoctor/asciidoctor/blob/master/lib/asciidoctor/converter/html5.rb#L520-L523

对于 pdf，我不太确定，但它可能取决于 Apache FOP，因为这就是正在使用的。 xslt 似乎表示没有任何缩放的英寸。您必须深入研究整个混乱，才能真正弄清楚正在使用什么以及如何修改它。