# Zoeken, revisiegeschiedenis, verwijzingen en labels

Deze gids beschrijft de M3-functionaliteit: zoeken, revisiegeschiedenis bekijken en
herstellen, zien welke pagina's naar een pagina linken, labels, en het definitief
opruimen van de prullenbak. Geschreven voor redacteuren en beheerders.

## Zoeken

Klik op **Zoeken** bovenaan om de zoekpagina te openen.

- Zoeken doorzoekt titels, labels en de inhoud van pagina's. Een exacte titel of
  woordgroep weegt zwaarder mee dan een los woord dat toevallig ergens voorkomt.
- Zoeken is tolerant voor kleine typfouten in een titel (bijvoorbeeld
  "Trubleshootng" vindt nog steeds "Troubleshooting ...").
- Gebruik het filter **Label** om alleen pagina's met een specifiek label te tonen, of
  **Documenttype** om te filteren op bijvoorbeeld enkel runbooks.
- Zoekresultaten tonen nooit pagina's die in de prullenbak staan.
- Een fragment van de gevonden tekst wordt getoond, met de gevonden term
  gemarkeerd.

## Labels

- Voeg labels toe aan een pagina via het veld **Labels** in de bewerkpagina, gescheiden
  door komma's (bijvoorbeeld `netwerk, archief`).
- Labels worden getoond als chips bovenaan de pagina.
- Klik in de zoekpagina op het filterveld **Label** en typ de naam van een label om
  alleen pagina's met dat label te zien.

## Revisiegeschiedenis

Elke publicatie van een pagina bewaart de vorige inhoud als een onveranderlijke
revisie — niets gaat ooit verloren, ook niet wanneer u een pagina hersteld naar een
oudere versie.

1. Open een pagina en klap **Revisiegeschiedenis** open, onderaan de pagina.
2. Klik op een revisie om de inhoud van dat moment te bekijken.
3. Klik op **Deze revisie herstellen** om die inhoud opnieuw te publiceren als de
   nieuwste versie. De versie die u zojuist verliet, blijft ook bewaard als revisie —
   er wordt nooit geschiedenis overschreven of verwijderd.

## Pagina's die hierheen linken

Klap **Pagina's die hierheen linken** open, onderaan een pagina, om te zien welke
andere pagina's naar deze pagina verwijzen via een `[[interne link]]`. Deze lijst blijft
correct nadat de huidige pagina van titel, locatie in de boom, of URL-pad verandert.

## Prullenbak definitief opruimen (alleen beheerder)

Een pagina die naar de prullenbak is verplaatst, blijft daar minstens 30 dagen bewaard
en is binnen die periode altijd herstelbaar. Na die periode kan een beheerder de
prullenbak definitief opruimen via `POST /api/v1/admin/trash/purge` (de webinterface
hiervoor volgt in een latere milestone; de API is al volledig functioneel en getest).

- Alleen pagina's waarvan de bewaarperiode al verstreken is, worden verwijderd.
- Een pagina die nog binnen de bewaarperiode valt, blijft ongemoeid — er is geen manier
  om die termijn via deze aanroep te omzeilen.
- Dit is de enige plaats in de toepassing waar inhoud definitief en onomkeerbaar
  verdwijnt; de gewone webinterface heeft hiervoor geen knop.