Korzystanie z GitHub Codespace

Najłatwiejszym sposobem na przetestowanie Ayakaleaf Pro jest użycie GitHub Codespace, w którym wszystkie zmienne środowiskowe są wstępnie skonfigurowane, dzięki czemu możesz korzystać z niego od razu.

Gdy uruchamiasz kontenery Docker w GitHub Codespaces, Codespace nie wyłączy się automatycznie i nadal będzie naliczana opłata. Zasady rozliczeń GitHub Codespaces znajdziesz w zasadach rozliczeń github codespaces.

Aby zarządzać swoimi GitHub Codespaces, odwiedź https://github.com/codespaces. Gdy Codespace przestanie być potrzebny, usuń go w odpowiednim czasie.

Wstępnie skonfigurowaliśmy następujące funkcje:

• Kompilacja LaTeX w piaskownicy z TeXLive Basic (2024-2026)
• Import/eksport Pandoc (funkcja platformy SaaS)
• Uruchamianie skryptów Python (funkcja platformy SaaS)
• Obsługa Git-Bridge (funkcja Server Pro)
• Zaawansowane wyszukiwanie bibliografii (funkcja platformy SaaS)
• Panel administratora (globalne zarządzanie użytkownikami/projektami)
• Śledzenie zmian (z panelem recenzji i komentarzy)
• Pełna historia projektu (z przywracaniem i pobieraniem)
• Paleta symboli (funkcja Server Pro/platformy SaaS)

Standardowe GitHub Codespaces zapewniają 32 GB przestrzeni dyskowej. To za mało dla naszej instalacji texlive-full. Aby przetestować pełny obraz, złóż zgłoszenie do pomocy technicznej GitHub o Codespace z dużymi maszynami (8+ rdzeni).

GitHub Sync, LDAP, OAuth, SSO, integracja z Zotero i inne funkcje nie są skonfigurowane w tym środowisku testowym. Więcej informacji o konfigurowaniu tych funkcji we własnym wdrożeniu znajdziesz w ustawieniach toolkit.

1. Utwórz GitHub Codespace

   Kliknij poniższy przycisk, aby utworzyć GitHub Codespace. Jeśli chodzi o konfigurację serwera, do testów zazwyczaj wystarczą 2 rdzenie i 8 GB RAM. Jeśli planujesz używać TeX Live Full, zalecamy wybranie konfiguracji z 8 rdzeniami i 64 GB.

   

2. Zainicjuj instancję Overleaf

   Gdy Codespace będzie gotowy, uruchom w bashu poniższe polecenie, aby zainicjować instancję Overleaf.

   bash

   ./init.sh
   

   Pobranie wszystkich potrzebnych obrazów Docker może potrwać co najmniej 3 minuty.

   
3. Udostępnij port 80

   Przejdź do karty Ports, a następnie wykonaj poniższe kroki, aby ustawić port 80 jako publiczny.

   

   Następnie możesz kliknąć Forwarded Address, aby otworzyć swoją instancję Overleaf. Aby wyświetlić stronę powitalną Overleaf, może być konieczne dopisanie /launchpad.

4. Utwórz konto administratora

   Wprowadź nazwę konta administratora i hasło, a następnie kliknij przycisk Register.

   
5. Miłego pisania

   Teraz możesz cieszyć się pisaniem w $\LaTeX$!

   

​

Użycie pełnego obrazu TeXLive

Jeśli masz dostęp do GitHub Codespaces z 8 rdzeniami/64 GB, możesz użyć w tym środowisku testowym obrazu TeXLive Full. Aby używać obrazu TeXLive Full zamiast TeXLive Basic, zmień poniższe zmienne środowiskowe w pliku 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

Po zmianie zmiennych środowiskowych musisz zrestartować toolkit, aby zastosować zmiany. Możesz to zrobić za pomocą poniższego polecenia.

cd toolkit && bin/up -d