Använda GitHub Codespace

Det enklaste sättet att testa Ayakaleaf Pro är att använda GitHub Codespace, där alla miljövariabler är förkonfigurerade så att du kan använda det direkt.

När du kör Docker-containrar i GitHub Codespaces stängs din Codespace inte av automatiskt och fortsätter att debiteras. Information om debiteringsreglerna för GitHub Codespaces finns i debiteringsregler för GitHub Codespaces.

Hantera dina GitHub Codespaces på https://github.com/codespaces. När du inte längre behöver din Codespace bör du ta bort den i tid.

Vi har förkonfigurerat följande funktioner:

• Sandlådad LaTeX-kompilering med TeXLive Basic (2024–2026)
• Import/export med Pandoc (funktioner i SaaS-plattformen)
• Python Script Runner (funktioner i SaaS-plattformen)
• Stöd för Git-Bridge (funktioner i Server Pro)
• Avancerad referenssökning (funktioner i SaaS-plattformen)
• Adminpanel (global hantering av användare/projekt)
• Spåra ändringar (med panel för granskning och kommentarer)
• Fullständig projekthistorik (med återställning och nedladdning)
• Symbol Palette (funktioner i Server Pro/SaaS-plattformen)

Vanliga GitHub Codespaces har 32 GB lagringsutrymme. Det räcker inte för vår texlive-full-installation. För att testa den fullständiga avbildningen skickar du ett supportärende till GitHub om en Codespace med stora runners (8+ kärnor).

GitHub Sync, LDAP, OAuth, SSO, Zotero-integration och andra funktioner är inte konfigurerade i den här testmiljön. Se Toolkit-inställningar för mer information om hur du konfigurerar dessa funktioner i din egen driftsättning.

1. Skapa din GitHub Codespace

   Klicka på knappen nedan för att skapa din GitHub Codespace. När det gäller serverkonfiguration räcker 2 kärnor med 8 GB RAM i allmänhet för testsyften. Om du planerar att använda TeX Live Full rekommenderar vi en konfiguration med 8 kärnor och 64 GB.

   

2. Initiera Overleaf-instansen

   När din Codespace är klar kör du följande kommando i bash för att initiera din Overleaf-instans.

   bash

   ./init.sh
   

   Du kan behöva vänta i minst 3 minuter medan alla Docker-avbildningar du behöver hämtas.

   
3. Gör port 80 tillgänglig

   Växla till fliken Ports och följ sedan dessa steg för att göra port 80 offentlig.

   

   Därefter kan du klicka på Forwarded Address för att besöka din Overleaf-instans. Du kan behöva lägga till /launchpad för att komma till Overleafs välkomstsida.

4. Skapa ditt administratörskonto

   Ange ditt administratörskonto och lösenord och klicka sedan på knappen Register.

   
5. Börja skriva

   Nu är det dags att njuta av ditt skrivande i $\LaTeX$!

   

​

Använda TeXLive Full-avbildningen

Om du har tillgång till GitHub Codespaces med 8 kärnor/64 GB kan du använda TeXLive Full-avbildningen i den här testmiljön. Du kan ändra följande miljövariabler i filen toolkit/config/variables.env för att använda TeXLive Full-avbildningen i stället för TeXLive Basic-avbildningen.

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

När du har ändrat miljövariablerna måste du starta om Toolkit för att tillämpa ändringarna. Du kan köra följande kommando för att starta om Toolkit.

cd toolkit && bin/up -d