Використання 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

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

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, щоб застосувати зміни. Для перезапуску toolkit можна виконати таку команду.

cd toolkit && bin/up -d