itworx-knowledge-hub-Public/docs/guides/pagina-s-schrijven-en-beheren.md

# Pagina's schrijven, bewerken en beheren

Deze gids beschrijft de M2-functionaliteit: de kennisboom, pagina's aanmaken en
bewerken, sjablonen, interne links, concepten (autosave) en de prullenbak. Geschreven
voor redacteuren en beheerders die dagelijks inhoud beheren.

## De kennisboom

- De kennisboom staat links in de zijbalk en toont eerst alleen de hoofdpagina's.
  Onderliggende pagina's worden pas opgehaald wanneer u een tak openklapt — ook een
  boom met tienduizenden pagina's blijft zo direct bruikbaar.
- Klik op een pagina om ze te openen. Klik op het driehoekje om een tak met
  subpagina's open of dicht te klappen.
- Op een smal (mobiel) scherm is de zijbalk standaard verborgen. Gebruik de
  knop "Navigatie" bovenaan om de kennisboom en de knop "Nieuwe pagina" te openen; ze
  sluit automatisch zodra u een pagina kiest, zodat er op mobiel altijd maar één
  hoofdvenster tegelijk zichtbaar is.

## Een pagina aanmaken

1. Klik op **Nieuwe pagina** (zijbalk, of via **Subpagina maken** op een bestaande
   pagina om er meteen een onderliggende pagina van te maken).
2. Vul een titel in.
3. Kies optioneel een **sjabloon**: Studienotitie, Runbook, Architectuurbeslissing
   (ADR) of Probleemoplossing. Een sjabloon vult de inhoud met een bruikbare
   startstructuur; u kunt die nadien vrij aanpassen. Kiest u geen sjabloon, dan schrijft
   u vrije Markdown-inhoud.
4. Klik op **Pagina publiceren**.

Een nieuwe pagina is direct zichtbaar voor iedereen met leesrechten op die plaats in de
boom.

> **V2-R1-update (2026-08-03):** voegt u vóór de eerste publicatie een bijlage toe aan
> een nieuwe pagina (via de werkbalk of door een bestand in de editor te slepen), dan
> gebeurt dat nu volledig veilig: het bestand wordt meteen definitief opgeslagen en op
> de cursorpositie ingevoegd, en pas bij **Publiceren** wordt de pagina in één stap
> zichtbaar — inclusief alle al toegevoegde bijlagen. Mislukt een upload, dan blijft de
> pagina onzichtbaar en kunt u het gewoon opnieuw proberen; eerder gelukte bijlagen
> gaan niet verloren. Er bestaat dus geen tussentoestand meer met een zichtbare pagina
> en een kapotte bijlagelink. Zie `docs/adr/ADR-025-v2-r1-data-integrity-remediation.md`.

## Een pagina bewerken

1. Open de pagina en klik op **Bewerken**.
2. Pas titel, inhoud, documenttype of status aan.
3. Klik op **Wijzigingen publiceren**.

Elke publicatie verhoogt de revisie van de pagina. De vorige inhoud blijft bewaard —
volledige revisiegeschiedenis met terugzetten volgt in M3.

### Versieconflicten

Als iemand anders de pagina publiceerde terwijl u aan het bewerken was, toont de
toepassing dat expliciet in plaats van de wijziging van de ander stilzwijgend te
overschrijven: u kiest dan tussen **Gebruik gepubliceerde versie** (uw bewerkvenster
wordt bijgewerkt met de nieuwste inhoud) of **Behoud mijn versie (overschrijven)** (uw
tekst wordt alsnog gepubliceerd, bovenop de nieuwste revisie). Niets gaat verloren: uw
getypte tekst blijft zichtbaar totdat u zelf kiest.

## Concepten (automatisch opslaan)

Terwijl u schrijft, wordt uw werk enkele seconden na elke wijziging automatisch
opgeslagen als een persoonlijk concept — zichtbaar alleen voor uzelf, nooit voor andere
gebruikers, en het overschrijft nooit de gepubliceerde pagina. Sluit u de browser per
ongeluk of navigeert u weg, dan biedt de toepassing bij het opnieuw openen van de
bewerkpagina aan om dat concept terug te laden.

## Interne links

Verwijs naar een andere pagina met dubbele blokhaken en de paginatitel:
`[[Titel van de doelpagina]]`. Bij publicatie herkent de toepassing deze verwijzing en
koppelt ze aan de betreffende pagina — niet aan de tekst. Wordt de doelpagina later
hernoemd of verplaatst, dan blijft de link naar dezelfde pagina wijzen.

- Bestaat er geen pagina met die titel, of zijn er meerdere pagina's met dezelfde titel,
  dan blijft de tekst gewoon zichtbaar als platte tekst (`[[Titel]]`) in plaats van een
  klikbare link — er wordt nooit een kapotte of verkeerde link gemaakt.
- Gebruik `[[Titel|Zichtbare tekst]]` om een andere weergavetekst dan de paginatitel te
  tonen.

## Pagina's verplaatsen, ordenen, naar de prullenbak en herstellen

- Een pagina naar de prullenbak verplaatsen kan via **Naar prullenbak** op de
  paginaweergave. De pagina verdwijnt uit de kennisboom, maar wordt niet definitief
  verwijderd.
- **Herstellen** haalt een pagina terug uit de prullenbak.
- Een pagina in de prullenbak kan niet bewerkt worden totdat ze hersteld is.
- Verplaatsen tussen ouders en herordenen tussen zusterpagina's gebeurt via de API
  (`POST /api/v1/pages/{pageId}/move`); een sleep-en-neerzet-interactie in de zijbalk is
  nog niet gebouwd en volgt in een latere verfijning.

## Toegankelijkheid

Elke actie in dit hoofdstuk — pagina's aanmaken, bewerken, publiceren, naar de
prullenbak verplaatsen, herstellen en tussen schrijf-/voorbeeldweergave wisselen — is
volledig met het toetsenbord te bedienen en voldoet aan WCAG 2.2 AA (geverifieerd met
axe-core tegen de echte, draaiende toepassing, op zowel een desktop- als een
mobiel-viewport).