> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/latex/ru/faily-klassov/02-overleaf-and-tex-live.md). # Список пакетов и файлов классов В этой статье介绍 TeX Live и рассматривается его использование в сервисе набора текста Overleaf на основе LaTeX. ## Введение в TeX Live [TeX Live](https://www.tug.org/texlive/) — это свободное программное обеспечение, ежегодно публикуемое [Группой пользователей TeX](https://www.tug.org/). Он предоставляет пакеты LaTeX, шрифты, движки TeX и множество программных инструментов, необходимых для поддержки набора текста на основе LaTeX во всех стандартных операционных системах. TeX Live — важный компонент Overleaf, поскольку наши серверы используют его для компиляции вашего кода LaTeX и создания PDF-предпросмотра в реальном времени. Он также предоставляет пользователям Overleaf удобный доступ к более чем 5000 пакетам LaTeX, содержащимся в каждом выпуске TeX Live. Вы не ограничены использованием только самой новой версии TeX Live для компиляции своих проектов, поскольку серверы Overleaf предоставляют доступ к предыдущим выпускам TeX Live. Проекты можно легко [переключить на использование более ранней версии TeX Live](#how-do-i-change-a-projects-tex-live-version) — например, из-за проблем с совместимостью пакетов. ## Какие пакеты LaTeX поддерживает Overleaf? Поскольку Overleaf использует TeX Live, вы можете получить доступ к более чем 5000 пакетам, включая: * Рисунки с [pstricks](https://ctan.org/pkg/pstricks-base?lang=en) и [TikZ](https://en.wikipedia.org/wiki/PGF/TikZ). Вот некоторые [примеры TikZ](https://www.overleaf.com/latex/examples/tagged/tikz). * Библиографии с [BibTeX](https://www.bibtex.org/) и [BibLaTeX](https://ctan.org/pkg/biblatex?lang=en). Вот [несколько примеров](https://www.overleaf.com/gallery/tagged/bibliography). * Пакеты, такие как [fontspec](https://ctan.org/pkg/fontspec) , требуемый XeLaTeX и LuaLaTeX для поддержки шрифтов OpenType. Вы можете просмотреть список пакетов TeX и LaTeX на подстранице CTAN [CTAN: Пакеты](https://ctan.org/pkg/). ## Какую версию TeX Live использует мой проект? Когда вы создаёте новый проект Overleaf или копируете существующий, новый (или скопированный) проект по умолчанию будет компилироваться с использованием самой последней версии TeX Live, установленной на наших серверах. Когда мы предоставляем нашим пользователям новую версию TeX Live, мы не обновляем автоматически существующие проекты. Автоматическое обновление может привести к ошибкам или предупреждениям в ваших существующих проектах из-за различий между версиями TeX Live. ### Дополнительные замечания о TeX Live и вашем проекте Overleaf * Версия TeX Live, используемая для компиляции нерасшаренного проекта, контролируется владельцем этого проекта. Однако если соавтор в общем проекте изменит версию TeX Live, это повлияет на всех, кто сотрудничает в этом проекте. * Версия TeX Live — это параметр, специфичный для проекта: изменение её для конкретного проекта не повлияет на другие проекты в вашем рабочем пространстве Overleaf и не изменит исходный код в проекте, версия TeX Live которого была изменена. * После выбора конкретной версии TeX Live все пакеты, используемые вашим проектом, разумеется, будут версиями, присутствующими и опубликованными в этом выпуске TeX Live. * Переход на другую настройку TeX Live может изменить поведение пакетов, например изменения в предоставляемых ими командах. * Изменение версии TeX Live в проекте не является постоянным; при необходимости вы можете вернуться к предыдущей версии в любое время. Всегда помните, что разные выпуски TeX Live могут содержать обновления/изменения, которые могут повлиять на возможность компиляции вашего проекта с использованием конкретного выпуска TeX Live. ## Как изменить версию TeX Live в проекте? Чтобы изменить версию TeX Live в проекте, выполните следующие шаги — настройка TeX Live *отдельна для каждого проекта* и не влияет на другие ваши проекты: 1. Выберите кнопку меню Overleaf (![Overleaf menu button](/files/60a6fbe3604f56bdac30588ee78e9b89eec63301)) и найдите раздел меню с названием **Настройки**. 2. Внутри **Настройки**, выберите раскрывающийся список с названием **Версия TeX Live**. 3. Выберите нужную вашему проекту версию TeX Live, затем закройте меню, щёлкнув в любом месте вне списка меню. 4. Перекомпилируйте проект, чтобы проверить совместимость с выбранной версией TeX Live. Следующая иллюстрация кратко показывает эти шаги — для наглядности большинство пунктов меню опущено: ![Изображение, показывающее, как выбрать версию TeX Live в Overleaf](/files/0eec39f452ab85406143bca188f49802631af184) ### Зачем менять версию TeX Live в проекте? TeX Live — это большой и сложный программный дистрибутив, поэтому неудивительно, что новые выпуски иногда вносят изменения, которые мешают успешной компиляции некоторых документов. Обычно это связано с изменениями в командах пакетов, неожиданными ошибками и несовместимостями пакетов (или «конфликтами»). Вот некоторые распространённые причины изменения версии TeX Live, используемой для компиляции вашего проекта. * **Возможно, вы захотите более новую версию TeX Live для одного из ваших существующих проектов**. Вы можете перевести проект на более свежую версию TeX Live, которая предоставляет пакет, команду или языковую возможность, которую вы хотите использовать. Однако перед этим мы рекомендуем убедиться, что проект компилируется без ошибок, и что вы понимаете все оставшиеся предупреждения, выданные компилятором. * **Возможно, вы захотите, чтобы скопированный проект использовал ту же версию TeX Live, что и оригинал**. Иногда при копировании старого проекта могут появиться новые ошибки из-за изменений в TeX Live. В этом случае вы можете либо доработать проект, чтобы он был совместим с последней версией TeX Live, либо установить для новой копии ту же версию TeX Live, что использовалась в оригинальном проекте, с которого она была скопирована. * **Вам может потребоваться, чтобы версия TeX Live, используемая в вашем проекте Overleaf, совпадала с версией, которую вы используете на локальном компьютере**. Если вы компилируете проекты как локально, так и в Overleaf, чтобы получать согласованные результаты, вы можете захотеть настроить версию TeX Live, используемую Overleaf, так, чтобы она была совместима с версией LaTeX, которую вы используете локально. * **Вы можете отправлять материалы в журнал или репозиторий, который компилируется с конкретной версией TeX Live**. Если вы отправляете материалы в журнал или репозиторий, использующий определённую версию LaTeX, компиляция в Overleaf с той же или совместимой версией TeX Live может помочь избежать ошибок при отправке. ### Версии TeX Live «Legacy» В раскрывающемся меню версии TeX Live, показанном на скриншоте выше, более старые версии TeX Live относятся к категории «Legacy». Эти версии доступны, чтобы обеспечить совместимость и успешную компиляцию для старых шаблонов и проектов, которым они требуются. Вот несколько дополнительных моментов, которые следует учитывать при использовании более старых версий TeX Live: * При создании нового проекта рекомендуется использовать последнюю версию TeX Live, если только конкретные проблемы совместимости не требуют использования более старой версии. Такой подход гарантирует, что вы получите преимущества от самых новых обновлений и возможностей. * Хотя Overleaf пока не определил сроки прекращения поддержки самых старых версий TeX Live, эти версии со временем могут быть выведены из эксплуатации и стать недоступными. * По возможности ваши существующие проекты следует обновлять до последней совместимой версии TeX Live. ## Как часто TeX Live обновляется в Overleaf? Серверы компиляции Overleaf обновляются до последнего выпуска TeX Live вскоре после его появления. После тестирования и завершения обновления Overleaf публикует запись в блоге, чтобы поделиться заметными обновлениями TeX Live, а также примечаниями по отдельным пакетам и рекомендациями на основе результатов нашего тестирования. Наши «примечания к выпуску» TeX Live можно найти в нашем блоге, используя `tex live` тег: . ### О процессе обновления Overleaf Перед обновлением нашей установки TeX Live мы повторно компилируем обширный набор тестовых документов, включая примерно 5000 документов из нашей галереи шаблонов, примеров и статей, чтобы проверить наличие ломающих изменений — включая ошибки и любые значительные визуальные изменения в скомпилированном результате. Мы также измеряем сравнительное время, необходимое для отображения документов. Мы выявляем значительно более медленные рендеры и пытаемся ускорить их. В результате этих тестов мы обновляем созданные нами шаблоны — именно поэтому иногда нам требуется некоторое время, чтобы обновить наш TeX Live! Однако результатом, надеемся, становится более стабильный опыт для наших пользователей. Несмотря на наши тесты, обновления LaTeX, движков TeX или необходимых шрифтов и пакетов в TeX Live иногда могут вносить несовместимости, ломающие изменения и устаревание, которые находятся вне нашего контроля. Учитывая масштаб TeX Live и множество пакетов и инструментов, которые он предоставляет, мы не можем исключить ломающие изменения, но постараемся сделать всё возможное, чтобы минимизировать любое влияние на наших пользователей. ### Изменения пакетов между выпусками TeX Live Сообщество TeX продолжает внедрять инновации между ежегодными выпусками TeX Live. Новые или обновлённые пакеты LaTeX, шрифты и программное обеспечение, связанное с TeX, регулярно добавляются в Comprehensive TeX Archive Network, известную в сообществе TeX как CTAN. CTAN предоставляет центральный репозиторий программного обеспечения, связанного с TeX и LaTeX, готового к включению в следующий выпуск TeX Live. --- # 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://overleaf-pro.ayaka.space/latex/ru/faily-klassov/02-overleaf-and-tex-live.md?ask=&goal= ``` `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.