> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/ru/drugie-temy/08-choosing-a-latex-compiler.md).

# Выбор компилятора LaTeX

Стили, содержимое и макет в документе LaTeX определяются с помощью *тегов* или *команды* в обычном .tex-файле этот файл можно использовать для создания нескольких типов «человекочитаемых» версий документа. Самый простой способ получить такой итоговый вывод — использовать [Overleaf](http://www.overleaf.com). В Overleaf уже есть готовый к использованию дистрибутив LaTeX, и окончательные документы можно создавать, просто нажимая кнопку «Recompile»; если это ваш случай, вы можете пропустить эту статью. В противном случае, если вам нужно научиться компилировать документы на вашем компьютере, в этой статье описано, как получить вывод PS, DVI и PDF из файла LaTeX.

## Введение

Документы LaTeX — это обычные документы с расширением .tex (см. [Создание документа в LaTeX](/latex/ru/osnovy-latex/01-learn-latex-in-30-minutes.md) статью с примерами), этот простой текстовый файл содержит команды разметки, предназначенные для форматирования документа, но как же на самом деле получить конечный результат? Это зависит от типа документа, который вы хотите создать.

Предположим, вы сохранили документ и назвали файл «mydocument.tex». Чтобы создать файл .PDF, просто выполните эту команду в системном терминале.

`pdflatex mydocument.tex`

И появится файл с именем «mydocument.pdf».

## Дистрибутивы TeX

Набор программ, который позволяет компилировать документы TeX и LaTeX, называется системой верстки TeX или дистрибутивом TeX. Существует много дистрибутивов TeX для разных операционных систем:

* **MiKTeX** для Windows
* **TeX Live** для Linux и других UNIX-подобных систем
* **MacTeX** дистрибутив TeX Live для macOS
* **teTeX** для Linux и других UNIX-подобных систем; в настоящее время больше не поддерживается активно
* **proTeXt** основан на MiKTeX

Конечно, если вы не хотите проходить процесс установки дистрибутива TeX, вы можете использовать готовый онлайн-вариант, такой как [Overleaf](http://www.overleaf.com).

## редакторы LaTeX

Существует множество продвинутых текстовых редакторов, специально предназначенных для LaTeX, для самых популярных операционных систем; некоторые из них можно бесплатно скачать, а другие являются проприетарным ПО:

* Открытый исходный код: AUCTEX, GNU TeXmacs, Gummi, Kile, LaTeXila, MeWa, TeXShop, TeXnicCenter, Texmaker, TeXstudio, TeXworks
* Бесплатное ПО: LEd, WinShell
* Проприетарное/условно-бесплатное ПО: Inlage, Scientific WorkPlace, WinEdt

Существуют также универсальные редакторы, которые добавляют удобные для LaTeX возможности с помощью плагинов. Например, хорошо известные редакторы emacs и vim оба имеют расширение для LaTeX, как и Atom, VS Code и Sublime Text.

Стоит отметить, что редактор в [Overleaf](http://overleaf.com) можно настроить так, чтобы он имитировал поведение emacs или vim. Он также *поддерживает темы оформления*, так что вы можете выбрать ту же подсветку синтаксиса, что и в некоторых из упомянутых выше редакторов. Эти настройки можно найти, щёлкнув по значку меню Overleaf над панелью списка файлов в вашем проекте Overleaf.

## Форматы вывода

Во всех дистрибутивах TeX доступны три формата вывода. Чтобы получить определённый вывод, документ нужно скомпилировать, выполнив команду в *терминале* (Linux и macOS) или в *командной строке* (Windows).

Например, если вы хотите скомпилировать файл с именем «mydocument.tex», можно использовать одну из следующих команд:

**latex mydocument.tex**

Это создаст «mydocument.dvi», документ DVI

**pdflatex mydocument.tex**

Это создаст «mydocument.pdf», документ PDF

Существуют некоторые дополнительные команды, позволяющие преобразовывать форматы; также поддерживаются изображения PS. См. [справочное руководство](#reference-guide) для схематического описания команд и форматов вывода.

Ниже приводится описание каждого формата вывода:

* **(DVI)** Формат файла, независимый от устройства, состоит из двоичных данных, описывающих визуальную компоновку документа таким образом, что он не зависит от какого-либо конкретного формата изображения, устройства отображения или принтера.
* **(PS)** Формат файла PostScript описывает текст и графику на странице и основан на векторной графике. PostScript до сих пор является стандартом в сфере настольной издательской системы.
* **(PDF)** Portable Document Format — это формат файла, основанный на PostScript, используемый для представления документов независимо от программного обеспечения, оборудования и операционных систем. Сейчас он широко используется как формат для печати и распространения в Интернете.

Примечание: *Большинство редакторов сегодня включают значки быстрого доступа для компиляции в разные форматы вывода, так что вам не приходится фактически запускать команды в системной строке.*

В Overleaf итоговый скомпилированный результат всегда является документом PDF. Если вам нужно получить файл DVI из вашего проекта Overleaf, вот что вы можете сделать:

1. Убедитесь, что в вашем проекте используются только изображения .eps и .ps.
2. Нажмите на **значок меню Overleaf** над панелью списка файлов и установите *Компилятор* параметр в значение «LaTeX».
3. Скомпилируйте проект повторно.
4. Нажмите кнопку «Logs and output files» рядом с кнопкой Recompile.
5. Прокрутите вправо до самого низа и нажмите «Other logs and output files».
6. После этого вы сможете скачать сгенерированный файл .dvi.

![Скачивание других выходных файлов](/files/bba0bf454cd3aef0cb4ee5b34f6e0f97906d7ded)

## Другие компиляторы

Другие возможные параметры компилятора — pdfLaTeX (по умолчанию), XeLaTeX и LuaLaTeX. Обычно можно использовать pdfLaTeX, но выбор компилятора зависит от потребностей каждого проекта.

* LaTeX поддерживает только форматы изображений .eps и .ps для использования с `\includegraphics`. Если все изображения в вашем проекте — файлы .eps, то рекомендуется именно этот параметр компилятора.
* pdfLaTeX поддерживает форматы изображений .png, .jpg, .pdf. Он будет преобразовывать изображения .eps в .pdf на лету во время компиляции, что может увеличить требуемое время компиляции. (pdfLaTeX может не справляться с `pstricks` хорошо в Overleaf.)
* XeLaTeX и LuaLaTeX оба нативно и надёжно поддерживают UTF-8, а также TrueType и OpenType. Поэтому они рекомендуются, если вам нужно верстать нелатинские письменности в Overleaf, в сочетании с `polyglossia` пакетом. Они также поддерживают все форматы изображений .png, .jpg, .pdf *и* .eps.
* XeLaTeX поддерживает `pstricks`; а LuaLaTeX — нет.
* Вы можете расширить возможности LuaLaTeX, встраивая код Lua непосредственно в документ.

## Компиляция документов с перекрёстными ссылками

В некоторых случаях, когда ваш документ содержит перекрёстные ссылки, источник нужно компилировать дважды. Это необходимо, чтобы корректно проставить номера в оглавлении, списке изображений, номера ссылок на теоремы и так далее.

Во время первой компиляции компилятор LaTeX записывает файл .aux с информацией о различной нумерации, а во время второй компилятор читает эту информацию, чтобы корректно сгенерировать оглавление, библиографию и т. д.

Этот процесс можно автоматизировать с помощью команды `latexmk`. Например, чтобы создать PDF из файла «mydocument.tex», выполните

`latexmk -pdf mydocument.tex`

только один раз, даже если документ содержит изображения и библиографию со ссылками. Вы можете изменить *-pdf* на *-dvi* чтобы задать другой тип файла.

## справочнике

**Поток компиляции LaTeX**

![Поток файла LaTeX](/files/fa6a12beacd4138919a602512691986654821a65)

## Дополнительное чтение

* [Создание документа в LaTeX](/latex/ru/osnovy-latex/01-learn-latex-in-30-minutes.md)
* [Создание документа в Overleaf](/latex/ru/baza-znanii/031-creating-a-document-in-overleaf.md)
* [Отладка ошибок тайм-аута компиляции](/latex/ru/baza-znanii/038-fixing-and-preventing-compile-timeouts.md)
* [Многофайловые проекты LaTeX](/latex/ru/struktura-dokumenta/08-multi-file-latex-projects.md)
* [Не слишком краткое введение в LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/latex/ru/drugie-temy/08-choosing-a-latex-compiler.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
