> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/fi/maaritys/overleaf-toolkit/templates.md).

# Mallipohjat

{% hint style="info" %}
Tämän ominaisuuden on alun perin kehittänyt [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), ja sitä ovat muokanneet ja optimoineet [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/b56ff5f4627ddaa20bbf1cb70456ad24b184b349" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/e03569ead5039973966bece2b69037496fc42b62" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Määritys

Malligalleria-ominaisuutta hallitaan seuraavilla ympäristömuuttujilla:

* `OVERLEAF_TEMPLATE_GALLERY`: Aseta arvoksi `true` ottaaksesi Malligallerian käyttöön.
* `OVERLEAF_TEMPLATE_CATEGORIES`: Valinnainen välilyönneillä erotettu luettelo, jossa on nolla tai useampi mallikategorian avain. Kelvollisia avaimia ovat:

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

  Erityinen avain *`all`* lisätään automaattisesti. Tämä avain edustaa kategoriaa, joka sisältää kaikki mallit.

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

  * `TEMPLATE_<KEY>_NAME`: Mallikategorian näyttönimi.
  * `TEMPLATE_<KEY>_DESCRIPTION`: Lyhyt kuvaus kategoriasta.

  Jos kategorian avain sisältää yhdysmerkin (`-`), korvaa se alaviivalla (`_`) ympäristömuuttujien nimissä.
* `ENABLE_CONVERSIONS`: On asetettava arvoksi `true` jotta mallien pienoiskuvien ja esikatselujen luonti otetaan käyttöön.

### Julkaisemisen käyttöoikeudet

Ylläpitäjät voivat julkaista malleja. Voit myös määrittää ei-ylläpitäjäkäyttäjän hallinnoimaan kuratoituja malleja, jotka näkyvät paikallisessa galleriassasi osoitteessa `/templates`.

Tätä varten sinun täytyy asettaa ympäristömuuttuja `OVERLEAF_TEMPLATES_USER_ID` tiedostossa `toolkit/config/variables.env` arvoksi `ID` käyttäjän, joka on vastuussa mallien hallinnasta instanssissasi, esimerkiksi:

```dotenv
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```

### Mallien julkaiseminen

Kullekin mallille, jonka haluat ladata:

1. Luo projekti, joka sisältää mallin lähdekoodin, ja varmista, että se kääntyy.
2. Valitse editorin vasemmasta valikosta **Julkaise mallina**.
3. Täyttöön tulevassa lomakkeessa anna mallin tiedot:
   * Kentän *Otsikko* on oltava yksilöllinen.
   * Kentän *Kuvaus* kenttä tukee Markdown-muotoilua.
   * Kentän *Tekijä* kenttä hyväksyy Markdown-muotoiltuja linkkejä.

Lähettämisen jälkeen mallin tietoja voidaan muokata tai malli voidaan poistaa Malligalleria-sivun kautta. Käyttäjät voivat hallinnoida omia mallejaan; ylläpitäjät voivat hallinnoida mitä tahansa mallia.

Tässä on esimerkki:

{% code overflow="wrap" expandable="true" %}

```dotenv
#################
#   MALLIT   #
#################

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=Lehtiartikkelit
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Mallit akateemisiin lehtijulkaisuihin, mukaan lukien muodot suurille kustantajille ja esipainospalvelimille.

TEMPLATE_BIBLIOGRAPHY_NAME=Lähdeluettelot
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Tyyliä lähdeluetteloiden luomiseen ja hallintaan BibTeXillä tai BibLaTeXilla. Soveltuu käytettäväksi akateemisissa kirjoituksissa, opinnäytteissä ja raporteissa.

TEMPLATE_BOOK_NAME=Kirjat
TEMPLATE_BOOK_DESCRIPTION=Mallit kirjojen tai pitkien asiakirjojen kirjoittamiseen, mukaan lukien lukujen jäsentely, alkusivut ja indeksointi.

TEMPLATE_CALENDAR_NAME=Kalenterit
TEMPLATE_CALENDAR_DESCRIPTION=Mallit vuosittaisten, kuukausittaisten tai viikoittaisten kalenterien luomiseen. Hyödyllisiä henkilökohtaisiin suunnittelijoihin tai tapahtumasuunnitteluun.

TEMPLATE_CV_NAME=Ansioluettelot ja CV:t
TEMPLATE_CV_DESCRIPTION=Mallit CV:ille ja ansioluetteloille eri muodoissa akateemisiin, teollisuuden ja luovien alojen tehtäviin.

TEMPLATE_FORMAL_LETTER_NAME=Viralliset kirjeet
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Mallit ammattimaisille kirjeille, kuten saatekirjeille, suosittelukirjeille ja viralliselle kirjeenvaihdolle.

TEMPLATE_HOMEWORK_NAME=Tehtävät
TEMPLATE_HOMEWORK_DESCRIPTION=Mallit läksyihin, kurssitöihin ja tehtäväkokonaisuuksiin. Suunniteltu siisteiksi ja hyvin jäsennellyiksi opiskelijoille ja opettajille.

TEMPLATE_NEWSLETTER_NAME=Uutiskirjeet
TEMPLATE_NEWSLETTER_DESCRIPTION=Mallit uutiskirjeiden luomiseen eri muodoissa akateemiseen, yritys- tai yhteisöviestintään.

TEMPLATE_POSTER_NAME=Julisteet
TEMPLATE_POSTER_DESCRIPTION=Mallit tieteellisille ja akateemisille julisteille, joita käytetään tyypillisesti konferensseissa ja tutkimusesityksissä.

TEMPLATE_PRESENTATION_NAME=Esitykset
TEMPLATE_PRESENTATION_DESCRIPTION=Mallit Beamerille ja muille esitysmuodoille, räätälöitynä akateemisiin puheenvuoroihin ja luentoihin.

TEMPLATE_REPORT_NAME=Raportit
TEMPLATE_REPORT_DESCRIPTION=Mallit teknisiin, laboratorio- tai projektiraportteihin. Sisältää osiot kuville, taulukoille ja viitteille.

TEMPLATE_THESIS_NAME=Opinnäytteet
TEMPLATE_THESIS_DESCRIPTION=Mallit opinnäytteiden ja väitöskirjojen kirjoittamiseen laitoksen muotoilu- ja viittaussuositusten mukaisesti.

TEMPLATE_ALL_NAME=Kaikki mallit
TEMPLATE_ALL_DESCRIPTION=Selaa kokoelmaa kaikista saatavilla olevista LaTeX-malleista, luokiteltuna asiakirjatyypin, tyylin ja käyttötarkoituksen mukaan.

```

{% endcode %}

### Mallien siirtäminen overleaf.comista <a href="#transferring-templates-from-overleaf.com" id="transferring-templates-from-overleaf.com"></a>

Koska Overleaf Pro on suunniteltu toimimaan offline-tilassa, ei ole automaattista tapaa integroida [overleaf.com](https://www.overleaf.com/) galleriamallit paikallisasennukseesi, mutta se on kuitenkin mahdollista tehdä manuaalisesti mallikohtaisesti.

Oletusarvoisesti Overleaf Pro on määritetty käyttämään käännöksissä TeX Liven perusskeemaversiota. Tämä perusversio on kevyt ja sisältää vain hyvin rajoitetun joukon LaTeX-paketteja, mikä todennäköisesti johtaa käyttäjillesi puuttuvien pakettien virheisiin, kun he yrittävät käyttää malleja [overleaf.com](https://www.overleaf.com/) paikallisessa omassa instanssissasi.

Valitettavasti, vaikka puuttuvien pakettien asentamiseen ei ole automaattista tapaa, Server Prossa on määritettävä asetus, jonka avulla käyttäjäsi voivat kääntää projekteja, joilla on pääsy useampiin paketteihin, ja turvallisemmin. Tätä ominaisuutta kutsutaan [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 ovat yhteensopivia paikallisen Server Pro -instanssisi kanssa, suosittelemme vahvasti, että otat käyttöön [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) sillä tämä ominaisuus tarjoaa käyttäjillesi pääsyn samaan TeX Live -ympäristöön kuin [overleaf.com](https://www.overleaf.com/). Nämä kuvat sisältävät suosituimmat paketit ja fontit, ja ne on jo testattu galleriamallejamme vasten.

Löydät lisätietoja siitä, miten käyttäjät voivat valita projektissaan käytettävissä olevat TeX Live -versiot sekä asettaa uusien projektien oletusarvoisen TeX Live -kuvaversion dokumentaatiomme [TeX Live -kuvan vaihtaminen](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) osiossa.

1. Siirry kohtaan [Malligalleria](https://www.overleaf.com/latex/templates) sivulla [overleaf.com](https://www.overleaf.com/) ja etsi tarvittava 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 **Avaa mallina** painiketta
3. Napsauta projektivalikkoa ja valitse **Lataa lähdekoodi**
4. Seuraavaksi kirjaudu paikallisen Server Pro -tilin
5. Napsauta **Uusi projekti** painiketta projektien hallintapaneelissa ja valitse **Lataa projekti**
6. Napsauta **Valitse .zip-tiedosto** painike ja valitse ladattu mallin zip-tiedosto

Tämän jälkeen käyttäjä voi käyttää tätä juuri ladattua mallia omalla tilillään, tai templates-käyttäjänä voit julkaista sen muiden käyttäjien käytettäväksi.

### Kysymykset ja vastaukset

<details>

<summary>Voinko poistaa projektin vastaavan mallin julkaisemisen jälkeen?</summary>

**Vastaus:** Kyllä, mutta emme suosittele sitä. Kun julkaiset mallin, otamme projektista tilannekuvan ja tallennamme projektin zip-tiedostona julkaisuhetkellä. Tämä varmistaa, että vaikka poistaisitkin mallia vastaavan projektin, malli ei vaikutu.

Tallennamme kuitenkin myös tähän malliin liittyvän ProjectID:n, mikä helpottaa mallin päivittämistä tulevaisuudessa.

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

<figure><img src="/files/60d2a62bd607e65599eb4a4cec176da5bb289505" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Miksi joidenkin projektien kohdalla mallin julkaiseminen kestää niin kauan?</summary>

**Vastaus:** Kun julkaiset mallin, tallennamme projektin zip- ja pdf-tiedostoksi, mikä on yleensä nopeaa. Meidän täytyy kuitenkin myös luoda PDF:stä pienoiskuvat, jotta ne voidaan näyttää mallin tiedoissa.

Pienoiskuvien luontiaika riippuu yleensä PDF:n ensimmäisen sivun sisällöstä. Näytön laadun ja muunnosajan tasapainottamiseksi valitsemme leveydeksi keskimmäisen arvon.

Jos PDF:n ensimmäinen sivu kuitenkin sisältää paljon tekstiä, pienoiskuvien muuntaminen voi kestää 40 sekuntia tai jopa enemmän, olethan kärsivällinen. Tässä on esimerkki suuresta julisteesta, se kestää pidempään.

<figure><img src="/files/7182f4b2235618ead4706a159d99400ce78bece7" alt="" width="188"><figcaption><p>Suuri juliste</p></figcaption></figure>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/fi/maaritys/overleaf-toolkit/templates.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
