Sjablonen

Deze functie is oorspronkelijk ontwikkeld door yu-i-i/overleaf-cep en aangepast en geoptimaliseerd door ayaka-notes/ayakaleaf-pro.

Standaard kunnen alleen ingelogde gebruikers door de galerij bladeren en sjabloonlinks openen. Om sjablonen te delen met niet-ingelogde bezoekers, stelt u ook OVERLEAF_ALLOW_PUBLIC_ACCESS=true in; zie Paginatoegang. Voor het aanmaken van een project vanuit een sjabloon is altijd een login vereist.

​

Configuratie

Vanaf 6.3.0 voert de galerij paginering, zoeken en sorteren uit op de server. Er is geen migratie nodig. Zie voor grote galerijen de optionele MongoDB-indexen in de release notes.

De functie Template Gallery wordt beheerd met de volgende omgevingsvariabelen:

• OVERLEAF_TEMPLATE_GALLERY: stel in op true om de Template Gallery in te schakelen.

• OVERLEAF_TEMPLATE_CATEGORIES: een optionele, door witruimte gescheiden lijst van nul of meer sleutels voor sjablooncategorieën. Geldige sleutels zijn onder meer:

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

  De speciale sleutel all wordt automatisch toegevoegd. Deze sleutel staat voor een categorie die alle sjablonen omvat.

  Voor elke categoriesleutel kunnen de volgende optionele omgevingsvariabelen worden ingesteld:

  • TEMPLATE_<KEY>_NAME: de weergavenaam van de sjablooncategorie.
  • TEMPLATE_<KEY>_DESCRIPTION: een korte beschrijving van de categorie.

  Als een categoriesleutel een koppelteken (-) bevat, vervangt u dit door een underscore (_) in de namen van de omgevingsvariabelen.

• ENABLE_CONVERSIONS: moet op true worden gezet om het genereren van miniaturen en voorbeelden voor sjablonen in te schakelen.

​

Rechten voor publiceren

Beheerders kunnen sjablonen publiceren. U kunt ook een gebruiker zonder beheerdersrechten aanwijzen om de geselecteerde sjablonen te beheren die in uw lokale galerij op /templates worden getoond.

Hiervoor stelt u de omgevingsvariabele OVERLEAF_TEMPLATES_USER_ID in toolkit/config/variables.env in op de ID van de gebruiker die binnen uw instantie verantwoordelijk is voor het sjabloonbeheer, bijvoorbeeld:

OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959

​

Sjablonen publiceren

Voor elk sjabloon dat u wilt uploaden:

1. Maak een project aan met de broncode van het sjabloon en zorg dat het compileert.
2. Kies in de editor File > Manage Template.
3. Vul in het formulier dat verschijnt de gegevens van het sjabloon in:
   • De Title moet uniek zijn.
   • Het veld Description ondersteunt Markdown-opmaak.
   • Het veld Author accepteert links in Markdown-opmaak.

Na het indienen kunnen de sjabloongegevens worden bewerkt of kan het sjabloon worden verwijderd via de pagina van de Template Gallery. Beheerders en de sjabloongebruiker (OVERLEAF_TEMPLATES_USER_ID) kunnen elk sjabloon beheren.

Hier is een voorbeeld:

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

​

Sjablonen overzetten van overleaf.com

Omdat Overleaf Pro is ontworpen om offline te werken, is er geen geautomatiseerde manier om galerijsjablonen van overleaf.com in uw on-premises installatie te integreren. Het is echter wel mogelijk om dit handmatig per sjabloon te doen.

Standaard is Overleaf Pro geconfigureerd om voor compilaties een basisschemaversie van TeXLive te gebruiken. Deze basisversie is lichtgewicht en bevat slechts een zeer beperkte subset van LaTeX-pakketten, wat waarschijnlijk tot fouten over ontbrekende pakketten leidt wanneer uw gebruikers sjablonen van overleaf.com proberen te gebruiken op uw lokale on-premises instantie.

Hoewel er helaas geen automatische manier is om ontbrekende pakketten te installeren, hebben we in Server Pro wel een configureerbare instelling waarmee uw gebruikers projecten kunnen compileren met toegang tot meer pakketten, en op een veiligere manier. Deze functie heet Sandbox Compiles (ook bekend als Sibling Containers).

Om ervoor te zorgen dat gedownloade sjablonen compatibel zijn met uw on-premises Server Pro-instantie, raden we sterk aan om Sandbox Compiles in te schakelen, omdat uw gebruikers dan toegang krijgen tot dezelfde TeX Live-omgeving als op overleaf.com. Deze images bevatten de populairste pakketten en lettertypen en zijn al getest met onze galerijsjablonen.

Meer informatie over het configureren van de TeX Live-versies waaruit gebruikers binnen hun project kunnen kiezen, en over het instellen van de standaardversie van de TeX Live-image voor nieuwe projecten, vindt u in de sectie Changing the TeX Live Image van onze documentatie.

1. Ga naar de Template Gallery op overleaf.com en zoek het gewenste sjabloon op, bijvoorbeeld IEEE Photonics Journal Paper Template - Example Submission
2. Klik op de knop Open as Template
3. Klik op het projectmenu en kies Download Source
4. Log vervolgens in op het account van de on-premises Server Pro
5. Klik in het projectdashboard op de knop New Project en kies Upload Project
6. Klik op de knop Select a .zip file en kies het gedownloade zipbestand van het sjabloon

De gebruiker kan dit nieuw geüploade sjabloon vervolgens in zijn eigen account gebruiken, of u kunt het als sjabloongebruiker publiceren zodat andere gebruikers het kunnen gebruiken.

​

Vragen en antwoorden

Kan ik het project verwijderen nadat ik het bijbehorende sjabloon heb gepubliceerd?

Antwoord: Ja, maar we raden dat af. Wanneer u een sjabloon publiceert, maken we een momentopname van het project en slaan we het project op het moment van publicatie op als zipbestand. Zo wordt het sjabloon niet beïnvloed, zelfs niet als u het bijbehorende project verwijdert.

We registreren echter ook de ProjectID die aan dit sjabloon is gekoppeld, zodat u het sjabloon in de toekomst eenvoudig kunt bijwerken.

Als u het bijbehorende project verwijdert, ziet u de knop “Admin: Source Project” niet meer op de detailpagina van het sjabloon (zie de afbeelding hieronder).

Waarom duurt het publiceren van een sjabloon bij sommige projecten zo lang?

Antwoord: Wanneer u het sjabloon publiceert, slaan we het project op als zip- en pdf-bestand, wat meestal snel gaat. We moeten echter ook miniaturen van de PDF genereren, zodat deze in de sjabloondetails kunnen worden weergegeven.

Hoe lang het genereren van miniaturen duurt, hangt meestal af van de inhoud van de eerste pagina van uw PDF. Om een balans te vinden tussen weergavekwaliteit en conversietijd, kiezen we een gemiddelde breedte.

Als de eerste pagina van de PDF echter veel tekst bevat, kan het converteren van de miniaturen 40 seconden of zelfs langer duren; even geduld dus. Hier is een voorbeeld van een grote poster; die duurt langer.

Een grote poster