> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/it/configurazione/overleaf-toolkit/templates.md). # Modelli {% hint style="info" %} Questa funzionalità è stata inizialmente sviluppata 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). {% endhint %} {% columns %} {% column %}
{% endcolumn %} {% column %}
{% endcolumn %} {% endcolumns %} ### Configurazione La funzionalità della Galleria dei template è controllata usando le seguenti variabili d'ambiente: * `OVERLEAF_TEMPLATE_GALLERY`: Impostare su `true` per abilitare la Galleria dei template. * `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. Questa chiave rappresenta una categoria che include tutti i template. Per ogni chiave di categoria, possono essere impostate le seguenti variabili d'ambiente opzionali: * `TEMPLATE__NAME`: Il nome visualizzato della categoria del template. * `TEMPLATE__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 impostato su `true` per abilitare la generazione di miniature e anteprime per i template. ### Permessi per la pubblicazione Gli amministratori possono pubblicare template. Puoi anche assegnare a un utente non amministratore la gestione dei template selezionati mostrati nella tua galleria locale all'indirizzo `/templates`. Per farlo, dovrai impostare la variabile d'ambiente `OVERLEAF_TEMPLATES_USER_ID` in `toolkit/config/variables.env` al `ID` dell'utente che sarà responsabile della gestione dei template nella tua istanza, ad esempio: ```dotenv OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959 ``` ### Pubblicazione dei template Per ogni template che vuoi caricare: 1. Crea un progetto contenente il codice sorgente del template e assicurati che compili. 2. Nel menu a sinistra dell'editor, scegli **Pubblica come template**. 3. Nel modulo che appare, inserisci i dettagli del template: * Il *Titolo* deve essere univoco. * Il *Descrizione* supporta la formattazione Markdown. * Il *Autore* accetta link formattati in Markdown. Dopo l'invio, i dettagli del template possono essere modificati, oppure il template può essere eliminato tramite la pagina della Galleria dei template. Gli utenti possono gestire i propri template; gli amministratori possono gestire qualsiasi template. Ecco un esempio: {% code overflow="wrap" expandable="true" %} ```dotenv ################# # 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=Articoli di rivista TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Template per invii a riviste accademiche, inclusi formati per i principali editori e server di preprint. TEMPLATE_BIBLIOGRAPHY_NAME=Bibliografie TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Stili per creare e gestire bibliografie con BibTeX o BibLaTeX. Adatto all'uso in articoli accademici, tesi e report. TEMPLATE_BOOK_NAME=Libri TEMPLATE_BOOK_DESCRIPTION=Template per scrivere libri o documenti lunghi, inclusa la strutturazione dei capitoli, le parti iniziali e l'indicizzazione. TEMPLATE_CALENDAR_NAME=Calendari TEMPLATE_CALENDAR_DESCRIPTION=Template per creare calendari annuali, mensili o settimanali. Utili per agende personali o per la pianificazione di eventi. TEMPLATE_CV_NAME=CV e curriculum vitae TEMPLATE_CV_DESCRIPTION=Template per CV e curriculum vitae con vari formati per posizioni accademiche, industriali e creative. TEMPLATE_FORMAL_LETTER_NAME=Lettere formali TEMPLATE_FORMAL_LETTER_DESCRIPTION=Template per lettere professionali, come lettere di presentazione, lettere di raccomandazione e corrispondenza ufficiale. TEMPLATE_HOMEWORK_NAME=Assegnazioni TEMPLATE_HOMEWORK_DESCRIPTION=Template per compiti, lavori di corso e set di esercizi. Progettati per essere puliti e ben strutturati per studenti e docenti. TEMPLATE_NEWSLETTER_NAME=Newsletter TEMPLATE_NEWSLETTER_DESCRIPTION=Template per creare newsletter con formati per comunicazioni accademiche, aziendali o di comunità. TEMPLATE_POSTER_NAME=Poster TEMPLATE_POSTER_DESCRIPTION=Template per poster scientifici e accademici, generalmente usati in conferenze e presentazioni di ricerca. TEMPLATE_PRESENTATION_NAME=Presentazioni TEMPLATE_PRESENTATION_DESCRIPTION=Template per Beamer e altri formati di presentazione, adattati a interventi accademici e lezioni. TEMPLATE_REPORT_NAME=Report TEMPLATE_REPORT_DESCRIPTION=Template per report tecnici, di laboratorio o di progetto. Include sezioni per figure, tabelle e riferimenti. TEMPLATE_THESIS_NAME=Tesi TEMPLATE_THESIS_DESCRIPTION=Template per scrivere tesi e dissertazioni, seguendo le linee guida istituzionali di formattazione e citazione. TEMPLATE_ALL_NAME=Tutti i template TEMPLATE_ALL_DESCRIPTION=Esplora una raccolta di tutti i template LaTeX disponibili, categorizzati per tipo di documento, stile e scopo. ``` {% endcode %} ### Trasferimento dei template da overleaf.com Poiché Overleaf Pro è stato progettato per funzionare offline, non esiste un modo automatico per integrare [overleaf.com](https://www.overleaf.com/) i template della galleria nella tua installazione on-premise; tuttavia è possibile farlo manualmente, template per template. Per impostazione predefinita, Overleaf Pro è configurato per usare una versione di base di TeXLive per le compilazioni. Questa versione di base è leggera e contiene solo un sottoinsieme molto limitato di pacchetti LaTeX, il che molto probabilmente comporterà errori di pacchetti mancanti per i tuoi utenti quando cercheranno di usare template da [overleaf.com](https://www.overleaf.com/) nella tua istanza locale on-premise. Purtroppo, sebbene non esista un modo automatico per installare i pacchetti mancanti, abbiamo un'impostazione configurabile in Server Pro che consentirà ai tuoi utenti di compilare i progetti con accesso a più pacchetti, 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 Server Pro on-premise, ti consigliamo vivamente di abilitare [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) poiché questa funzionalità fornirà ai tuoi utenti accesso allo stesso ambiente TeX Live di quello su [overleaf.com](https://www.overleaf.com/). Queste immagini contengono i pacchetti e i font più popolari e sono già state testate con i nostri template della galleria. Puoi trovare ulteriori informazioni su come configurare quali versioni di TeX Live gli utenti possono scegliere all'interno dei loro progetti, oltre a impostare la versione immagine predefinita di TeX Live per i nuovi progetti, nella [Modifica dell'immagine TeX Live](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) sezione della nostra documentazione. 1. Vai alla [Galleria dei template](https://www.overleaf.com/latex/templates) su [overleaf.com](https://www.overleaf.com/) e individua il template richiesto, 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 **Apri come template** pulsante 3. Fai clic sul menu del progetto e scegli **Scarica sorgente** 4. Quindi, accedi all'account Server Pro on-premise 5. Fai clic sul **Nuovo progetto** pulsante nella dashboard dei progetti e scegli **Carica progetto** 6. Fai clic sul **Seleziona un file .zip** pulsante e scegli il file zip del template scaricato L'utente potrà quindi usare questo template appena caricato nel proprio account oppure, come utente dei template, potrai pubblicarlo affinché altri utenti lo usino. ### Domande e risposte
Posso eliminare il progetto dopo aver pubblicato il template corrispondente? **Risposta:** Sì, ma non lo consigliamo. Quando pubblichi un template, facciamo uno snapshot del progetto e salviamo il progetto come file zip al momento della pubblicazione. Questo garantisce che, anche se elimini il progetto corrispondente al template, il template non ne risentirà. Tuttavia, registreremo anche il ProjectID associato a questo template, il che ti permetterà 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 sotto).
Per alcuni progetti, perché la pubblicazione di un template richiede così tanto tempo? **Risposta:** Quando pubblichi il template, salviamo il progetto come file zip e pdf, il che di solito è rapido. Tuttavia, dobbiamo anche generare le miniature per il PDF in modo che possano essere mostrate nei dettagli del template. Il tempo di generazione delle miniature dipende in genere dal contenuto della prima pagina del tuo PDF. Per bilanciare la qualità di visualizzazione e il tempo di conversione, scegliamo un valore intermedio come larghezza. Tuttavia, se la prima pagina del PDF contiene molto testo, la conversione delle miniature può richiedere 40 secondi o anche più; ti preghiamo di avere pazienza. Ecco un esempio di poster di grandi dimensioni: richiederà più tempo.

Un poster di grandi dimensioni

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/on-premises/it/configurazione/overleaf-toolkit/templates.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.