> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/fi/konfiguraatio/overleaf-toolkit/templates.md).

# Mallipohjat

{% hint style="info" %}
Tämän ominaisuuden kehitti alun perin [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), ja sitä muokkasivat ja optimoivat [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 %}

### Asetukset

Template Gallery -ominaisuutta ohjataan seuraavilla ympäristömuuttujilla:

* `OVERLEAF_TEMPLATE_GALLERY`: Aseta arvoksi `true` ottaaksesi Template Galleryn käyttöön.
* `OVERLEAF_TEMPLATE_CATEGORIES`: Valinnainen välilyönneillä eroteltu lista, jossa on nollasta useampaan mallikategorian avainta. Kelvollisia avaimia ovat:

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

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

  Kullekin kategoriavaimelle voidaan asettaa seuraavat valinnaiset ympäristömuuttujat:

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

  Jos kategoriavain sisältää yhdysmerkin (`-`), korvaa se alaviivalla (`_`) ympäristömuuttujien nimissä.
* `ENABLE_CONVERSIONS`: Täytyy olla arvona `true` ottaaksesi mallien pikkukuvien ja esikatseluiden luonnin käyttöön.

### Julkaisuoikeudet

Ylläpitäjät voivat julkaista malleja. Voit myös nimetä ei-ylläpitäjän hallinnoimaan valikoituja 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` sen käyttäjän, joka vastaa mallien hallinnasta tässä 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 syötä mallin tiedot:
   * Se *Otsikko* täytyy olla yksilöllinen.
   * Se *Kuvaus* kenttä tukee Markdown-muotoilua.
   * Se *Tekijä* kenttä hyväksyy Markdown-muotoillut linkit.

Lähetyksen jälkeen mallin tietoja voi muokata tai mallin voi poistaa Template Gallery -sivun kautta. Käyttäjät voivat hallita omia mallejaan; ylläpitäjät voivat hallita 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=Aikakauslehtiartikkelit
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Mallit akateemisiin aikakauslehtijulkaisuihin, mukaan lukien suurten kustantajien ja esijulkaisupalvelimien formaatit.

TEMPLATE_BIBLIOGRAPHY_NAME=Lähdeluettelot
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Tyylit lähdeluetteloiden luomiseen ja hallintaan BibTeX:n tai BibLaTeX:n avulla. Soveltuu käytettäväksi akateemisissa artikkeleissa, opinnäytteissä ja raporteissa.

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

TEMPLATE_CALENDAR_NAME=Kalenterit
TEMPLATE_CALENDAR_DESCRIPTION=Mallit vuosittaisten, kuukausittaisten tai viikoittaisten kalentereiden luomiseen. Hyödyllisiä henkilökohtaisiin suunnittelijoihin tai tapahtumien aikataulutukseen.

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

TEMPLATE_FORMAL_LETTER_NAME=Muodolliset kirjeet
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Mallit ammatillisiin kirjeisiin, kuten hakemuskirjeisiin, suosituskirjeisiin ja viralliseen kirjeenvaihtoon.

TEMPLATE_HOMEWORK_NAME=Tehtävät
TEMPLATE_HOMEWORK_DESCRIPTION=Mallit kotitehtäviin, kurssitöihin ja tehtäväkokonaisuuksiin. Suunniteltu selkeiksi 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 tieteellisiin ja akateemisiin julisteisiin, joita käytetään yleensä konferensseissa ja tutkimusesityksissä.

TEMPLATE_PRESENTATION_NAME=Esitykset
TEMPLATE_PRESENTATION_DESCRIPTION=Mallit Beamerille ja muille esitysmuodoille, räätälöitynä akateemisiin puheisiin 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, instituution muotoilu- ja viittaussuositusten mukaisesti.

TEMPLATE_ALL_NAME=Kaikki mallit
TEMPLATE_ALL_DESCRIPTION=Selaa kokoelmaa kaikista saatavilla olevista LaTeX-malleista, jotka on luokiteltu asiakirjatyypin, tyylin ja 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/) galleriamalleja omaan paikalliseen asennukseesi, mutta se on kuitenkin mahdollista tehdä manuaalisesti mallikohtaisesti.

Oletusarvoisesti Overleaf Pro on määritetty käyttämään kääntämisissä TeX Liven perusskeemaversiota. Tämä perusversio on kevyt ja sisältää vain hyvin rajallisen osajoukon LaTeX-paketteja, mikä todennäköisesti aiheuttaa käyttäjillesi puuttuvien pakettien virheitä, kun he yrittävät käyttää malleja lähteestä [overleaf.com](https://www.overleaf.com/) paikallisessa on-premise-instanssissasi.

Valitettavasti vaikka puuttuvien pakettien asentamiseen ei ole automaattista tapaa, Server Prossa on konfiguroitava asetus, jonka avulla käyttäjäsi voivat kääntää projekteja käyttäen useampia paketteja 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).

Varmistaaksesi, että 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 antaa 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.

Lisätietoja siitä, miten määritetään, mistä TeX Live -versioista käyttäjät voivat valita omassa projektissaan, sekä uuden projektin oletusarvoisen TeX Live -kuvaversion asettamisesta löydät [TeX Live -kuvan vaihtaminen](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) dokumentaatiomme osiosta.

1. Siirry [Template Gallery](https://www.overleaf.com/latex/templates) kohteessa [overleaf.com](https://www.overleaf.com/) ja etsi tarvittava malli, esimerkiksi [IEEE Photonics Journal -artikkelipohja - esimerkkilähetys](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 paikalliseen Server Pro -tiliin
5. Napsauta **Uusi projekti** painiketta projektien hallintapaneelissa ja valitse **Lataa projekti**
6. Napsauta **Valitse .zip-tiedosto** painiketta ja valitse ladattu mallin zip-tiedosto

Käyttäjä voi sitten käyttää tätä juuri ladattua mallia omalla tilillään, tai mallikä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 tilannevedoksen ja tallennamme projektin zip-tiedostona julkaisuhetkellä. Tämä varmistaa, että vaikka poistaisit mallia vastaavan projektin, malli ei siitä kärsi.

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-tiedostona, mikä on yleensä nopeaa. Meidän on kuitenkin myös luotava PDF:lle pikkukuvat, jotta ne voidaan näyttää mallin tiedoissa.

Pikkukuvien luontiaika riippuu yleensä PDF:n ensimmäisen sivun sisällöstä. Näyttölaadun ja muunnosajan välillä tasapainottamiseksi valitsemme leveydeksi keskikokoisen arvon.

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

<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://ayakaleaf-pro.ayaka.space/on-premises/fi/konfiguraatio/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.
