Gebroken links opsporen en herstellen

Kort antwoord: ga naar Content en open Gebroken links. Sarrai scant je artikels op verwijzingen die nergens meer naartoe leiden en zet ze per taal in een lijst. Klik bij een rij op Open in editor om het bronartikel te openen en de verwijzing te herstellen.

Wat de scan opspoort

De pagina zoekt drie soorten kapotte verwijzingen op:

• Links naar een ander artikel dat niet meer bestaat. Verwijs je in een artikel naar een ander artikel dat intussen verwijderd of gearchiveerd is, dan komt die link hier bovendrijven.
• Afbeeldingen die niet meer laden. Plaatste je ergens een afbeelding die intussen weg is, dan zie je dat hier staan.
• Links naar gedepubliceerde content. Verwijs je naar een intern artikel dat iemand later depubliceert, dan werkt die link niet meer voor je bezoekers en verschijnt hij in dit overzicht.

Die laatste is de reden waarom de pagina zo handig is: een link kan perfect werken op het moment dat je hem plaatst en later stilletjes breken omdat er elders iets verandert. De scan vangt dat voor je op.

Twee soorten die je niet verwacht

Een link naar een concept telt ook mee. Verwijs je vanuit een gepubliceerd artikel naar een artikel dat je nog niet publiceerde, dan bestaat dat doel niet op je publieke kennisbank en klikt je bezoeker op een dood anker. De rij verdwijnt zodra je het doelartikel publiceert. Je hoeft de link zelf dus niet aan te passen.

Een relatief pad wordt nooit geprobeerd en altijd gemeld. Een verwijzing zoals ../handleiding/README.md, typisch een restant van geïmporteerde documentatie, werkt per definitie niet op een publieke kennisbank. Sarrai doet geen poging om zo'n pad op te lossen en zet het meteen in de lijst. Dat is dus geen vals alarm dat later vanzelf goedkomt.

Dit overzicht is bovendien de enige plek waar je een niet-ladende afbeelding of zo'n relatief pad ziet. De linkpanelen in de artikeleditor laten die bewust weg, want die gaan over artikels die naar elkaar verwijzen. Sla je deze pagina over, dan merk je zulke problemen pas wanneer een bezoeker erover valt.

Zo herstel je een gebroken link

1. Open Content in het menu en ga naar Gebroken links.
2. Bekijk de lijst. Per rij zie je het bronartikel (waar de verwijzing in staat), het type (bijvoorbeeld externe link, interne link of afbeelding), de verwijzing zelf en de reden waarom ze als gebroken geldt.
3. Klik rechts op Open in editor. Er opent een nieuw tabblad met de artikeleditor, meteen op het juiste artikel en in de juiste taal.
4. Vervang of verwijder de verwijzing en publiceer het artikel opnieuw.

De scan opnieuw uitvoeren

De eerste keer dat je de pagina opent, voert Sarrai de scan automatisch uit. Heb je net een link hersteld, klik dan rechtsboven op Opnieuw scannen om de lijst te verversen. Zo zie je meteen je eigen vooruitgang: opgeloste verwijzingen verdwijnen uit het overzicht.

Per taal

De lijst toont de gebroken links per taal. Bovenaan schakel je met de tabs (bijvoorbeeld NL-BE en EN) tussen de talen, met bij elke tab een teller die zegt hoeveel er nog openstaan. Zo werk je taal per taal je kennisbank op orde. Meer over het onderhouden van meertalige content lees je bij Een artikel in meerdere talen aanbieden.

Waarom de pagina traag kan openen

Dit is geen opgeslagen rapport dat ergens klaarligt: het wordt bij elke keer dat je de pagina opent opnieuw berekend, met echte verzoeken naar het internet en een controle op schijf voor je eigen afbeeldingen. Bij een grote kennisbank met veel externe links duurt het openen daardoor merkbaar lang. Dat is de controle zelf en geen storing.

Twee dingen om te weten bij het lezen van de reden. "Onbereikbaar" betekent niet automatisch "kapot": een trage of tijdelijk platte server levert dezelfde melding op als een pagina die echt verdwenen is. Controleer twijfelgevallen dus zelf even. En oude artikels melden soms niets: links in markdown-schrijfwijze werden vroeger niet herkend, dus een artikel dat je sindsdien niet meer opsloeg draagt nog een index van voor die verbetering. Eén keer Opnieuw scannen, of het artikel gewoon opnieuw opslaan, haalt die alsnog boven.

De pagina is alleen toegankelijk voor beheerders en contentbeheerders, precies omdat de controle echte verzoeken naar het internet stuurt. Een operator ziet de knop niet staan, en wie de URL rechtstreeks opent belandt zonder melding op zijn eigen startpagina.

Goed om te weten

Een gebroken link is niet alleen vervelend voor je bezoekers, ook Sarrai kan een bron niet gebruiken die nergens meer naartoe leidt. Gebroken links af en toe doorlopen hoort dan ook thuis bij het gezond houden van je kennisbank, samen met reviewdata en de filter voor verouderde content. Zie Je content actueel houden voor de volledige aanpak.

Ook gezocht als

"dode links vinden", "kapotte link herstellen", "afbeelding laadt niet meer", "link naar verwijderd artikel", "gedepubliceerd artikel nog gelinkt"

Zie ook

• Je content actueel houden
• Een nieuw artikel schrijven
• Een artikel in meerdere talen aanbieden