Bruke GitHub Codespace

Den enkleste måten å teste Ayakaleaf Pro på er å bruke GitHub Codespace, der alle miljøvariabler er forhåndskonfigurert slik at du kan bruke det rett ut av boksen.

Når du kjører Docker-containere i GitHub Codespaces, slås ikke Codespace av automatisk, og du blir fortsatt fakturert. For faktureringsreglene for GitHub Codespaces, se faktureringsreglene for GitHub Codespaces.

For å administrere dine GitHub Codespaces går du til https://github.com/codespaces. Når du ikke lenger trenger den, må du huske å slette Codespace-en din i tide.

Vi har forhåndskonfigurert følgende funksjoner:

• Sandkassebasert LaTeX-kompilering med TeXLive Basic (2024-2026)
• Pandoc-import/-eksport (funksjon i SaaS-plattformen)
• Kjøring av Python-skript (funksjon i SaaS-plattformen)
• Git-Bridge-støtte (funksjon i Server Pro)
• Avansert referansesøk (funksjon i SaaS-plattformen)
• Administrasjonspanel (global administrasjon av brukere/prosjekter)
• Sporing av endringer (med gjennomgangs- og kommentarpanel)
• Full prosjekthistorikk (med gjenoppretting og nedlasting)
• Symbolpalett (funksjon i Server Pro/SaaS-plattformen)

Standard GitHub Codespaces har 32 GB lagringsplass. Dette er ikke nok for texlive-full-installasjonen vår. For å teste det fullstendige imaget sender du inn en supportforespørsel til GitHub om en Codespace med store runnere (8+ kjerner).

GitHub-synkronisering, LDAP, OAuth, SSO, Zotero-integrasjon og andre funksjoner er ikke konfigurert i denne lekeplassen. Se Toolkit-innstillingene for mer informasjon om hvordan du konfigurerer disse funksjonene i din egen distribusjon.

1. Opprett din GitHub Codespace

   Klikk på knappen nedenfor for å opprette din GitHub Codespace. Når det gjelder serverkonfigurasjon, er 2 kjerner med 8 GB RAM vanligvis tilstrekkelig for testformål. Hvis du planlegger å bruke TeX Live Full, anbefaler vi å velge en konfigurasjon med 8 kjerner og 64 GB.

   

2. Initialiser Overleaf-instansen

   Når Codespace-en din er klar, kjører du følgende kommando i bash for å initialisere Overleaf-instansen.

   bash

   ./init.sh
   

   Du må kanskje vente i minst 3 minutter før alle Docker-imagene du trenger, er hentet.

   
3. Gjør port 80 tilgjengelig

   Bytt til Ports-fanen, og følg deretter disse trinnene for å gjøre port 80 offentlig.

   

   Etter det kan du klikke på Forwarded Address for å besøke Overleaf-instansen din. Du må kanskje legge til /launchpad for å komme til velkomstsiden til Overleaf.

4. Opprett administratorkontoen din

   Skriv inn administratorkontoen og passordet ditt, og klikk deretter på Register-knappen.

   
5. God skriving

   Nå er det tid for å nyte $\LaTeX$-skrivingen din!

   

​

Bruke TeXLive Full-imaget

Hvis du har tilgang til GitHub Codespaces med 8 kjerner/64 GB, kan du bruke TeXLive Full-imaget i denne lekeplassen. Du kan endre følgende miljøvariabler i filen toolkit/config/variables.env for å bruke 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

Etter at du har endret miljøvariablene, må du starte Toolkit på nytt for å ta i bruk endringene. Du kan kjøre følgende kommando for å starte Toolkit på nytt.

cd toolkit && bin/up -d