> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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 tramite le seguenti variabili d'ambiente: * `OVERLEAF_TEMPLATE_GALLERY`: Imposta su `true` per abilitare la Galleria dei template. * `OVERLEAF_TEMPLATE_CATEGORIES`: Un elenco facoltativo, 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, è possibile impostare le seguenti variabili d'ambiente facoltative: * `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 anteprime e miniature per i template. ### Permessi per la pubblicazione Gli amministratori possono pubblicare i template. Puoi anche assegnare a un utente non amministratore la gestione dei template selezionati mostrati nella tua galleria locale a `/templates`. Per farlo, dovrai impostare la variabile d'ambiente `OVERLEAF_TEMPLATES_USER_ID` in `toolkit/config/variables.env` all' `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 desideri 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* campo supporta la formattazione Markdown. * Il *Autore* campo 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 ################# # TEMPLATE # ################# 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 i formati per i principali editori e i server di preprint. TEMPLATE_BIBLIOGRAPHY_NAME=Bibliografie TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Stili per creare e gestire bibliografie con BibTeX o BibLaTeX. Adatti all'uso in articoli accademici, tesi e relazioni. TEMPLATE_BOOK_NAME=Libri TEMPLATE_BOOK_DESCRIPTION=Template per scrivere libri o documenti lunghi, inclusa la struttura dei capitoli, la prefazione e l'indicizzazione. TEMPLATE_CALENDAR_NAME=Calendari TEMPLATE_CALENDAR_DESCRIPTION=Template per creare calendari annuali, mensili o settimanali. Utili per agende personali o pianificazione di eventi. TEMPLATE_CV_NAME=CV e résumé TEMPLATE_CV_DESCRIPTION=Template per CV e résumé 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=Compiti TEMPLATE_HOMEWORK_DESCRIPTION=Template per compiti, lavori di corso e raccolte di esercizi. Progettati per essere chiari 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, tipicamente usati in conferenze e presentazioni di ricerca. TEMPLATE_PRESENTATION_NAME=Presentazioni TEMPLATE_PRESENTATION_DESCRIPTION=Template per Beamer e altri formati di presentazione, pensati per conferenze e lezioni accademiche. TEMPLATE_REPORT_NAME=Relazioni TEMPLATE_REPORT_DESCRIPTION=Template per relazioni tecniche, di laboratorio o di progetto. Includono 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=Sfoglia 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 schema di base di TeX Live per le compilazioni. Questa versione di base è leggera e contiene solo un insieme molto limitato di pacchetti LaTeX, il che molto probabilmente causerà errori di pacchetti mancanti per i tuoi utenti quando proveranno a usare template da [overleaf.com](https://www.overleaf.com/) nella tua istanza locale on-premise. Purtroppo, anche se non esiste un modo automatico per installare i pacchetti mancanti, disponiamo di un'impostazione configurabile in Server Pro che consentirà ai tuoi utenti di compilare i progetti con accesso a più pacchetti e in modo più sicuro. Questa funzionalità si chiama [Compilazioni in sandbox](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (note 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 [Compilazioni in sandbox](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 presente su [overleaf.com](https://www.overleaf.com/). Queste immagini contengono i pacchetti e i font più diffusi e sono già state testate con i nostri template della galleria. Puoi trovare ulteriori informazioni su come configurare le versioni di TeX Live tra cui gli utenti possono scegliere all'interno del loro progetto, insieme all'impostazione della 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 [Template per articolo IEEE Photonics Journal - Invio di esempio](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds) 2. Fai clic su **Apri come template** pulsante 3. Fai clic sul menu del progetto e scegli **Scarica il sorgente** 4. Quindi, accedi all'account Server Pro on-premise 5. Fai clic sul **Nuovo progetto** pulsante dalla 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, creiamo un'istantanea del progetto e salviamo il progetto come file zip al momento della pubblicazione. In questo modo, anche se elimini il progetto corrispondente al template, il template non verrà influenzato. Tuttavia, registreremo anche il ProjectID associato a questo template, il che renderà più semplice aggiornarlo in futuro. Se elimini il progetto corrispondente, non vedrai il pulsante "Admin: Source Project" nella pagina dei dettagli del template (vedi immagine sotto).
Per alcuni progetti, perché pubblicare 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 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, ne scegliamo uno intermedio come larghezza. Tuttavia, se la prima pagina del PDF contiene molto testo, la conversione delle miniature può richiedere 40 secondi o anche di 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://ayakaleaf-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.