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