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

# Pandoc ile İçe ve Dışa Aktarma

> Kubernetes dağıtımında belgeleri Pandoc ile içe ve dışa aktarın.

Pandoc dönüştürmeleri, derlemeler gibi her Ayakaleaf Pro pod'unun **clsi** hizmeti tarafından çalıştırılır: clsi, düğümün Docker Engine'inden `PANDOC_IMAGE` imajından bir konteyner başlatmasını ister. **web** hizmeti içe ve dışa aktarma menülerini gösterir. Özelliğin ne yaptığı ve imajın nasıl oluşturulacağı [Pandoc ile İçe ve Dışa Aktarma](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/pandoc-import-and-export.md) sayfasında açıklanmıştır.

| | |
| - | - |
| Hizmetler | web (menüler ve rotalar), clsi (dönüştürmeyi çalıştırır), her Ayakaleaf Pro pod'unda |
| Düğüm | Ayakaleaf Pro çalıştırabilen her düğümde Docker Engine ve `PANDOC_IMAGE` |
| Gereksinim | [Sandbox Derlemeleri](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/kubernetes/sandboxed-compiles.md) |
| Periyodik işler | yok |

### Yapılandırma

**1. İmajı her düğümde Docker'a yükleyin**

İmajı [ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) deposunun `develop/pandoc` klasöründen bir kez oluşturun, ardından Ayakaleaf Pro çalıştırabilen her düğümde Docker'a yükleyin:

```bash theme={null}
docker build -t overleaf-pandoc:local develop/pandoc
docker save overleaf-pandoc:local | ssh node-1 sudo docker load    # repeat for every node
```

Ya da düğümlerin erişebildiği bir kayıt defterine gönderin ve her düğümde `sudo docker pull` ile çekin. TeX Live imajlarında olduğu gibi, imaj yalnızca containerd'de değil **Docker**'da bulunmalıdır.

**2. ConfigMap**

```yaml theme={null}
  ENABLE_PANDOC_CONVERSIONS: "true"
  PANDOC_IMAGE: overleaf-pandoc:local
```

Hem web hem clsi `ENABLE_PANDOC_CONVERSIONS` değerini aynı ConfigMap'ten okur; bu nedenle Kubernetes'te farklı değerlere sahip olamazlar.

**3. Uygulayın ve yeniden başlatın**

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

### Birden fazla replika

İmajın her düğümde bulunması dışında ek bir şey gerekmez: her replika kendi düğümünde dönüştürme yapar.

### Kubernetes üzerinde test edildi

`develop/pandoc` klasöründen oluşturulan ve `docker save | docker load` ile her düğümde Docker'a yüklenen imajla, tek replikalı Kubernetes 1.37 üzerinde, Pandoc için uçtan uca testlerimiz başarılı oldu (6 vaka): bir Markdown belgesini LaTeX projesi olarak içe aktarma, bozuk bir Word belgesi için gösterilen hata, Word (yeniden içe aktarılabilen), Markdown ve HTML olarak dışa aktarma ve `ENABLE_PANDOC_CONVERSIONS` olmadan menülerin gizlenmesi.


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