Použití GitHub Codespace

Nejjednodušší způsob, jak vyzkoušet náš Ayakaleaf Pro, je použít GitHub Codespace, kde jsou všechny proměnné prostředí předem nakonfigurovány, takže jej můžete používat ihned po spuštění.

Když spouštíte kontejnery Docker pomocí GitHub Codespaces, Codespace se automaticky nevypne a bude se vám nadále účtovat. Pravidla účtování GitHub Codespaces najdete v pravidlech účtování github codespaces.

Své GitHub Codespaces můžete spravovat na https://github.com/codespaces. Jakmile Codespace již nepotřebujete, včas jej smažte.

Následující funkce máme předem nakonfigurované:

• Izolovaná (sandboxed) kompilace LaTeXu s TeXLive Basic (2024–2026)
• Import/export pomocí Pandoc (funkce SaaS platformy)
• Spouštění skriptů v Pythonu (funkce SaaS platformy)
• Podpora Git-Bridge (funkce Server Pro)
• Pokročilé vyhledávání referencí (funkce SaaS platformy)
• Administrátorský panel (globální správa uživatelů/projektů)
• Sledování změn (s panelem pro revize a komentáře)
• Úplná historie projektu (s obnovením a stažením)
• Symbol Palette (funkce Server Pro/SaaS platformy)

Standardní GitHub Codespaces poskytují 32 GB úložiště. To pro naši instalaci texlive-full nestačí. Chcete-li vyzkoušet úplný image, požádejte prostřednictvím tiketu podpory GitHubu o Codespace s velkými runnery (8+ jader).

Synchronizace s GitHubem, LDAP, OAuth, SSO, integrace Zotero a další funkce v tomto testovacím prostředí nejsou nakonfigurovány. Podrobnosti o konfiguraci těchto funkcí ve vlastním nasazení najdete v nastavení toolkitu.

1. Vytvoření GitHub Codespace

   Kliknutím na následující tlačítko vytvoříte svůj GitHub Codespace. Pokud jde o konfiguraci serveru, pro testování obvykle stačí 2 jádra a 8 GB RAM. Pokud plánujete používat TeX Live Full, doporučujeme zvolit konfiguraci s 8 jádry a 64 GB.

   

2. Inicializace instance Overleafu

   Jakmile je váš codespace připraven, spusťte v bashi následující příkaz pro inicializaci instance Overleafu.

   bash

   ./init.sh
   

   Než stáhneme všechny potřebné Docker images, může být nutné počkat alespoň 3 minuty.

   
3. Zpřístupnění portu 80

   Přepněte na kartu Ports a podle následujících kroků nastavte port 80 jako veřejný.

   

   Poté můžete kliknutím na Forwarded Address otevřít svou instanci Overleafu. Pro zobrazení uvítací stránky Overleafu může být nutné přidat /launchpad.

4. Vytvoření administrátorského účtu

   Zadejte administrátorský účet a heslo a poté klikněte na tlačítko Register.

   
5. Užijte si psaní

   Nyní si můžete užívat psaní v $\LaTeX$u!

   

​

Použití image TeXLive Full

Pokud máte přístup ke GitHub Codespaces s 8 jádry/64 GB, můžete v tomto testovacím prostředí použít image TeXLive Full. Chcete-li místo image TeXLive Basic použít TeXLive Full, změňte následující proměnné prostředí v souboru 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 změně proměnných prostředí je nutné toolkit restartovat, aby se změny projevily. Toolkit restartujete následujícím příkazem.

cd toolkit && bin/up -d