> ## 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 kullanıcı yardımı ekleme

> Kubernetes dağıtımında bir MediaWiki sitesindeki LaTeX yardım sayfalarını /learn altında sunun.

`/learn` sayfaları, her Ayakaleaf Pro pod'unun **web** hizmeti (`learn` modülü) tarafından, `WIKI_URL` ile ayarlanan wiki'nin önbelleğinden sunulur. Modülün ne yaptığı ve hangi wiki'lerin çalıştığı [LaTeX kullanıcı yardımı ekleme](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/adding-latex-user-help.md) sayfasında açıklanmıştır.

| | |
| - | - |
| Hizmet | web (`learn` modülü), her Ayakaleaf Pro pod'unda |
| Pod → dış dünya | `WIKI_URL` (varsayılan `https://learnwiki.overleaf.com`): ilk başlatmada tüm sayfalar, ardından bir kullanıcı `WIKI_MAX_CACHE_AGE` süresinden sonra açtığında ilgili sayfa yeniden |
| Tarayıcı → dış dünya | sayfaların görselleri, doğrudan `WIKI_URL` adresinden |
| Depolanan veriler | veri biriminde `/var/lib/overleaf/data/learnPages` içindeki sayfa önbelleği |
| Periyodik işler | yok: sayfalar kullanıcılar açtığında yenilenir |

### Yapılandırma

```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]
>
> Modül açıkken ilk başlatmada web hizmeti, istekleri kabul etmeden önce tüm wiki'yi indirir; bu işlem birkaç dakika sürer. Pod o zamana kadar hazır olmaz; bu nedenle bunu `rollout status --timeout` değerinde ve eklediğiniz başlangıç (startup) veya canlılık (liveness) yoklamalarında hesaba katın. Sonraki başlatmalar veri birimindeki önbelleği yeniden kullanır.

İlk başlatmada, henüz bir önbellek yokken, pod'ların `WIKI_URL` adresine erişebilmesi gerekir: erişemezlerse web hizmeti başlarken başarısız olur ve pod içinde tekrar tekrar yeniden başlatılır; böylece pod hiçbir zaman hazır olmaz. Modülü kapatın veya pod'ların wiki'ye çıkışına izin verin. Önbellek oluştuktan sonra pod'lar başlar ve wiki'ye erişilemediği sırada da önbellekteki sayfaları sunar.

### Birden fazla replika

Her replika kendi önbelleğini kendi düğümünün diskinde tutar; bu nedenle her biri ilk başlatmasında wiki'yi indirir. `podManagementPolicy: OrderedReady` ile bunu birbiri ardına yaparlar. Bir kullanıcı, sayfa orada yenilenene kadar başka bir replikada sayfanın biraz farklı bir sürümünü görebilir.

### Kubernetes üzerinde test edildi

HAProxy arkasında üç replikalı Kubernetes 1.37 üzerinde, her biri ilk başlatmasında `https://learnwiki.overleaf.com` adresini kendi düğümünün önbelleğine indirirken, `/learn` için uçtan uca testlerimiz başarılı oldu (12 vaka): başlıktaki Documentation bağlantısı, karşılama mesajı ve düzenleyicinin Help menüsü, içindekiler kenar çubuğu, wiki içindeki sayfalar, bağlantılar ve yönlendirmeler, wiki'den yüklenen görseller, bilinmeyen sayfalar için 404, herkese açık erişim olmadan gereken oturum açma ve `WIKI_URL` erişilemeyen bir adrese değiştirildikten sonra önbellekten sunulan eski bir sayfa. Boş bir önbellekle ve bağlantıları reddeden bir adrese işaret eden `WIKI_URL` ile başlatıldığında pod yeniden başlamadan hazır olmayan durumda kaldı; içindeki web hizmeti ise üç dakikada 77 kez başlayıp başarısız oldu.


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