Mallar

Den här funktionen utvecklades ursprungligen av yu-i-i/overleaf-cep och har modifierats och optimerats av ayaka-notes/overleaf-pro.

Som standard kan bara inloggade användare bläddra i galleriet och öppna mallänkar. För att dela mallar med utloggade besökare sätter du även OVERLEAF_ALLOW_PUBLIC_ACCESS=true, se Sidåtkomst. Att skapa ett projekt från en mall kräver alltid inloggning.

​

Konfiguration

Från och med 6.3.0 utför galleriet sidindelning, sökning och sortering på servern. Ingen migrering krävs. För stora gallerier, se de valfria MongoDB-indexen i versionsinformationen.

Funktionen Template Gallery styrs med följande miljövariabler:

• OVERLEAF_TEMPLATE_GALLERY: Sätt till true för att aktivera Template Gallery.

• OVERLEAF_TEMPLATE_CATEGORIES: En valfri, blankstegsseparerad lista med noll eller flera nycklar för mallkategorier. Giltiga nycklar är:

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

  Specialnyckeln all läggs till automatiskt. Den representerar en kategori som innehåller alla mallar.

  För varje kategorinyckel kan följande valfria miljövariabler sättas:

  • TEMPLATE_<KEY>_NAME: Mallkategorins visningsnamn.
  • TEMPLATE_<KEY>_DESCRIPTION: En kort beskrivning av kategorin.

  Om en kategorinyckel innehåller ett bindestreck (-) ersätter du det med ett understreck (_) i miljövariabelnamnen.

• ENABLE_CONVERSIONS: Måste sättas till true för att aktivera generering av miniatyrbilder och förhandsvisningar för mallar.

​

Behörigheter för publicering

Administratörer kan publicera mallar. Du kan också utse en användare som inte är administratör att hantera de utvalda mallarna som visas i ditt lokala galleri på /templates.

För att göra det sätter du miljövariabeln OVERLEAF_TEMPLATES_USER_ID i toolkit/config/variables.env till ID för den användare som ska ansvara för mallhanteringen i din instans, till exempel:

OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959

​

Publicera mallar

För varje mall du vill ladda upp:

1. Skapa ett projekt som innehåller mallens källkod och kontrollera att det går att kompilera.
2. Välj File > Manage Template i editorn.
3. Ange mallens uppgifter i formuläret som visas:
   • Title måste vara unik.
   • Fältet Description stöder Markdown-formatering.
   • Fältet Author accepterar länkar formaterade med Markdown.

När mallen har skickats in kan uppgifterna redigeras, eller mallen tas bort, via sidan Template Gallery. Administratörer och mallanvändaren (OVERLEAF_TEMPLATES_USER_ID) kan hantera alla mallar.

Här är ett exempel:

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

​

Överföra mallar från overleaf.com

Eftersom Overleaf Pro är utformat för att fungera offline finns det inget automatiserat sätt att integrera mallar från galleriet på overleaf.com i din lokala installation, men det går att göra manuellt för en mall i taget.

Som standard är Overleaf Pro konfigurerat att använda en version av TeXLive med basic-schemat för kompilering. Den här grundversionen är lättviktig och innehåller bara en mycket begränsad delmängd av LaTeX-paket, vilket med största sannolikhet leder till fel om saknade paket när dina användare försöker använda mallar från overleaf.com på din lokala instans.

Tyvärr finns det inget automatiskt sätt att installera saknade paket, men det finns en konfigurerbar inställning i Server Pro som låter dina användare kompilera projekt med tillgång till fler paket, och på ett säkrare sätt. Funktionen heter Sandbox Compiles (även kallad Sibling Containers).

För att säkerställa att nedladdade mallar är kompatibla med din lokala Server Pro-instans rekommenderar vi starkt att du aktiverar Sandbox Compiles, eftersom funktionen ger dina användare tillgång till samma TeX Live-miljö som på overleaf.com. Dessa images innehåller de mest populära paketen och typsnitten och har redan testats mot våra gallerimallar.

Mer information om hur du konfigurerar vilka TeX Live-versioner användarna kan välja mellan i sina projekt, samt hur du anger standardversionen av TeX Live-imagen för nya projekt, finns i avsnittet Changing the TeX Live Image i vår dokumentation.

1. Gå till Template Gallery på overleaf.com och leta upp önskad mall, till exempel IEEE Photonics Journal Paper Template - Example Submission
2. Klicka på knappen Open as Template
3. Klicka på projektmenyn och välj Download Source
4. Logga sedan in på kontot i den lokala Server Pro-instansen
5. Klicka på knappen New Project på projektöversikten och välj Upload Project
6. Klicka på knappen Select a .zip file och välj den nedladdade zip-filen med mallen

Användaren kan sedan använda den nyuppladdade mallen i sitt eget konto, eller så kan du som mallanvändare publicera den så att andra användare kan använda den.

​

Frågor och svar

Kan jag ta bort projektet efter att ha publicerat motsvarande mall?

Svar: Ja, men vi rekommenderar inte det. När du publicerar en mall tar vi en ögonblicksbild av projektet och sparar det som en zip-fil vid publiceringstillfället. Det säkerställer att mallen inte påverkas även om du tar bort projektet som hör till mallen.

Vi registrerar dock även det ProjectID som är kopplat till mallen, vilket gör det enkelt för dig att uppdatera mallen i framtiden.

Om du tar bort motsvarande projekt ser du inte knappen “Admin: Source Project” på mallens detaljsida (se bilden nedan).

Varför tar det så lång tid att publicera en mall för vissa projekt?

Svar: När du publicerar mallen sparar vi projektet som en zip- och en pdf-fil, vilket oftast går snabbt. Vi måste dock också generera miniatyrbilder av PDF-filen så att de kan visas i mallens detaljer.

Tiden för att generera miniatyrbilder beror vanligtvis på innehållet på PDF-filens första sida. För att balansera visningskvalitet och konverteringstid väljer vi en medelstor bredd.

Om PDF-filens första sida innehåller mycket text kan konverteringen av miniatyrbilderna dock ta 40 sekunder eller ännu längre, så ha tålamod. Här är ett exempel på en stor poster som tar längre tid.

En stor poster