Камунда 7.x: Народный самоучитель
Предусловия
Для создания файлов EPUB, DOCX и ODT нужно установить Пандок.
Исходный код текста написан в формате Org mode. Этот формат похож на Маркдаун. Редактировать его можно в текстовом редакторе. Если вы любите Org Mode так, как люблю его я, то имеет смысл редактировать исходник текста в Емаксе. А если не любите, то есть вероятность, что с помощью Пандока можно преобразовать файлы на Org Mode в Маркдаун.
Структура директорий
basic-camunda-app: Код первого урокаlesson-2–lesson-8: Код уроков 2 до 8.text: Текст самоучителяtext/txt/src/draft.org: Основной исходный код текста, в который включены остальные файлы*.orgиз директорииtext/txt/src.text/txt/src/lesson-001.org–text/txt/src/lesson-008.org: Тексты уроков 1–8.text/txt/src/translation.org: Перевод терминов с английского на русский.text/txt/src/wip.org: Идеи для новых (еще не добавленных) уроков.text/txt/src/img: Изображения, которые используются в тексте.text/compile-text.sh: Скрипт, который делает файлы EPUB, ODT и DOCX из “исходника” (файловtext/txt/src/*.org).text/target: Директория с файлами EPUB, ODT и DOCX (результатом работы скриптаtext/compile-text.sh).
Как создать файлы EPUB, ODT и DOCX
Шаг 1
Обновить версию в файле text/compile-text.sh. Для этого надо установить правильное значение переменной VERSION (0.8 в примере ниже).
VERSION="0.8"
BOOK_FILE_ROOT="draft"
BOOK_FILE="src/txt/"$BOOK_FILE_ROOT".org"
TARGET_FILE_PREFIX="camunda-7-tutorial"
TARGET_FILE_WITHOUT_EXTENSION=$TARGET_FILE_PREFIX"-"$VERSION
Шаг 2
Обновить версию в файле text/src/txt/draft.org в строке, начинающейся на #+SUBTITLE:. Версия должна быть такой же, как и в прошлом шаге (в данном примере – 0.8):
#+AUTHOR: Дмитрий Писаренко
#+TITLE: Камунда 7.x: Народный самоучитель
#+SUBTITLE: Версия 0.8
* Урок 1: Минимальное приложение
<<урок-1>>
Шаг 3
Запустите скрипт text/compile-text.sh. После этого обновленные файлы EPUB, DOCX и ODT появятся в директории text/target/txt. В случае ошибок они появятся в файлах *.log.
Пример: Если версия равна 0.8, то в результате работы text/compile-text.sh в директории text/target/txt будут обновлены файлы
camunda-7-tutorial-0.8.docx,camunda-7-tutorial-0.8.epub,camunda-7-tutorial-0.8.html,camunda-7-tutorial-0.8.odt,camunda-7-tutorial-0.8.txt.
Если произойдут ошибки, то они будут в файлах
camunda-7-tutorial-0.8.docx.log,camunda-7-tutorial-0.8.epub.log,camunda-7-tutorial-0.8.html.log,camunda-7-tutorial-0.8.odt.log,camunda-7-tutorial-0.8.txt.log.