99 lines
5.0 KiB
Markdown
99 lines
5.0 KiB
Markdown
# 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).
|