Template

Questa funzionalità è stata sviluppata inizialmente da yu-i-i/overleaf-cep e modificata e ottimizzata da ayaka-notes/overleaf-pro.

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. La creazione di un progetto da un template richiede sempre l’accesso.

​

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 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:

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:

#################
#   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 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 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 (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, poiché questa funzionalità fornisce ai tuoi utenti lo stesso ambiente TeX Live di 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 della documentazione.

1. Vai alla Template Gallery su overleaf.com e individua il template desiderato, ad esempio IEEE Photonics Journal Paper Template - Example Submission
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

Posso eliminare il progetto dopo aver pubblicato il template corrispondente?

Risposta: 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).

Perché per alcuni progetti la pubblicazione di un template richiede così tanto tempo?

Risposta: 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.

Un poster di grandi dimensioni