Maler

Denne funksjonen ble opprinnelig utviklet av yu-i-i/overleaf-cep, og er endret og optimalisert av ayaka-notes/overleaf-pro.

Som standard kan bare innloggede brukere bla gjennom galleriet og åpne mallenker. For å dele maler med utloggede besøkende må du også sette OVERLEAF_ALLOW_PUBLIC_ACCESS=true, se Page Access. Å opprette et prosjekt fra en mal krever alltid innlogging.

​

Konfigurasjon

Fra og med 6.3.0 utfører galleriet paginering, søk og sortering på serveren. Ingen migrering er nødvendig. For store gallerier, se de valgfrie MongoDB-indeksene i versjonsmerknadene.

Malgallerifunksjonen styres med følgende miljøvariabler:

• OVERLEAF_TEMPLATE_GALLERY: Sett til true for å aktivere malgalleriet.

• OVERLEAF_TEMPLATE_CATEGORIES: En valgfri, mellomromsseparert liste med null eller flere nøkler for malkategorier. Gyldige nøkler inkluderer:

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

  Spesialnøkkelen all legges til automatisk. Denne nøkkelen representerer en kategori som inneholder alle maler.

  For hver kategorinøkkel kan følgende valgfrie miljøvariabler settes:

  • TEMPLATE_<KEY>_NAME: Visningsnavnet til malkategorien.
  • TEMPLATE_<KEY>_DESCRIPTION: En kort beskrivelse av kategorien.

  Hvis en kategorinøkkel inneholder bindestrek (-), erstatter du den med understrek (_) i navnene på miljøvariablene.

• ENABLE_CONVERSIONS: Må settes til true for å aktivere generering av miniatyrbilder og forhåndsvisninger for maler.

​

Tillatelser for publisering

Administratorer kan publisere maler. Du kan også tildele en bruker uten administratorrettigheter ansvaret for de kuraterte malene som vises i det lokale galleriet på /templates.

For å gjøre dette må du sette miljøvariabelen OVERLEAF_TEMPLATES_USER_ID i toolkit/config/variables.env til ID-en til brukeren som skal ha ansvar for maladministrasjon i instansen din, for eksempel:

OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959

​

Publisere maler

For hver mal du vil laste opp:

1. Opprett et prosjekt som inneholder malens kildekode, og sørg for at det kompilerer.
2. I editoren velger du File > Manage Template.
3. Fyll inn maldetaljene i skjemaet som vises:
   • Title må være unik.
   • Feltet Description støtter Markdown-formatering.
   • Feltet Author godtar Markdown-formaterte lenker.

Etter innsending kan maldetaljene redigeres, eller malen kan slettes via siden for malgalleriet. Administratorer og malbrukeren (OVERLEAF_TEMPLATES_USER_ID) kan administrere alle maler.

Her er et eksempel:

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

​

Overføre maler fra overleaf.com

Siden Overleaf Pro er bygget for å fungere uten nett, finnes det ingen automatisk måte å integrere gallerimaler fra overleaf.com i den lokale installasjonen på, men det er mulig å gjøre dette manuelt for hver enkelt mal.

Som standard er Overleaf Pro konfigurert til å bruke en grunnleggende skjemaversjon av TeXLive for kompilering. Denne grunnleggende versjonen er lettvektig og inneholder bare et svært begrenset utvalg av LaTeX-pakker, noe som mest sannsynlig vil gi brukerne feil om manglende pakker når de prøver å bruke maler fra overleaf.com på den lokale instansen.

Selv om det dessverre ikke finnes noen automatisk måte å installere manglende pakker på, har vi en konfigurerbar innstilling i Server Pro som lar brukerne kompilere prosjekter med tilgang til flere pakker, og på en sikrere måte. Denne funksjonen kalles Sandbox Compiles (også kjent som Sibling Containers).

For å sikre at nedlastede maler er kompatible med den lokale Server Pro-instansen, anbefaler vi sterkt at du aktiverer Sandbox Compiles, siden denne funksjonen gir brukerne tilgang til det samme TeX Live-miljøet som på overleaf.com. Disse imagene inneholder de mest populære pakkene og skrifttypene og er allerede testet mot gallerimalene våre.

Du finner mer informasjon om hvordan du konfigurerer hvilke TeX Live-versjoner brukerne kan velge mellom i prosjektene sine, og hvordan du angir standardversjonen av TeX Live-imaget for nye prosjekter, i avsnittet Changing the TeX Live Image i dokumentasjonen vår.

1. Gå til Template Gallery på overleaf.com og finn ønsket mal, for eksempel IEEE Photonics Journal Paper Template - Example Submission
2. Klikk på knappen Open as Template
3. Klikk på prosjektmenyen og velg Download Source
4. Logg deretter inn på kontoen i den lokale Server Pro-instansen
5. Klikk på knappen New Project i prosjektoversikten og velg Upload Project
6. Klikk på knappen Select a .zip file og velg den nedlastede zip-filen med malen

Brukeren kan deretter bruke denne nylig opplastede malen i sin egen konto, eller du kan som malbruker publisere den slik at andre brukere kan bruke den.

​

Spørsmål og svar

Kan jeg slette prosjektet etter at jeg har publisert den tilhørende malen?

Svar: Ja, men vi anbefaler det ikke. Når du publiserer en mal, tar vi et øyeblikksbilde av prosjektet og lagrer det som en zip-fil på publiseringstidspunktet. Dette sikrer at malen ikke påvirkes selv om du sletter prosjektet som hører til malen.

Vi registrerer imidlertid også ProjectID-en som er knyttet til malen, noe som gjør det enkelt for deg å oppdatere malen senere.

Hvis du sletter det tilhørende prosjektet, vil du ikke se knappen “Admin: Source Project” på siden med maldetaljer (se bildet nedenfor).

Hvorfor tar det så lang tid å publisere en mal for enkelte prosjekter?

Svar: Når du publiserer malen, lagrer vi prosjektet som en zip-fil og en pdf-fil, noe som vanligvis går raskt. Vi må imidlertid også generere miniatyrbilder av PDF-en slik at de kan vises i maldetaljene.

Tiden det tar å generere miniatyrbilder avhenger vanligvis av innholdet på første side i PDF-en. For å balansere mellom visningskvalitet og konverteringstid velger vi en middels bredde.

Hvis den første siden i PDF-en inneholder mye tekst, kan konverteringen av miniatyrbildene ta 40 sekunder eller mer, så vær tålmodig. Her er et eksempel på en stor plakat som vil ta lengre tid.

En stor plakat