GitHub Codespace verwenden

Am einfachsten testen Sie Ayakaleaf Pro mit GitHub Codespace: Dort sind alle Umgebungsvariablen vorkonfiguriert, sodass Sie es sofort nutzen können.

Wenn Sie Docker-Container in GitHub Codespaces ausführen, wird der Codespace nicht automatisch heruntergefahren und weiterhin abgerechnet. Die Abrechnungsregeln für GitHub Codespaces finden Sie unter GitHub-Codespaces-Abrechnungsregeln.

Um Ihre GitHub Codespaces zu verwalten, besuchen Sie https://github.com/codespaces. Wenn Sie Ihren Codespace nicht mehr benötigen, löschen Sie ihn bitte rechtzeitig.

Folgende Funktionen haben wir vorkonfiguriert:

• Sandbox-LaTeX-Kompilierung mit TeX Live Basic (2024–2026)
• Pandoc-Import/-Export (Funktion der SaaS-Plattform)
• Python-Skriptausführung (Funktion der SaaS-Plattform)
• Git-Bridge-Unterstützung (Funktion von Server Pro)
• Erweiterte Literatursuche (Funktion der SaaS-Plattform)
• Admin-Panel (globale Verwaltung von Benutzern/Projekten)
• Änderungsverfolgung (mit Review- und Kommentar-Panel)
• Vollständiger Projektverlauf (mit Wiederherstellen und Herunterladen)
• Symbolpalette (Funktion von Server Pro/SaaS-Plattform)

Standardmäßige GitHub Codespaces bieten 32 GB Speicherplatz. Das reicht für unsere texlive-full-Installation nicht aus. Um das vollständige Image zu testen, reichen Sie ein GitHub-Support-Ticket für einen Codespace mit großen Runnern (8+ Kerne) ein.

GitHub Sync, LDAP, OAuth, SSO, die Zotero-Integration und weitere Funktionen sind in diesem Playground nicht konfiguriert. Weitere Details zur Konfiguration dieser Funktionen in Ihrem eigenen Deployment finden Sie in den Toolkit-Einstellungen.

1. GitHub Codespace erstellen

   Klicken Sie auf die folgende Schaltfläche, um Ihren GitHub Codespace zu erstellen. Was die Serverkonfiguration betrifft, reichen 2 Kerne mit 8 GB RAM für einen Test in der Regel aus. Wenn Sie TeX Live Full verwenden möchten, empfehlen wir eine Konfiguration mit 8 Kernen und 64 GB.

   

2. Overleaf-Instanz initialisieren

   Sobald Ihr Codespace bereit ist, führen Sie in Ihrer Bash den folgenden Befehl aus, um Ihre Overleaf-Instanz zu initialisieren.

   bash

   ./init.sh
   

   Es kann mindestens 3 Minuten dauern, bis alle benötigten Docker-Images heruntergeladen sind.

   
3. Port 80 verfügbar machen

   Wechseln Sie zum Tab Ports und folgen Sie diesen Schritten, um Port 80 öffentlich zu machen.

   

   Anschließend können Sie auf die Forwarded Address klicken, um Ihre Overleaf-Instanz aufzurufen. Möglicherweise müssen Sie /launchpad anhängen, um die Overleaf-Willkommensseite zu öffnen.

4. Administratorkonto erstellen

   Geben Sie Ihr Administratorkonto und Ihr Passwort ein und klicken Sie dann auf die Schaltfläche „Register”.

   
5. Viel Spaß beim Schreiben

   Jetzt ist es Zeit, Ihr $\LaTeX$-Schreiben zu genießen!

   

​

TeX Live Full Image verwenden

Wenn Sie Zugriff auf GitHub Codespaces mit 8 Kernen/64 GB haben, können Sie in diesem Playground das TeX Live Full Image verwenden. Ändern Sie dazu die folgenden Umgebungsvariablen in der Datei toolkit/config/variables.env, um das TeX Live Full Image anstelle des TeX Live Basic Image zu verwenden.

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

Nach dem Ändern der Umgebungsvariablen müssen Sie das Toolkit neu starten, damit die Änderungen wirksam werden. Führen Sie dazu den folgenden Befehl aus.

cd toolkit && bin/up -d