Mallipohjat

Tämän ominaisuuden kehitti alun perin yu-i-i/overleaf-cep, ja sitä on muokannut ja optimoinut ayaka-notes/overleaf-pro.

Oletusarvoisesti vain sisäänkirjautuneet käyttäjät voivat selata valikoimaa ja avata mallilinkkejä. Jos haluat jakaa malleja uloskirjautuneille vierailijoille, aseta lisäksi OVERLEAF_ALLOW_PUBLIC_ACCESS=true, katso Sivujen käyttö. Projektin luominen mallista edellyttää aina kirjautumista.

​

Määritys

Versiosta 6.3.0 alkaen valikoima suorittaa sivutuksen, haun ja lajittelun palvelimella. Siirtoa ei tarvita. Suurille valikoimille katso julkaisutiedoista valinnaiset MongoDB-indeksit.

Mallivalikoima-ominaisuutta ohjataan seuraavilla ympäristömuuttujilla:

• OVERLEAF_TEMPLATE_GALLERY: Aseta arvoon true ottaaksesi mallivalikoiman käyttöön.

• OVERLEAF_TEMPLATE_CATEGORIES: Valinnainen välilyönnein eroteltu luettelo, jossa on nolla tai useampia mallikategorioiden avaimia. Kelvollisia avaimia ovat:

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

  Erityinen avain all lisätään automaattisesti. Se edustaa kategoriaa, joka sisältää kaikki mallit.

  Kullekin kategoria-avaimelle voidaan asettaa seuraavat valinnaiset ympäristömuuttujat:

  • TEMPLATE_<KEY>_NAME: Mallikategorian näyttönimi.
  • TEMPLATE_<KEY>_DESCRIPTION: Kategorian lyhyt kuvaus.

  Jos kategoria-avain sisältää yhdysmerkin (-), korvaa se ympäristömuuttujien nimissä alaviivalla (_).

• ENABLE_CONVERSIONS: On asetettava arvoon true, jotta mallien pikkukuvien ja esikatselujen luonti on käytössä.

​

Julkaisuoikeudet

Ylläpitäjät voivat julkaista malleja. Voit myös määrätä käyttäjän, joka ei ole ylläpitäjä, hallinnoimaan paikallisessa valikoimassasi osoitteessa /templates näytettäviä valikoituja malleja.

Tätä varten sinun on asetettava tiedostossa toolkit/config/variables.env ympäristömuuttujan OVERLEAF_TEMPLATES_USER_ID arvoksi sen käyttäjän ID, joka vastaa mallien hallinnasta instanssissasi, esimerkiksi:

OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959

​

Mallien julkaiseminen

Jokaiselle mallille, jonka haluat ladata:

1. Luo projekti, joka sisältää mallin lähdekoodin, ja varmista, että se kääntyy.
2. Valitse editorissa File > Manage Template.
3. Syötä näkyviin tulevaan lomakkeeseen mallin tiedot:
   • Title-kentän on oltava yksilöllinen.
   • Description-kenttä tukee Markdown-muotoilua.
   • Author-kenttä hyväksyy Markdown-muotoiset linkit.

Lähettämisen jälkeen mallin tietoja voi muokata tai mallin voi poistaa mallivalikoiman sivulla. Ylläpitäjät ja mallikäyttäjä (OVERLEAF_TEMPLATES_USER_ID) voivat hallita mitä tahansa mallia.

Tässä on esimerkki:

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

​

Mallien siirtäminen overleaf.com-palvelusta

Koska Overleaf Pro on suunniteltu toimimaan offline-tilassa, overleaf.com-valikoiman malleja ei voi integroida paikalliseen asennukseesi automaattisesti, mutta se on mahdollista tehdä manuaalisesti malli kerrallaan.

Oletusarvoisesti Overleaf Pro on määritetty käyttämään käännöksissä TeXLiven basic scheme -versiota. Tämä perusversio on kevyt ja sisältää vain hyvin rajallisen joukon LaTeX-paketteja, mikä todennäköisesti johtaa puuttuvien pakettien virheisiin, kun käyttäjäsi yrittävät käyttää overleaf.com-palvelun malleja paikallisessa instanssissasi.

Valitettavasti puuttuvia paketteja ei voi asentaa automaattisesti, mutta Server Prossa on määritettävä asetus, jonka avulla käyttäjäsi voivat kääntää projekteja laajemmalla pakettivalikoimalla ja turvallisemmin. Tämän ominaisuuden nimi on Sandbox Compiles (tunnetaan myös nimellä Sibling Containers).

Jotta ladatut mallit olisivat yhteensopivia paikallisen Server Pro -instanssisi kanssa, suosittelemme vahvasti ottamaan Sandbox Compiles -toiminnon käyttöön, sillä se tarjoaa käyttäjillesi saman TeX Live -ympäristön kuin overleaf.com. Nämä imaget sisältävät suosituimmat paketit ja fontit, ja ne on jo testattu valikoimamme malleilla.

Lisätietoja siitä, mistä TeX Live -versioista käyttäjät voivat valita projekteissaan, sekä uusien projektien oletusarvoisen TeX Live -imageversion asettamisesta löydät dokumentaatiomme osiosta Changing the TeX Live Image.

1. Siirry overleaf.com-palvelun mallivalikoimaan ja etsi haluamasi malli, esimerkiksi IEEE Photonics Journal Paper Template - Example Submission
2. Napsauta Open as Template -painiketta
3. Avaa projektivalikko ja valitse Download Source
4. Kirjaudu seuraavaksi paikallisen Server Pron käyttäjätilillesi
5. Napsauta projektien koontinäkymässä New Project -painiketta ja valitse Upload Project
6. Napsauta Select a .zip file -painiketta ja valitse ladattu mallin zip-tiedosto

Käyttäjä voi sitten käyttää juuri ladattua mallia omalla tilillään, tai mallikäyttäjänä voit julkaista sen muiden käyttäjien käyttöön.

​

Kysymykset ja vastaukset

Voinko poistaa projektin, kun olen julkaissut sitä vastaavan mallin?

Vastaus: Kyllä, mutta emme suosittele sitä. Kun julkaiset mallin, otamme projektista tilannevedoksen ja tallennamme projektin zip-tiedostona julkaisuhetkellä. Näin malli ei muutu, vaikka poistaisit mallia vastaavan projektin.

Tallennamme kuitenkin myös malliin liittyvän ProjectID:n, jonka ansiosta mallin päivittäminen myöhemmin on helppoa.

Jos poistat vastaavan projektin, et näe mallin tietosivulla “Admin: Source Project” -painiketta (katso alla oleva kuva).

Miksi mallin julkaiseminen kestää joidenkin projektien kohdalla niin kauan?

Vastaus: Kun julkaiset mallin, tallennamme projektin zip- ja pdf-tiedostona, mikä on yleensä nopeaa. Meidän on kuitenkin myös luotava PDF:stä pikkukuvat, jotta ne voidaan näyttää mallin tiedoissa.

Pikkukuvien luontiaika riippuu yleensä PDF:n ensimmäisen sivun sisällöstä. Tasapainottaaksemme näyttölaadun ja muunnosajan valitsemme leveydeksi keskitason arvon.

Jos PDF:n ensimmäinen sivu sisältää paljon tekstiä, pikkukuvien muuntaminen voi kuitenkin kestää 40 sekuntia tai jopa kauemmin, joten ole kärsivällinen. Tässä on esimerkki suuresta julisteesta, jonka käsittely kestää kauemmin.

Suuri juliste