Asciidoctor无法解析格式化文本："​<a数据类型“

Question

我使用以下命令运行asciidoctor：

asciidoctor -r asciidoctor-pdf -b pdf master.asciidoc

它无法解析以下文本：

pass:[<a data-type="xref" data-xrefstyle="ct" href="#m1">#m1</a>]::

有以下错误：

failed to parse formatted text: ​<a data-type="xref" data-xrefstyle="ct" href="#m1">#m1</a>

我怎么才能修好它？

Answer 1

带有后端PDF的Asciidoctor只对文献状态那样的直通语法提供有限的支持。

Asciidoctor不支持任意传递内容。虽然PDF转换器的后端是html，但它只识别一个有限的内联HTML元素子集，这些元素可以映射到PDF (例如，一个强的、em、code )。因此，如果您的内容包含传递块或内联，您很可能需要使用条件预处理器来跳过它们(并做出其他安排)。

虽然上面提到了a标记，但一个小测试表明只支持基本语法。

使用下面的adoc文件。

= test pass

pass:[<em>#m1</em>]

pass:[<strong>#m1</strong>]

pass:[<code>#m1</code>]

pass:[<a href="#m1">#m1</a>]

pass:[<a href="#m1" data-type="xref" data-xrefstyle="ct">#m1</a>]

通过asciidoctor后端运行它会产生与您在问题中已经提到的相同的错误。

$ asciidoctor -r asciidoctor-pdf -b pdf  test.adoc 
asciidoctor: ERROR: failed to parse formatted text: <a href="#m1" data-type="xref" data-xrefstyle="ct">#m1</a>

生成的PDF类似于下面的屏幕截图。正确地转换了简单的<a href="#m1">#m1</a>行。但是，一旦添加了更多属性，它就会失败。这与声明高级html语法不被pdf后端识别的文档同步。

​

​

要生成具有所需通过率的PDF，您可能需要将其转换为普通的asciidoctor并将其输送到wkhtmltopdf。

asciidoctor -o - test.adoc | wkhtmltopdf -  test.pdf

结果使用html外观和感觉，如下图所示，正文文本略小一些。

​

​