Brug af GitHub Codespace

Den nemmeste måde at teste vores Ayakaleaf Pro på er at bruge GitHub Codespace, hvor alle miljøvariabler er forudkonfigureret, så du kan bruge det direkte ud af boksen.

Når du kører Docker-containere med GitHub Codespaces, lukker Codespace ikke automatisk ned og bliver ved med at blive faktureret. Se GitHub Codespaces’ faktureringsregler for reglerne for fakturering af GitHub Codespaces.

Gå til https://github.com/codespaces for at administrere dine GitHub Codespaces. Når du ikke længere har brug for det, så slet dit Codespace i tide.

Vi har forudkonfigureret følgende funktioner:

• LaTeX-kompilering i sandbox med TeXLive Basic (2024-2026)
• Pandoc-import/-eksport (funktion fra SaaS-platformen)
• Python-scriptkørsel (funktion fra SaaS-platformen)
• Git-Bridge-understøttelse (funktion fra Server Pro)
• Avanceret referencesøgning (funktion fra SaaS-platformen)
• Administrationspanel (global administration af brugere/projekter)
• Sporing af ændringer (med gennemgangs- og kommentarpanel)
• Fuld projekthistorik (med gendannelse og download)
• Symbolpalet (funktion fra Server Pro/SaaS-platformen)

Standard-GitHub Codespaces har 32 GB lagerplads. Det er ikke nok til vores texlive-full-installation. For at teste det fulde image skal du oprette en supportsag hos GitHub om et Codespace med store runners (8+ kerner).

GitHub-synkronisering, LDAP, OAuth, SSO, Zotero-integration og andre funktioner er ikke konfigureret i denne playground. Se Toolkit-indstillinger for flere detaljer om, hvordan du konfigurerer disse funktioner i din egen udrulning.

1. Opret dit GitHub Codespace

   Klik på følgende knap for at oprette dit GitHub Codespace. Med hensyn til serverkonfiguration er 2 kerner med 8 GB RAM generelt tilstrækkeligt til et testforløb. Hvis du planlægger at bruge TeX Live Full, anbefaler vi at vælge en konfiguration med 8 kerner og 64 GB.

   

2. Initialiser Overleaf-instansen

   Når dit codespace er klar, skal du køre følgende kommando i din bash for at initialisere din Overleaf-instans.

   bash

   ./init.sh
   

   Du skal muligvis vente mindst 3 minutter, før alle de Docker-images, du har brug for, er hentet.

   
3. Gør port 80 tilgængelig

   Skift til fanen Ports, og følg derefter disse trin for at gøre port 80 offentlig.

   

   Derefter kan du klikke på Forwarded Address for at besøge din Overleaf-instans. Du skal muligvis tilføje /launchpad for at besøge Overleafs velkomstside.

4. Opret din administratorkonto

   Indtast din administratorkonto og adgangskode, og klik derefter på knappen Register.

   
5. God fornøjelse med skrivningen

   Nu er det tid til at nyde din $\LaTeX$-skrivning!

   

​

Brug TeXLive Full-imaget

Hvis du har adgang til GitHub Codespaces med 8 kerner/64 GB, kan du bruge TeXLive Full-imaget i denne playground. Du kan ændre følgende miljøvariabler i filen toolkit/config/variables.env for at bruge TeXLive Full-imaget i stedet for TeXLive Basic-imaget.

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 ændret miljøvariablerne, skal du genstarte toolkittet for at anvende ændringerne. Du kan køre følgende kommando for at genstarte toolkittet.

cd toolkit && bin/up -d