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

# LaTeX-käyttäjäohjeiden lisääminen

> Tarjoa LaTeX-ohjesivuja MediaWiki-sivustosta polussa /learn Kubernetes-käyttöönotossa.

`/learn`-sivut tarjoaa jokaisen Ayakaleaf Pro -podin **web**-palvelu (`learn`-moduuli) välimuistista, joka on ladattu muuttujassa `WIKI_URL` asetetusta wikistä. Moduulin toiminta ja se, mitkä wikit toimivat, on kuvattu sivulla [LaTeX-käyttäjäohjeiden lisääminen](https://ayakaleaf-pro.mintlify.site/fi/on-premises/configuration/overleaf-toolkit/adding-latex-user-help.md).

| | |
| - | - |
| Palvelu | web (`learn`-moduuli), jokaisessa Ayakaleaf Pro -podissa |
| Pod → ulkoverkko | `WIKI_URL` (oletus `https://learnwiki.overleaf.com`): jokainen sivu ensimmäisellä käynnistyskerralla, sen jälkeen sivu uudelleen, kun käyttäjä avaa sen ajan `WIKI_MAX_CACHE_AGE` kuluttua |
| Selain → ulkoverkko | sivujen kuvat suoraan osoitteesta `WIKI_URL` |
| Tallennetut tiedot | sivuvälimuisti hakemistossa `/var/lib/overleaf/data/learnPages` datataltiolla |
| Ajastetut tehtävät | ei mitään: sivut päivitetään, kun käyttäjät avaavat ne |

### Konfiguraatio

```yaml title="30-config.yaml (additions)" theme={null}
  OVERLEAF_PROXY_LEARN: "true"
  # optional: your own MediaWiki
  # WIKI_URL: https://wiki.example.com
```

```bash theme={null}
kubectl apply -f 30-config.yaml
kubectl -n overleaf rollout restart deployment/overleaf     # or statefulset/overleaf
kubectl -n overleaf rollout status deployment/overleaf --timeout=30m
```

> [!WARNING]
>
> Kun moduuli on käytössä, web-palvelu lataa ensimmäisellä käynnistyskerrallaan koko wikin ennen kuin se ottaa vastaan pyyntöjä, mikä kestää useita minuutteja. Pod pysyy siihen asti ei-valmiina, joten varaa tälle aikaa `rollout status --timeout` -asetuksessa ja kaikissa lisäämissäsi käynnistys- tai liveness-tarkistuksissa. Myöhemmät käynnistykset käyttävät datataltiolla olevaa välimuistia.

Ensimmäisellä käynnistyskerralla, ennen kuin välimuistia on olemassa, podien on tavoitettava `WIKI_URL`: muuten web-palvelu epäonnistuu käynnistyessään ja käynnistetään podin sisällä uudelleen yhä uudelleen, joten pod ei koskaan tule valmiiksi. Poista moduuli käytöstä tai salli podien yhteys wikiin. Kun välimuisti on olemassa, podit käynnistyvät ja tarjoavat välimuistissa olevia sivuja myös silloin, kun wikiä ei tavoiteta.

### Useita replikoita

Jokainen replika pitää omaa välimuistiaan oman solmunsa levyllä, joten jokainen lataa wikin ensimmäisellä käynnistyskerrallaan; asetuksella `podManagementPolicy: OrderedReady` ne tekevät sen yksi kerrallaan. Käyttäjä saattaa nähdä sivusta hieman eri version toisella replikalla, kunnes sivu päivitetään siellä.

### Testattu Kubernetesissa

Kubernetes 1.37:ssä kolmella replikalla HAProxyn takana, joista kukin latasi osoitteen `https://learnwiki.overleaf.com` oman solmunsa välimuistiin ensimmäisellä käynnistyskerrallaan, `/learn`-polun päästä päähän -testimme menevät läpi (12 tapausta): ylätunnisteen Documentation-linkki, tervetuloviesti ja editorin Help-valikko, sisällysluettelon sivupalkki, wikin sisäiset sivut, linkit ja uudelleenohjaukset, wikistä ladatut kuvat, 404 tuntemattomille sivuille, vaadittu kirjautuminen ilman julkista pääsyä sekä välimuistista tarjottu vanhentunut sivu sen jälkeen, kun `WIKI_URL` oli vaihdettu osoitteeseen, jota ei tavoiteta. Kun käynnistettiin tyhjällä välimuistilla ja `WIKI_URL` osoitti osoitteeseen, joka hylkää yhteydet, pod pysyi ei-valmiina käynnistymättä uudelleen, kun taas sen sisällä oleva web-palvelu käynnistyi ja epäonnistui 77 kertaa kolmessa minuutissa.


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