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

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

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

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

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

  • "-R" - читать формат
  • "-W" - формат записи
  • "-O" - имя файла вывода

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

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

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

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

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

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

pandoc-odt-template-in-markdown

pandoc-odt-template-in-odt2

pandoc-odt-convert-with-template

Формат переносимого документа (PDF)

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

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

Электронные книги EPub

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

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

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

Дополнительные советы по Markdown

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

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

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

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

Один комментарий

  1. Я использовал Markdown (используя OSX, Sublime Text 2), чтобы создать свою книгу "Markdown By Example" (http://markdownbyexample.com/).
    Проверьте Leanpub, если вы собираетесь написать книгу в Markdown. Мне это показалось намного проще, чем создание собственной таблицы стилей CSS, тем более что они также предоставляют средства для продажи электронной книги.
    Кроме того, они добавили несколько хороших дополнений к стандартному синтаксису Markdown, которые могут помочь.

Комментарии закрыты.