Om goed te begrijpen hoe je bulk-updates kan doen met deze functie, moet je eerst begrijpen hoe het ZIP-bestand is opgebouwd.
Hoe is de ZIP opgebouwd?
De ZIP weerspiegelt de mappenstructuur van je content tree. Elke map en elk bestand heeft een naam die bestaat uit een leesbare slug én een uniek id:
- Mapnamen:
leesbare-naam--{folder-id} - Artikelbestanden:
leesbare-naam--{artikel-id}.md - Snippetbestanden:
leesbare-naam--{snippet-id}.md
Die id's zijn cruciaal voor de roundtrip: bij een re-import herkent Sarrai bestaande content op basis van die id's, niet op basis van bestandsnaam of locatie. Zo kan je bestanden hernoemen of verplaatsen zonder duplicaten te creëren.
Front matter per bestand
Elk Markdown-bestand bevat bovenaan een YAML-blok met metadata:
---
articleId: abc123
nodeType: article
languageCode: nl
title: Titel van het artikel
intro: Korte inleiding
slug: titel-van-het-artikel
isSnippet: false
isAvailableForAiAgent: true
reviewDueAt: 2026-01-01
---
De body van het artikel volgt na dit blok als gewone Markdown. Je kan de body vrij bewerken. Pas de front matter alleen aan als je dat bewust wil — de articleId en nodeType zijn nodig voor een correcte roundtrip en mag je niet verwijderen.
Interne links
Links tussen artikels die allebei in dezelfde export zitten, worden automatisch omgezet naar relatieve Markdown-links. Zo blijven ze leesbaar en bewerkbaar in een teksteditor.
Links naar content buiten de geëxporteerde scope blijven ongewijzigd en leveren bij de export een waarschuwing op.
Beperkingen van de export
- Alleen gepubliceerde content wordt geëxporteerd — drafts worden niet meegenomen
- De export is per taal : artikels zonder inhoud in de gekozen taal worden overgeslagen
- Afbeeldingen en andere bestanden worden niet mee verpakt — bestaande afbeeldings-URL's blijven wel gewoon in de Markdown staan
- Mappen zonder kinderen (lege mappen) worden weggelaten, behalve de expliciet gekozen rootmap bij een subtree-export
- Structurele mappen blijven aanwezig als ze nodig zijn voor de hiërarchie, ook als hun eigen vertaling ontbreekt
Bulkbewerking: eerst exporteren en daarna opnieuw importeren
De export en de import-tool zijn op elkaar afgestemd voor een efficiënte roundtrip:
- Exporteer je content tree of een submap via Instellingen → Exports
- Download de ZIP via Instellingen → Downloads
- Pak de ZIP uit op je computer
- Bewerk artikels lokaal in een teksteditor — pas de Markdown-body aan, wijzig titels in de front matter, herorden bestanden in mappen
- Zip de bestanden opnieuw
- Importeer de ZIP via de import-tool
Bij de re-import herkent Sarrai bestaande mappen, artikels en snippets op hun id (in bestandsnaam én front matter). Ze worden bijgewerkt als een nieuwe versie, zonder duplicaten aan te maken.