Используйте Pandoc для легкого преобразования текстового файла в формат PDF или электронной книги

В последней статье мы узнали, как Markdown может быстро помочь вам создать чистый HTML-код для использования на веб-сайте или в блоге. Но что, если вы также хотите создать электронную книгу, используя тот же контент, что и в Интернете? Хотя набор инструментов Markdown предназначен для создания веб-контента, существует еще один инструмент, который позволяет вам использовать Markdown и превращать его в документы OpenOffice/LibreOffice, PDF-файлы или даже электронные книги, подходящие для Kindle или другой электронной книги, — Pandoc.

Установить пакет pandoc в системе Ubuntu очень просто с помощью следующей команды:

sudo apt-get install pandoc

После установки вы можете сразу использовать Pandoc вместо Markdown для создания HTML с помощью следующей команды:

pandoc -r markdown -w html -o *yourfilename*.html *yourfilename*.md

Синтаксис и флаги следующие:

• "-r" - формат чтения
• "-w" - формат записи
• "-o" - имя файла вывода

Приведенная выше команда считывает файл уценки и выводит файл в формате HTML с тем же именем.

В приведенном выше примере файл выводится в формате HTML, но вы можете использовать Pandoc для создания и других форматов.

Текстовый формат открытого документа (ODT)

Если вам понадобится обмениваться документом с людьми, использующими более общий офисный пакет, например OpenOffice/LibreOffice или Microsoft Office, вы можете преобразовать его в формат ODT с помощью Pandoc. Если вы думаете, что будете делать это часто, полезно заранее настроить шаблон. Во-первых, создайте простой документ (например, заголовок и пару строк текста) в Markdown и преобразуйте его в ODT с помощью следующей команды:

pandoc -r markdown -w odt -o pandoctemplate.odt *yourfilename*.md

Затем откройте файл «pandoctemplate.odt» в Open/LibreOffice, чтобы изменить шрифты, интервалы, поля и т. д. по своему вкусу. Обязательно используйте стили для настройки — некоторые подробности об использовании стилей можно найти здесь. Как только ваш документ будет настроен по вашему вкусу, вы можете использовать его в качестве шаблона для создания файлов ODT из Markdown в будущем, добавив его в приведенную выше команду:

pandoc -r markdown -w odt --reference-odt=pandoctemplate.odt -o *yourfilename*.odt *yourfilename*.md

Теперь, когда вы конвертируете файл Markdown в ODT, он автоматически форматируется с использованием стилей, которые вы создали ранее. Pandoc также поддерживает преобразование в новый формат Microsoft Word (версии 2007 и более поздних версий) с флагом «--reference-docx=templatefile.docx».

Портативный формат документов (PDF)

Когда мне нужно сгенерировать PDF-файлы из Markdown, я чаще всего конвертирую их ODT и использую либо функцию экспорта в PDF LibreOffice, либо, если это большая группа файлов, утилиту командной строки «unoconv». Если вы являетесь пользователем LaTeX и у вас установлено несколько пакетов (в этом разделе документации Pandoc описано, что требуется), вы можете вывести PDF-файлы с помощью следующей команды:

pandoc -r markdown -o *yourfilename*.pdf *yourfilename*.md

Обратите внимание на отсутствие флага «-w» в этом случае.

электронные книги ePub

Чтобы публиковать электронные книги, подходящие для большинства электронных читателей (ePub — это формат, поддерживаемый почти всеми читателями), вам может потребоваться заранее подготовить некоторые элементы, специфичные для этого формата. К ним относятся:

• Таблица стилей, написанная на CSS и описывающая, как будет выглядеть ePub.
• Метаданные, такие как автор, описание, права на произведение и язык.
• Обложка

Однако если у вас их нет, Pandoc будет использовать некоторые разумные значения по умолчанию. Следующая команда преобразует ваш документ Markdown в ePub:

pandoc -r markdown -w epub --epub-metadata=*metadatafile*.xml --epub-cover-image=*coverimage*.jpg --epub-stylesheet=*stylesheet*.css -o *yourfilename*.epub *yourfilename*.md

Дополнительные советы по уценке

Вот несколько дополнительных советов и приемов, которые я использую при использовании Markdown для своих писательских задач:

• Поскольку это обычный текст, если вы используете DropBox для синхронизации файлов между устройствами, вы можете использовать встроенный текстовый редактор для создания или обновления документов Markdown в Интернете. Существуют также редакторы для Linux (мне очень нравится ReText) и Android (в последнее время я переключаюсь между Writer и редактором кода DroidEdit).
• Кроме того, поскольку это простой текст, системы параллельного управления версиями (такие как Subversion) отлично справляются с отслеживанием версий и отображением различий между ними.
• После того, как вы преобразовали пару документов и знаете, какие флаги вам нужны для всех нужных форматов, вы можете создать простой сценарий оболочки, который будет выводить их все одновременно.

Я обнаружил, что Markdown — отличный способ создания контента в «не отвлекающей» среде (большинство текстовых редакторов таковыми являются), который поддерживает вывод в несколько форматов, но не требует каких-либо специальных приложений.

Изображение предоставлено: Снимок крупным планом пишущей машинки, концепция первой главы от Big Stock Photo.