> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mallipohjat

<Info>
  Tämän ominaisuuden kehitti alun perin [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), ja sitä on muokannut ja optimoinut [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
</Info>

<Info>
  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ö](/fi/on-premises/configuration/overleaf-toolkit/public-access#page-access "mention"). Projektin luominen mallista edellyttää aina kirjautumista.
</Info>

<Columns cols={2}>
  <Column>
    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-31.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=5a12bd99f99c99910e7eae3d1b5f010c" alt="" width="3078" height="2405" data-path="images/on-premises/image-31.png" />
    </Frame>
  </Column>

  <Column>
    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-32.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=c71bb498c75535f0d2569d55625b31bc" alt="" width="3078" height="2405" data-path="images/on-premises/image-32.png" />
    </Frame>
  </Column>
</Columns>

### Määritys

Versiosta 6.3.0 alkaen valikoima suorittaa sivutuksen, haun ja lajittelun palvelimella. Siirtoa ei tarvita. Suurille valikoimille katso julkaisutiedoista [valinnaiset MongoDB-indeksit](/fi/on-premises/release-notes/release-notes-6.x.x#feature-04-template-pagination "mention").

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:

```dotenv theme={null}
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:

```dotenv wrap expandable theme={null}
#################
#   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](https://www.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](https://www.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](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (tunnetaan myös nimellä Sibling Containers).

Jotta ladatut mallit olisivat yhteensopivia paikallisen Server Pro -instanssisi kanssa, suosittelemme vahvasti ottamaan [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) -toiminnon käyttöön, sillä se tarjoaa käyttäjillesi saman TeX Live -ympäristön kuin [overleaf.com](https://www.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](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image).

1. Siirry [overleaf.com](https://www.overleaf.com/)-palvelun [mallivalikoimaan](https://www.overleaf.com/latex/templates) ja etsi haluamasi malli, esimerkiksi [IEEE Photonics Journal Paper Template - Example Submission](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
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

<Accordion title="Voinko poistaa projektin, kun olen julkaissut sitä vastaavan mallin?">
  <strong>Vastaus:</strong> 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).

  <Frame>
    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-30.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=2bc8ec10c24599e1a6d0b247aef23cc9" alt="" width="2720" height="1824" data-path="images/on-premises/image-30.png" />
  </Frame>
</Accordion>

<Accordion title="Miksi mallin julkaiseminen kestää joidenkin projektien kohdalla niin kauan?">
  <strong>Vastaus:</strong> 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.

  <Frame caption="Suuri juliste">
    <img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/on-premises/preview.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=8fd572d5ef8b86ea6c62e16a6db8ec10" alt="" width="188" data-path="images/on-premises/preview.png" />
  </Frame>
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.