Usare GitHub Codespace

Il modo più semplice per provare Ayakaleaf Pro è usare GitHub Codespace, dove tutte le variabili d’ambiente sono preconfigurate per consentirti di usarlo subito, senza alcuna configurazione.

Quando esegui container Docker con GitHub Codespaces, il Codespace non si spegne automaticamente e continuerà a essere fatturato. Per le regole di fatturazione di GitHub Codespaces, consulta le regole di fatturazione di GitHub Codespaces.

Per gestire i tuoi GitHub Codespaces, visita https://github.com/codespaces. Quando non ti serve più, ricordati di eliminare tempestivamente il tuo Codespace.

Abbiamo preconfigurato le seguenti funzionalità:

• Compilazione LaTeX in sandbox con TeXLive Basic (2024-2026)
• Importazione/esportazione Pandoc (funzionalità della piattaforma SaaS)
• Esecuzione di script Python (funzionalità della piattaforma SaaS)
• Supporto Git-Bridge (funzionalità di Server Pro)
• Ricerca avanzata dei riferimenti (funzionalità della piattaforma SaaS)
• Pannello di amministrazione (gestione globale di utenti/progetti)
• Revisioni (con pannello di revisione e commenti)
• Cronologia completa del progetto (con ripristino e download)
• Tavolozza dei simboli (funzionalità di Server Pro/piattaforma SaaS)

I GitHub Codespaces standard offrono 32 GB di spazio di archiviazione, che non bastano per la nostra installazione texlive-full. Per provare l’immagine completa, apri un ticket di supporto GitHub per ottenere un Codespace con runner di grandi dimensioni (8+ core).

GitHub Sync, LDAP, OAuth, SSO, l’integrazione con Zotero e altre funzionalità non sono configurate in questo ambiente di prova. Puoi consultare le impostazioni del Toolkit per maggiori dettagli su come configurare queste funzionalità nella tua installazione.

1. Crea il tuo GitHub Codespace

   Fai clic sul pulsante seguente per creare il tuo GitHub Codespace. Per quanto riguarda la configurazione del server, 2 core con 8 GB di RAM sono generalmente sufficienti per una prova. Se prevedi di usare TeX Live Full, ti consigliamo di scegliere una configurazione con 8 core e 64 GB.

   

2. Inizializza l'istanza Overleaf

   Quando il tuo codespace è pronto, esegui il comando seguente nel terminale bash per inizializzare la tua istanza Overleaf.

   bash

   ./init.sh
   

   Potrebbe essere necessario attendere almeno 3 minuti per scaricare tutte le immagini Docker necessarie.

   
3. Rendi disponibile la porta 80

   Passa alla scheda Ports, quindi segui questi passaggi per rendere pubblica la porta 80.

   

   Dopodiché puoi fare clic su Forwarded Address per visitare la tua istanza Overleaf. Potrebbe essere necessario aggiungere /launchpad per visitare la pagina di benvenuto di Overleaf.

4. Crea il tuo account amministratore

   Inserisci l’account e la password dell’amministratore, quindi fai clic sul pulsante Register.

   
5. Buona scrittura

   Ora è il momento di goderti la scrittura in $\LaTeX$!

   

​

Usare l’immagine TeXLive Full

Se hai accesso a GitHub Codespaces con 8 core/64 GB, puoi usare l’immagine TeXLive Full in questo ambiente di prova. Puoi modificare le seguenti variabili d’ambiente nel file toolkit/config/variables.env per usare l’immagine TeXLive Full al posto dell’immagine TeXLive Basic.

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

Dopo aver modificato le variabili d’ambiente, devi riavviare il Toolkit per applicare le modifiche. Puoi eseguire il comando seguente per riavviarlo.

cd toolkit && bin/up -d