Asciidoctor с внутренним PDF имеет только ограниченную поддержку синтаксиса сквозной передачи, как указано в документации< /а>.
Asciidoctor PDF не поддерживает произвольный транзитный контент. Хотя базовым компонентом конвертера PDF является html, он распознает только ограниченное подмножество встроенных элементов HTML, которые можно сопоставить с PDF (например, a, strong, 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 pdf приводит к той же ошибке, о которой вы уже упоминали в своем вопросе.
$ 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, как показано ниже, с немного меньшим размером основного текста.
person
uroesch
schedule
20.12.2020