Введение

TeX — это язык разметки, а это — инструменты, позволяющие из файлов .tex получить документы в нужном формате:

  • LaTeX.

    Старый, работает только с английским языком. Для поддержки русского языка требует многочисленных костылей.

  • XeLaTeX.

    Более современная альтернатива LaTeX.

  • XeTeX.

    Аналог LaTeX.

  • pdftex

    Бесполезный кусок говна. Потратил кучу времени, но так и не научил его работать с кириллицей. Симптомы:

      This is pdfTex, Version 3.141592653-2.6-1.40.26 (Tex Live 2025/dev/Debian) (preloaded format=pdftex)
   restricted \write18 enabled.
  entering extended mode
  (./index.tex)
  ! Undefined control sequence.
  l.1 \documentclass
                    {book}
  ?

Порядок действий

Чтобы начать разработку документации с помощью TeX:

  1. Установите TexLive, лучше полную версию, чтобы потом не ловить непонятные ошибки:

     sudo apt-get update && sudo apt-get install texlive-full

    В принципе, вы можете установить всё необходимое и с помощью установщика TexLive с его сайта, просто я не люблю ставить в систему что-то, что не управляется системой пакетов.

  2. Создайте файл с примерно таким содержимым:

     \documentclass{book}
 \usepackage[russian]{babel}
 \usepackage{hyphenat}
 \usepackage{fontspec}

 \begin{document}
 \tableofcontents

 Тут будет наш контент

 \end{document}

    На что обратить внимание:

    • Класс документа — книга (book). Вы можете использовать и что-то другое, я не настаиваю.

    • Обязательно используйте пакет babel, в настройках которого укажите русский язык. Если у вас смесь языков, то имеет смысл писать так:

        \usepackage[russian,english]{babel}

    • Пакеты hyphenat и fontspec опциональны. Да и все остальные блоки, в общем-то, тоже.

  3. Для сборки проекта используйте xelatex.

     xelatex index.tex