> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Warning>
  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](https://docs.github.com/en/billing/concepts/product-billing/github-codespaces).

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

Abbiamo **preconfigurato** le seguenti funzionalità:

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

<Warning>
  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).
</Warning>

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](/it/on-premises/configuration/overleaf-toolkit/toolkit-settings) per maggiori dettagli su come configurare queste funzionalità nella tua installazione.

<Steps>
  <Step title="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**](https://github.com/ayaka-notes/texlive-full), ti consigliamo di scegliere una configurazione con **8 core e 64 GB**.

    [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/ayaka-notes/ayakaleaf-pro-playground)
  </Step>

  <Step title="Inizializza l'istanza Overleaf">
    Quando il tuo codespace è pronto, esegui il comando seguente nel terminale bash per inizializzare la tua istanza Overleaf.

    ```bash title="bash" theme={null}
    ./init.sh
    ```

    <Info>
      Potrebbe essere necessario attendere almeno 3 minuti per scaricare tutte le immagini Docker necessarie.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-26.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=8566b61de0757c1b270e7e5011d48a3e" alt="" width="1181" height="626" data-path="images/on-premises/image-26.png" />
    </Frame>
  </Step>

  <Step title="Rendi disponibile la porta 80">
    Passa alla scheda **Ports**, quindi segui questi passaggi per rendere pubblica la porta 80.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/on-premises/img-db37d3e4.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=81e5a18f3aebbd396a57d163a2460739" alt="" width="1452" height="694" data-path="images/on-premises/img-db37d3e4.png" />
    </Frame>

    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.
  </Step>

  <Step title="Crea il tuo account amministratore">
    Inserisci l'account e la password dell'amministratore, quindi fai clic sul pulsante Register.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-1ae40ae0.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=82d769561891fd4b4566ee2ad9c48065" alt="" width="2736" height="1798" data-path="images/on-premises/img-1ae40ae0.png" />
    </Frame>
  </Step>

  <Step title="Buona scrittura">
    Ora è il momento di goderti la scrittura in $\LaTeX$!

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-25.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=1d4e1fac863cbee906d9d3ad2f3c08d7" alt="" width="2104" height="1415" data-path="images/on-premises/image-25.png" />
    </Frame>
  </Step>
</Steps>

#### 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.

```dotenv wrap theme={null}
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.

```bash theme={null}
cd toolkit && bin/up -d
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.