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

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

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

 sudo apt- получить установку 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 также поддерживает преобразование в новый (версия 2007 и новее) формат Microsoft Word с флагом " --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

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

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

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

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