> ## 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-tuonti ja -vienti

> Tuo ja vie dokumentteja Pandocilla Kubernetes-käyttöönotossa.

Pandoc-muunnokset suorittaa jokaisen Ayakaleaf Pro -podin **clsi**-palvelu, kuten käännökset: clsi pyytää solmun Docker Engineä käynnistämään kontin `PANDOC_IMAGE`-imagesta. **web**-palvelu näyttää tuonti- ja vientivalikot. Ominaisuuden toiminta ja imagen rakentaminen on kuvattu sivulla [Pandoc-tuonti ja -vienti](https://ayakaleaf-pro.mintlify.site/fi/on-premises/configuration/overleaf-toolkit/pandoc-import-and-export.md).

| | |
| - | - |
| Palvelut | web (valikot ja reitit), clsi (suorittaa muunnoksen), jokaisessa Ayakaleaf Pro -podissa |
| Solmu | Docker Engine ja `PANDOC_IMAGE` jokaisella solmulla, joka voi ajaa Ayakaleaf Prota |
| Edellyttää | [Hiekkalaatikkokäännökset](https://ayakaleaf-pro.mintlify.site/fi/on-premises/configuration/kubernetes/sandboxed-compiles.md) |
| Ajastetut tehtävät | ei mitään |

### Konfigurointi

**1. Vie image Dockeriin jokaisella solmulla**

Rakenna image kerran [ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro)-repositorion `develop/pandoc`-kansiosta ja lataa se sitten Dockeriin jokaisella solmulla, joka voi ajaa Ayakaleaf Prota:

```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
```

Tai pushaa se rekisteriin, jonka solmut tavoittavat, ja hae se jokaisella solmulla komennolla `sudo docker pull`. Kuten TeX Live -imageiden kohdalla, sen on oltava **Dockerissa**, ei pelkästään containerd:ssä.

**2. ConfigMap**

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

Sekä web että clsi lukevat `ENABLE_PANDOC_CONVERSIONS`-asetuksen samasta ConfigMapista, joten ne eivät voi olla Kubernetesissa eri mieltä.

**3. Ota käyttöön ja käynnistä uudelleen**

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

### Useita replikoita

Mitään ylimääräistä ei tarvita sen lisäksi, että image on jokaisella solmulla: jokainen replika tekee muunnokset omalla solmullaan.

### Testattu Kubernetesissa

Kun image oli rakennettu `develop/pandoc`-kansiosta ja ladattu Dockeriin jokaisella solmulla komennolla `docker save | docker load`, Kubernetes 1.37:ssä yhdellä replikalla Pandocin päästä päähän -testimme menevät läpi (6 tapausta): Markdown-dokumentin tuonti LaTeX-projektiksi, rikkinäisestä Word-dokumentista näytettävä virhe, vienti Wordiin (joka voidaan tuoda uudelleen), Markdowniin ja HTML:ään sekä valikoiden piilottaminen ilman `ENABLE_PANDOC_CONVERSIONS`-asetusta.


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