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

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

При запуске Docker-контейнеров в GitHub Codespaces Codespace не завершает работу автоматически, и за него продолжает взиматься плата. Правила тарификации GitHub Codespaces см. в правилах оплаты GitHub Codespaces.

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

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

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

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

Синхронизация с GitHub, LDAP, OAuth, SSO, интеграция с Zotero и другие функции в этой песочнице не настроены. Подробнее о настройке этих функций в собственном развёртывании см. в настройках Toolkit.

1. Создайте GitHub Codespace

   Нажмите кнопку ниже, чтобы создать GitHub Codespace. Что касается конфигурации сервера, для тестирования обычно достаточно 2 ядер и 8 ГБ ОЗУ. Если вы планируете использовать TeX Live Full, рекомендуем выбрать конфигурацию с 8 ядрами и 64 ГБ.

   

2. Инициализируйте экземпляр Overleaf

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

   bash

   ./init.sh
   

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

   
3. Сделайте порт 80 доступным

   Перейдите на вкладку Ports и выполните следующие действия, чтобы сделать порт 80 публичным.

   

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

4. Создайте учётную запись администратора

   Введите логин и пароль администратора, затем нажмите кнопку Register.

   
5. Наслаждайтесь работой

   Теперь самое время наслаждаться работой в $\LaTeX$!

   

​

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

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

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, чтобы применить изменения. Для этого выполните следующую команду.

cd toolkit && bin/up -d