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

# Template

<Info>
  Questa funzionalità è stata sviluppata inizialmente da [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep) e modificata e ottimizzata da [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
</Info>

<Info>
  Per impostazione predefinita, solo gli utenti che hanno effettuato l'accesso possono sfogliare la galleria e aprire i link ai template. Per condividere i template con i visitatori non autenticati, imposta anche `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`; vedi [Accesso alle pagine](/it/on-premises/configuration/overleaf-toolkit/public-access#page-access "mention"). La creazione di un progetto da un template richiede sempre l'accesso.
</Info>

<Columns cols={2}>
  <Column>
    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-31.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=5a12bd99f99c99910e7eae3d1b5f010c" alt="" width="3078" height="2405" data-path="images/on-premises/image-31.png" />
    </Frame>
  </Column>

  <Column>
    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-32.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=c71bb498c75535f0d2569d55625b31bc" alt="" width="3078" height="2405" data-path="images/on-premises/image-32.png" />
    </Frame>
  </Column>
</Columns>

### Configurazione

A partire dalla versione 6.3.0, la galleria esegue paginazione, ricerca e ordinamento lato server. Non è necessaria alcuna migrazione. Per gallerie di grandi dimensioni, consulta gli [indici MongoDB opzionali](/it/on-premises/release-notes/release-notes-6.x.x#feature-04-template-pagination "mention") nelle note di rilascio.

La funzionalità Template Gallery è controllata tramite le seguenti variabili d'ambiente:

* `OVERLEAF_TEMPLATE_GALLERY`: imposta su `true` per abilitare la Template Gallery.
* `OVERLEAF_TEMPLATE_CATEGORIES`: un elenco opzionale, separato da spazi, di zero o più chiavi di categoria dei template. Le chiavi valide includono:

  * *`academic-journal`*
  * *`book`*
  * *`presentation`*
  * *`poster`*
  * *`cv`*
  * *`homework`*
  * *`bibliography`*
  * *`calendar`*
  * *`formal-letter`*
  * *`report`*
  * *`thesis`*
  * *`newsletter`*

  La chiave speciale *`all`* viene aggiunta automaticamente. Rappresenta una categoria che include tutti i template.

  Per ogni chiave di categoria è possibile impostare le seguenti variabili d'ambiente opzionali:

  * `TEMPLATE_<KEY>_NAME`: il nome visualizzato della categoria di template.
  * `TEMPLATE_<KEY>_DESCRIPTION`: una breve descrizione della categoria.

  Se una chiave di categoria contiene un trattino (`-`), sostituiscilo con un trattino basso (`_`) nei nomi delle variabili d'ambiente.
* `ENABLE_CONVERSIONS`: deve essere impostata su `true` per abilitare la generazione di miniature e anteprime per i template.

### Permessi di pubblicazione

Gli amministratori possono pubblicare template. Puoi anche assegnare a un utente non amministratore la gestione dei template selezionati mostrati nella tua galleria locale in `/templates`.

Per farlo, devi impostare la variabile d'ambiente `OVERLEAF_TEMPLATES_USER_ID` in `toolkit/config/variables.env` sull'`ID` dell'utente che sarà responsabile della gestione dei template nella tua istanza, ad esempio:

```dotenv theme={null}
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```

### Pubblicare i template

Per ogni template che vuoi caricare:

1. Crea un progetto contenente il codice sorgente del template e assicurati che venga compilato.
2. Nell'editor, scegli **File** > **Manage Template**.
3. Nel modulo che compare, inserisci i dettagli del template:
   * Il campo *Title* deve essere univoco.
   * Il campo *Description* supporta la formattazione Markdown.
   * Il campo *Author* accetta link in formato Markdown.

Dopo l'invio, i dettagli del template possono essere modificati, oppure il template può essere eliminato dalla pagina della Template Gallery. Gli amministratori e l'utente dei template (`OVERLEAF_TEMPLATES_USER_ID`) possono gestire qualsiasi template.

Ecco un esempio:

```dotenv wrap expandable theme={null}
#################
#   TEMPLATES   #
#################

ENABLE_CONVERSIONS=true

OVERLEAF_TEMPLATE_GALLERY=true
OVERLEAF_TEMPLATE_CATEGORIES=academic-journal book presentation poster cv homework bibliography calendar formal-letter report thesis newsletter

TEMPLATE_ACADEMIC_JOURNAL_NAME=Journal articles
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Templates for academic journal submissions, including formats for major publishers and preprint servers.

TEMPLATE_BIBLIOGRAPHY_NAME=Bibliographies
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Styles for creating and managing bibliographies with BibTeX or BibLaTeX. Suitable for use in academic papers, theses, and reports.

TEMPLATE_BOOK_NAME=Books
TEMPLATE_BOOK_DESCRIPTION=Templates for writing books or long-form documents, including chapter structuring, front matter, and indexing.

TEMPLATE_CALENDAR_NAME=Calendars
TEMPLATE_CALENDAR_DESCRIPTION=Templates to create yearly, monthly, or weekly calendars. Useful for personal planners or event scheduling.

TEMPLATE_CV_NAME=CVs and résumés
TEMPLATE_CV_DESCRIPTION=Templates for CVs and résumés with various formats for academic, industry, and creative positions.

TEMPLATE_FORMAL_LETTER_NAME=Formal letters
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Templates for professional letters, such as cover letters, recommendation letters, and official correspondence.

TEMPLATE_HOMEWORK_NAME=Assignments
TEMPLATE_HOMEWORK_DESCRIPTION=Templates for homework, coursework, and problem sets. Designed to be clean and well-structured for students and educators.

TEMPLATE_NEWSLETTER_NAME=Newsletters
TEMPLATE_NEWSLETTER_DESCRIPTION=Templates for creating newsletters with formats for academic, corporate, or community communications.

TEMPLATE_POSTER_NAME=Posters
TEMPLATE_POSTER_DESCRIPTION=Templates for scientific and academic posters, typically used in conferences and research presentations.

TEMPLATE_PRESENTATION_NAME=Presentations
TEMPLATE_PRESENTATION_DESCRIPTION=Templates for Beamer and other presentation formats, tailored for academic talks and lectures.

TEMPLATE_REPORT_NAME=Reports
TEMPLATE_REPORT_DESCRIPTION=Templates for technical, lab, or project reports. Includes sections for figures, tables, and references.

TEMPLATE_THESIS_NAME=Theses
TEMPLATE_THESIS_DESCRIPTION=Templates for writing theses and dissertations, following institutional formatting and citation guidelines.

TEMPLATE_ALL_NAME=All templates
TEMPLATE_ALL_DESCRIPTION=Browse a collection of all available LaTeX templates, categorized by document type, style, and purpose.

```

### Trasferire template da overleaf.com

Poiché Overleaf Pro è progettato per funzionare offline, non esiste un modo automatico per integrare i template della galleria di [overleaf.com](https://www.overleaf.com/) nella tua installazione on-premise; è tuttavia possibile farlo manualmente, un template alla volta.

Per impostazione predefinita, Overleaf Pro è configurato per usare una versione con schema di base di TeXLive per le compilazioni. Questa versione di base è leggera e contiene solo un sottoinsieme molto limitato di pacchetti LaTeX, il che con ogni probabilità causerà errori di pacchetti mancanti per i tuoi utenti quando tenteranno di usare template di [overleaf.com](https://www.overleaf.com/) sulla tua istanza on-premise locale.

Purtroppo non esiste un modo automatico per installare i pacchetti mancanti, ma Server Pro offre un'impostazione configurabile che consente ai tuoi utenti di compilare i progetti con accesso a più pacchetti e in modo più sicuro. Questa funzionalità si chiama [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (nota anche come Sibling Containers).

Per garantire che i template scaricati siano compatibili con la tua istanza on-premise di Server Pro, ti consigliamo vivamente di abilitare le [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles), poiché questa funzionalità fornisce ai tuoi utenti lo stesso ambiente TeX Live di [overleaf.com](https://www.overleaf.com/). Queste immagini contengono i pacchetti e i font più diffusi e sono già state testate con i template della nostra galleria.

Puoi trovare ulteriori informazioni su come configurare le versioni di TeX Live tra cui gli utenti possono scegliere nei propri progetti, e su come impostare la versione predefinita dell'immagine TeX Live per i nuovi progetti, nella sezione [Changing the TeX Live Image](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) della documentazione.

1. Vai alla [Template Gallery](https://www.overleaf.com/latex/templates) su [overleaf.com](https://www.overleaf.com/) e individua il template desiderato, ad esempio [IEEE Photonics Journal Paper Template - Example Submission](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. Fai clic sul pulsante **Open as Template**
3. Fai clic sul menu del progetto e scegli **Download Source**
4. Quindi accedi all'account di Server Pro on-premise
5. Fai clic sul pulsante **New Project** nella dashboard dei progetti e scegli **Upload Project**
6. Fai clic sul pulsante **Select a .zip file** e scegli il file zip del template scaricato

L'utente può quindi usare il template appena caricato nel proprio account oppure, in qualità di utente dei template, puoi pubblicarlo affinché lo usino altri utenti.

### Domande e risposte

<Accordion title="Posso eliminare il progetto dopo aver pubblicato il template corrispondente?">
  <strong>Risposta:</strong> Sì, ma non lo consigliamo. Quando pubblichi un template, al momento della pubblicazione viene acquisito uno snapshot del progetto e il progetto viene salvato come file zip. In questo modo, anche se elimini il progetto corrispondente al template, il template non ne risentirà.

  Tuttavia, viene registrato anche il ProjectID associato a questo template, il che ti consente di aggiornare facilmente il template in futuro.

  Se elimini il progetto corrispondente, non vedrai il pulsante "Admin: Source Project" nella pagina dei dettagli del template (vedi l'immagine qui sotto).

  <Frame>
    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-30.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=2bc8ec10c24599e1a6d0b247aef23cc9" alt="" width="2720" height="1824" data-path="images/on-premises/image-30.png" />
  </Frame>
</Accordion>

<Accordion title="Perché per alcuni progetti la pubblicazione di un template richiede così tanto tempo?">
  <strong>Risposta:</strong> Quando pubblichi il template, il progetto viene salvato come file zip e pdf, operazione di solito rapida. Tuttavia è necessario anche generare le miniature del PDF, in modo che possano essere visualizzate nei dettagli del template.

  Il tempo di generazione delle miniature dipende in genere dal contenuto della prima pagina del PDF. Per bilanciare qualità di visualizzazione e tempo di conversione, scegliamo una larghezza intermedia.

  Tuttavia, se la prima pagina del PDF contiene molto testo, la conversione delle miniature può richiedere 40 secondi o anche di più: abbi pazienza. Ecco l'esempio di un poster di grandi dimensioni, che richiederà più tempo.

  <Frame caption="Un poster di grandi dimensioni">
    <img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/on-premises/preview.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=8fd572d5ef8b86ea6c62e16a6db8ec10" alt="" width="188" data-path="images/on-premises/preview.png" />
  </Frame>
</Accordion>


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