Как преобразовать Asciidoc в PDF?

Question

Я попытался преобразовать mybook.adoc в mybook.pdf, используя pandoc, и получил следующую ошибку:

$ pandoc -s mybook.adoc -t asciidoc -o mybook.pdf
pandoc: cannot produce pdf output with asciidoc writer

Есть ли другой инструмент, который я должен использовать вместо * или в сочетании с pandoc?Как я могу конвертировать Asciidoc в PDF?

Answer 1

Теперь я понимаю, что идеальный путь от Asciidoc к PDF - это сначала преобразовать Asciidoc в Docbook.При этом используется предполагаемая сфера asciidoc и конвертер docbook-> pdf, использующий каждый в своей отдельной области интересов.

Кроме того, вместо pandoc я обнаружил, что при включении математических формул легче былоиспользуйте dblatex для преобразования docbook-> pdf.Таким образом, мой конверсионный конвейер выглядит следующим образом:

asciidoc -> asciidoctor -> docbook -> dblatex -> pdf

Пример файла make:

make: my.adoc
  asciidoc -b docbook my.adoc
  dblatex my.xml

На этой странице обсуждения предполагается, что asciidoc в первую очередь предназначен для компиляциив docbook.

Answer 2

Другой рабочий процесс, который я часто использую, - это создание HTML из вашего файла AsciiDoc с помощью процессора AsciiDoctor, связывание пользовательской таблицы стилей CSS с правилами стиля печати:

asciidoctor -a stylesheet=path-to-stylesheet.css file.adoc

Затем можно открыть HTMLфайл в вашем браузере и распечатать в PDF.

Для более сложных стилей, таких как нумерация страниц, верхние и нижние колонтитулы, разрывы страниц и столбцы, вы можете использовать PrinceXML (или другие аналогичные продукты).Это процессор командной строки, который преобразует HTML-файл в PDF, используя правила стиля в CSS, используемые HTML-файлом.PrinceXML применяет правила стилей, которые соответствуют стандарту CSS3, но еще не поддерживаются браузерами, что позволяет создавать макеты с тонким стилем.

Answer 3

Следуя ответу @ Remis, я использовал PDF-файл asciidoctor.

Я не мог понять, как установить asciidoctor-pdf на nixos, но сумел найти следующую альтернативу, которая работала:

asciidoctor -r asciidoctor-pdf -b pdf or asciidoctor-pdf

Answer 4

Предварительные условия : все, что нужно, это Ruby (1.9.3 или выше)

Установить собственный конвертер PDF для AsciiDoc - Asciidoctor PDF :

gem install asciidoctor-pdf --pre

Выполнить :

asciidoctor-pdf mybook.adoc

Вы должны получить файл mybook.pdf в том же каталоге.

Answer 5

Самый простой способ конвертировать документ AsciiDoc в PDF заключается в следующем:

• Открыть AsciiDocLive
• Вставьте документ в редактор и просмотрите предварительный просмотр
• сохранить его как HTML
• Открыть любой онлайн-конвертер HTML в PDF
• Загрузить только что созданный файл HTML
• Конвертировать в PDF и загрузить его.

Готово.

Answer 6

AsciiDoc имеет несколько наборов инструментов для рендеринга PDF-файлов из источника AsciiDoc.Вы можете использовать основанный на Ruby AsciiDoc -> Prawn -> PDF toolchain , разработанный Asciidoctor, или вы можете использовать более старый AsciiDoc -> DocBook -> FOP toolchain .Это процедуры рендеринга / публикации, тогда как Pandoc в основном обеспечивает преобразование и лучше всего подходит для преобразования из одного или другого типа исходного формата.