Verbroken ankerlinks en ontbrekende fragmenten vinden en herstellen

Wat is een ankerlink of URL-fragment?#

Een ankerlink gebruikt een fragmentidentificatie na # om naar een locatie of toestand binnen een bron te verwijzen. In een typische documentatie-URL zoals /help/#installation identificeert het paginapad het document en het fragment een doel daarin.

Bij een gewone HTML-sectielink komt het fragment meestal overeen met een element-ID. Als het document laadt maar het doel niet meer bestaat, kan de bezoeker bovenaan blijven of op een onverwachte plaats belanden. De reactiecode kan nog succes aangeven omdat het document zelf bestaat.

Waarom ankerlinks breken na inhoudsbewerking#

Veel inhoudssystemen genereren kop-ID's uit de koptekst. „Installatie” hernoemen naar „Aan de slag” kan het gegenereerde fragment veranderen, zelfs als het onderwerp op dezelfde pagina blijft. Koppen verplaatsen of dupliceren kan automatisch gegenereerde ID's ook wijzigen.

Andere problemen ontstaan door een onvolledig adres te kopiëren, interpunctie te wijzigen of het doel in inhoud te plaatsen die pas na interactie wordt geladen. Een link die op je geopende pagina werkt, kan falen wanneer iemand de URL direct in een nieuw tabblad opent. Behandel dit als verschillende navigatieomstandigheden en test beide.

Een ontbrekend anker onderzoeken#

Open de volledige bestemmings-URL inclusief fragment. Wacht tot het document is geladen en controleer of de bedoelde sectie bestaat en de browser die bereikt. Vergelijk het fragment met de exacte ID op de pagina. Neem niet aan dat de zichtbare koptekst en gegenereerde ID identiek zijn.

Gebruik Linky om ontbrekende ankers te vinden en verifieer vervolgens de relevante paginatoestand handmatig. De URL- en fragmentinspectie op deze website kan een geplakt adres in onderdelen splitsen, maar haalt de bestemming niet op en bewijst niet dat daar een element bestaat.

1. Kopieer de volledige bronlink, inclusief fragment.
2. Open deze in een nieuw tabblad en wacht tot de pagina volledig is geladen.
3. Bepaal de bedoelde kop of het doelelement.
4. Vergelijk de ID ervan met het fragment.
5. Herstel bron of doel en test de gepubliceerde route opnieuw.

Kies stabiele ID's voor inhoud waarnaar mensen linken#

Kies voor vaak aangehaalde documentatie stabiele ID's die het onderwerp beschrijven en redactionele formuleringen overleven. Een zichtbare titel kan verbeteren zonder alle bladwijzers ernaartoe te breken. Leg belangrijke ID's vast wanneer je inhoud tussen systemen verplaatst.

Heeft een oud anker veel verwijzingen, overweeg dan een compatibel doel bij de vervangende sectie te behouden. Zorg dat dit geen dubbele ID's veroorzaakt of toegankelijkheid verstoort. Is compatibiliteit niet haalbaar, werk dan de links bij die je beheert en communiceer waar nodig de nieuwe bestemming.

Fragmenten, routering en bijzondere linkformaten#

Niet elk fragment is een eenvoudige element-ID. Sommige toepassingen gebruiken het fragment voor routering aan de clientzijde of de toepassingstoestand. Tekstfragmentlinks kunnen ook tekst identificeren in plaats van een gewoon doelelement. Bepaal het formaat voordat je een controleresultaat interpreteert.

Als je toepassing een bijzondere fragmentroute nodig heeft, test dan directe navigatie en vernieuwen. Is de link bedoeld als gewone inhoudsverwijzing, kies dan een stabiele bestemming die bezoekers zonder eerdere toepassingstoestand kunnen openen en delen. Documenteer uitzonderingen in de controle in plaats van elke URL in één regel te dwingen.

Controleer dieplinks tijdens migraties en releases#

Voeg belangrijke fragmenten naast paginapaden toe aan de migratiechecklist. Documentatienavigatie, inhoudsopgaven en releaseopmerkingen bevatten vaak veel sectielinks. Een URL-migratie kan succesvol lijken terwijl deze verwijzingen onbruikbaar blijven.

Test vóór publicatie links vanaf een andere pagina, niet alleen vanuit de lokale inhoudsopgave. Voer na publicatie een paginascan uit en controleer bekende dieplinks. Bewaar bedoeld onderwerp, bronpagina en nieuw doel samen in het herstelverslag, zodat een andere redacteur kan bevestigen waarom de bestemming veranderde.

• Controleer gegenereerde kop-ID's na bewerkingen.
• Vermijd dubbele ID's in hetzelfde document.
• Behoud stabiele doelen voor vaak gedeelde secties.
• Test directe navigatie naar dynamisch geladen inhoud.
• Controleer fragmenten bij het verplaatsen of samenvoegen van documentatie.

Veelgestelde vragen#

Pas deze werkwijze toe

Lees de bijbehorende Linky-documentatie voor de productbediening en limieten die in dit artikel worden gebruikt. Contact opnemen met support als een resultaat nader onderzoek vereist.