> ## 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-gebruikershulp toevoegen

> Bied LaTeX-hulppagina's van een MediaWiki-site aan onder /learn op een Kubernetes-implementatie.

De `/learn`-pagina's worden aangeboden door de **web**-service (de module `learn`) van elke Ayakaleaf Pro-pod, vanuit een cache van de wiki die in `WIKI_URL` is ingesteld. Wat de module doet en welke wiki's werken, staat beschreven in [LaTeX-gebruikershulp toevoegen](https://ayakaleaf-pro.mintlify.site/nl/on-premises/configuration/overleaf-toolkit/adding-latex-user-help.md).

| | |
| - | - |
| Service | web (module `learn`), in elke Ayakaleaf Pro-pod |
| Pod → buiten | `WIKI_URL` (standaard `https://learnwiki.overleaf.com`): elke pagina bij de eerste start, daarna een pagina opnieuw wanneer een gebruiker die opent na `WIKI_MAX_CACHE_AGE` |
| Browser → buiten | afbeeldingen van de pagina's, rechtstreeks van `WIKI_URL` |
| Opgeslagen gegevens | de paginacache in `/var/lib/overleaf/data/learnPages` op het datavolume |
| Periodieke taken | geen: pagina's worden vernieuwd wanneer gebruikers ze openen |

### Configuratie

```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]
>
> Bij de eerste start met de module ingeschakeld downloadt de web-service de hele wiki voordat deze verzoeken accepteert, wat enkele minuten duurt. De pod blijft tot die tijd niet gereed, dus houd daar rekening mee in `rollout status --timeout` en in elke startup- of liveness-probe die je toevoegt. Latere starts hergebruiken de cache op het datavolume.

Bij de eerste start, voordat er een cache bestaat, moeten de pods `WIKI_URL` kunnen bereiken: zonder die verbinding faalt de web-service tijdens het starten en wordt deze binnen de pod steeds opnieuw herstart, zodat de pod nooit gereed wordt. Schakel de module uit, of sta de pods toe de wiki te bereiken. Zodra de cache bestaat, starten de pods en bieden ze de gecachte pagina's aan, ook als de wiki niet bereikbaar is.

### Meerdere replica's

Elke replica houdt een eigen cache bij op de schijf van zijn node, dus elke replica downloadt de wiki bij zijn eerste start; met `podManagementPolicy: OrderedReady` doen ze dat na elkaar. Een gebruiker kan op een andere replica een pagina in een iets andere versie zien totdat die daar is vernieuwd.

### Getest op Kubernetes

Op Kubernetes 1.37 met drie replica's achter HAProxy, die elk bij hun eerste start `https://learnwiki.overleaf.com` downloaden naar de cache van hun eigen node, slagen onze end-to-endtests voor `/learn` (12 gevallen): de Documentation-link in de header, het welkomstbericht en het Help-menu van de editor, de inhoudszijbalk, pagina's, links en omleidingen binnen de wiki, afbeeldingen die van de wiki worden geladen, 404 voor onbekende pagina's, de vereiste login zonder openbare toegang, en een verouderde pagina die uit de cache wordt aangeboden nadat `WIKI_URL` is gewijzigd naar een adres dat niet bereikbaar is. Bij een start met een lege cache en `WIKI_URL` verwijzend naar een adres dat verbindingen weigert, bleef de pod niet gereed zonder te herstarten, terwijl de web-service daarin in drie minuten 77 keer startte en faalde.


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