Asciidoctor не может разобрать форматированный текст: "<тип данных
Я запускаю 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>
Как я могу это исправить?
Ответы 1
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, как показано ниже, с немного меньшим размером основного текста.
Используют ли они переходы для определения некоторых атрибутов замены символов? Я получаю сообщение об ошибке «не удалось разобрать форматированный текст», просто запустив: asciidoctor-pdf -o - - <<< 'foo {amp} bar' > /dev/null (но другие, например {vbar}, работают как положено. Может быть, это ошибка?)
На случай, если это поможет кому-то еще: я также видел эту ошибку, когда есть URL-адрес, который заканчивается кавычкой, например
my favorite site is "https://stackoverflow.com"