> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Использование GitHub Codespace

Самый простой способ протестировать Ayakaleaf Pro — воспользоваться GitHub Codespace, где все переменные окружения уже предварительно настроены, чтобы всё работало «из коробки».

<Warning>
  При запуске Docker-контейнеров в GitHub Codespaces Codespace не завершает работу автоматически, и за него продолжает **взиматься плата**. Правила тарификации GitHub Codespaces см. в [правилах оплаты GitHub Codespaces](https://docs.github.com/en/billing/concepts/product-billing/github-codespaces).

  Для управления своими GitHub Codespaces перейдите на [https://github.com/codespaces](https://github.com/codespaces). Когда Codespace больше не нужен, своевременно удалите его.
</Warning>

Мы **предварительно настроили** следующие функции:

* [x] Изолированная компиляция LaTeX с TeXLive **Basic** (2024–2026)
* [x] Импорт/экспорт через Pandoc (функция SaaS-платформы)
* [x] Запуск скриптов Python (функция SaaS-платформы)
* [x] Поддержка Git-Bridge (функция Server Pro)
* [x] Расширенный поиск по библиографии (функция SaaS-платформы)
* [x] Панель администратора (глобальное управление пользователями и проектами)
* [x] Отслеживание изменений (с панелью рецензирования и комментариев)
* [x] Полная история проекта (с восстановлением и скачиванием)
* [x] Палитра символов (функция Server Pro / SaaS-платформы)

<Warning>
  Стандартные GitHub Codespaces предоставляют 32 ГБ дискового пространства. Этого недостаточно для установки `texlive-full`. Чтобы протестировать полный образ, отправьте в поддержку GitHub запрос на Codespace с большими раннерами (8+ ядер).
</Warning>

Синхронизация с GitHub, LDAP, OAuth, SSO, интеграция с Zotero и другие функции в этой песочнице ***не настроены***. Подробнее о настройке этих функций в собственном развёртывании см. в [настройках Toolkit](/ru/on-premises/configuration/overleaf-toolkit/toolkit-settings).

<Steps>
  <Step title="Создайте GitHub Codespace">
    Нажмите кнопку ниже, чтобы создать GitHub Codespace. Что касается конфигурации сервера, для тестирования обычно достаточно **2 ядер и 8 ГБ ОЗУ**. Если вы планируете использовать [**TeX Live Full**](https://github.com/ayaka-notes/texlive-full), рекомендуем выбрать конфигурацию с **8 ядрами и 64 ГБ**.

    [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/ayaka-notes/ayakaleaf-pro-playground)
  </Step>

  <Step title="Инициализируйте экземпляр Overleaf">
    Когда Codespace будет готов, выполните в bash следующую команду, чтобы инициализировать экземпляр Overleaf.

    ```bash title="bash" theme={null}
    ./init.sh
    ```

    <Info>
      Возможно, придётся подождать не менее 3 минут, пока будут загружены все необходимые Docker-образы.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-26.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=8566b61de0757c1b270e7e5011d48a3e" alt="" width="1181" height="626" data-path="images/on-premises/image-26.png" />
    </Frame>
  </Step>

  <Step title="Сделайте порт 80 доступным">
    Перейдите на вкладку **Ports** и выполните следующие действия, чтобы сделать порт 80 публичным.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/on-premises/img-db37d3e4.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=81e5a18f3aebbd396a57d163a2460739" alt="" width="1452" height="694" data-path="images/on-premises/img-db37d3e4.png" />
    </Frame>

    После этого нажмите **Forwarded Address**, чтобы открыть ваш экземпляр Overleaf. Возможно, потребуется добавить `/launchpad`, чтобы открыть страницу приветствия Overleaf.
  </Step>

  <Step title="Создайте учётную запись администратора">
    Введите логин и пароль администратора, затем нажмите кнопку Register.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-1ae40ae0.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=82d769561891fd4b4566ee2ad9c48065" alt="" width="2736" height="1798" data-path="images/on-premises/img-1ae40ae0.png" />
    </Frame>
  </Step>

  <Step title="Наслаждайтесь работой">
    Теперь самое время наслаждаться работой в $\LaTeX$!

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-25.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=1d4e1fac863cbee906d9d3ad2f3c08d7" alt="" width="2104" height="1415" data-path="images/on-premises/image-25.png" />
    </Frame>
  </Step>
</Steps>

#### Использование образа TeXLive Full

Если у вас есть доступ к GitHub Codespaces с 8 ядрами и 64 ГБ, в этой песочнице можно использовать образ TeXLive Full. Чтобы использовать образ TeXLive Full вместо TeXLive Basic, измените следующие переменные окружения в файле `toolkit/config/variables.env`.

```dotenv wrap theme={null}
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
```

После изменения переменных окружения необходимо перезапустить Toolkit, чтобы применить изменения. Для этого выполните следующую команду.

```bash theme={null}
cd toolkit && bin/up -d
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.