Voor grootschalige contentupdates kun je de publieke kennisbank in een keer exporteren en importeren als JSON. Dit is vooral handig bij herstructurering, bulkredactie of migratie tussen omgevingen.
Locatie in admin
Al het contentbeheer gebeurt op /admin/content: artikelen, hoofdstukken en de documentenbibliotheek zitten in hetzelfde scherm. Voor het JSON-archief open je de tab Import/export en gebruik je:
- Download JSON voor export van het volledige kennisbank-archief (hoofdstukken + artikelen).
- Upload JSON voor import van een bewerkt archief.
JSON basisvorm (schema v2)
{
"schemaVersion": 2,
"exportedAt": "2026-06-11T12:00:00.000Z",
"chapters": [
{ "slug": "introductie", "title": "Introductie", "order": 0 }
],
"articles": [
{
"slug": "1-introductie/voorbeeld",
"title": "Voorbeeldartikel",
"summary": "Korte toelichting",
"tags": ["voorbeeld"],
"format": "article",
"order": 0,
"chapterSlug": "introductie",
"publishedAt": "2026-06-11T12:00:00.000Z",
"hero": null,
"imageUrl": null,
"content": "Markdown inhoud"
}
]
}
Belangrijke importregels
- Import synchroniseert uitsluitend de publieke kennisbank: nieuws-, interne en handleiding-artikelen blijven altijd ongemoeid.
- Kennisbank-artikelen die niet in de JSON staan worden verwijderd; hoofdstukken worden nooit verwijderd.
- Slugs moeten uniek zijn; bevat de JSON een slug die al bestaat met een andere plaatsing, dan wordt de volledige import geweigerd (er wordt dan niets gewijzigd).
- De hoofdstuk-koppeling loopt via
chapterSlug(niet via het pad in de artikel-slug). - Content moet geldige markdown zijn; gebruik geen dubbele titelkop als de titel al in metadata staat.
Backups van vóór de herindeling
Exports/backups van vóór 11 juni 2026 bevatten nog de twee artikelen die bij de hoofdstuk-herindeling intern zijn geworden (3-platform/bestandsoverdrachtproces-via-csv en 7-techniek/webapp-checklist). Verwijder die twee artikelen eerst uit de JSON, anders wordt de volledige import geweigerd vanwege het plaatsingsconflict.