Создаем стильные PDF из мануалов в Linux
Если вы устали от привычных мануалов в Linux, то представляю вашему вниманию команду, которая преобразует их в документы в формате PDF с хакерским шрифтом!
Установите все необходимые зависимости
sudo apt install texlive-full pandoc fonts-jetbrains-mono
texlive-full
- полный пакет TeX Live, который предоставляет все необходимые компоненты для работы с LaTeXpandoc
- универсальный конвертер документов. На официальной странице можно ознакомиться с диаграммой, которая отображает поддерживаемые форматы файловfonts-jetbrains-mono
- хакерский шрифт
Выполните скрипт в оболочке командной строки
zcat /usr/share/man/man1/cat.1.gz | nroff -man | col -b | pandoc -f markdown -t pdf -V geometry:margin=0.5in -V 'mainfont=JetBrains Mono' -V 'sansfont=JetBrains Mono' -V 'monofont=JetBrains Mono' -V fontsize=16pt --pdf-engine=lualatex -o cat.pdf
Разберём эту команду по этапам
zcat /usr/share/man/man1/cat.1.gz
- чтение сжатого мануала catnroff -man
- форматирование текста мануала cat, полученного на предыдущем этапе, согласно указанным макросам для страниц man (-man
)col -b
- удаление управляющих символов для корректного отображения текстаpandoc -f markdown -t pdf -V geometry:margin=0.5in -V 'mainfont=JetBrains Mono' -V 'sansfont=JetBrains Mono' -V 'monofont=JetBrains Mono' -V fontsize=16pt --pdf-engine=lualatex -o cat.pdf
- преобразование Markdown в PDF с применением указанных стилей (хакерский шрифт, отступ)
На выходе в качестве артефакта получится отформатированный файл в формате PDF с содержимым мануала cat