Всем привет. Опять решил поделиться опытом своих провалов.
В общем, как-то раз я решил написать самоучитель по Bash.
По традиции все учебники либо в HTML, либо в PDF. Я решил остановиться на PDF. Я начал писать в LibreOffice, там есть экспорт в PDF. Пока писал — познакомился с Markdown. И вдруг подумалось: Markdown такой классный, напрямик можно в GitHub запихнуть. И в PDF конвертнуть с помощью Pandoc можно. В общем, решил верстать в Markdown.
Для начала познакомился с редакторами, которые умеют подсвечивать Markdown (Pluma, Mousepad, Geany). В общем, жить можно, но подсвечивается не всё.
После этого попробовал Apostrophe. Он уже умеет дополнительно показывать результат. Но работает медленно. Особенно на больших документах.
В общем, перепробовал — не нравится. Решил писать в Mousepad, а потом конвертить с помощью Pandoc.
Написал скрипт для удобства пользования: меняется дата файла — автоматом резервная копия версии и конвертация в фоне.
Начал работать, и тут вскрылась куча недостатков Markdown:
- Нет нормального форматирования (заголовок нельзя центрировать).
- Нет нормальных таблиц, один ущерб какой-то.
- Проблема с кириллицей (решаемая), но с помощью дополнительного TeX-файла настроек.
\usepackage{longtable}\setlength{\LTleft}{2em}
\setmainfont{Liberation Serif}
\setsansfont{Liberation Sans}
\setmonofont{Liberation Mono}
\newfontfamily\cyrillicfont{Liberation Sans}
\defaultfontfeatures{Scale=MatchLowercase, Mapping=tex-text}
\usepackage{polyglossia}
\setmainlanguage{russian}
\setotherlanguage{english}
- Нет возможности печатать некоторые символы UTF.
- Некоторые символы приходится маскировать, чтобы они не понимались как управляющие.
Единственный плюс — подсветка синтаксиса Bash.
За два дня освоил работу со стилями, и всё пошло как по маслу. Кстати, экспорт в PDF тоже быстрее, на мой взгляд.
Может, и не всё получилось, сами знаете — первый блин комом.
Замечания и комментарии приветствуются.
С результатом можно ознакомиться в репозитории.
Комментарии