Gebruik na een URL-migratie één oude-naar-nieuwe-URL-mapping om openbare links, canonical-declaraties, omleidingen en sitemapvermeldingen bij te werken. Deze Mac-desktopworkflow laat zien hoe je die wijzigingen op elkaar afstemt en het gepubliceerde resultaat controleert.

De taak hier is een kleine verzameling openbare HTML-documenten die op dezelfde website naar nieuwe paden worden verplaatst. Alle voorbeeldadressen en paginanamen zijn fictief. Voor de volledige workflow heb je toegang nodig tot het publicatiesysteem, de instellingen voor omleidingen en de relevante Search Console-property.

Wat moet na de migratie met elkaar overeenkomen?

Kies voor elk verplaatst document één definitieve bestemming. Links die je beheert, moeten daar rechtstreeks naartoe verwijzen, de bestemming moet zichzelf als canonical identificeren en de actuele sitemap moet dat adres vermelden. Het oude adres moet ernaartoe omleiden. Google beschrijft omleidingen en canonical-annotaties als sterke signalen voor canonicalisering, terwijl opname in de sitemap een zwakker signaal is. Deze methoden kunnen elkaar versterken, maar uiteindelijk kiest Google zelf de canonical. Googles richtlijnen voor canonicalisering.

Deze mechanismen hebben verschillende functies. Een omleiding handelt een verzoek naar een oud adres af. Een openbare link bepaalt waar een lezer vervolgens naartoe gaat. Een canonical-declaratie identificeert de voorkeurs-URL voor een document; WHATWG definieert die betekenis voor het linktype canonical. Een sitemap bevat een lijst met voorkeurs-URL's voor ontdekking. Het bijwerken van het ene wijzigt de andere niet. WHATWG HTML Standard: canonical-linktype, Googles richtlijnen voor sitemaps.

Gebruik deze overeenstemmingstabel als praktische acceptatiecontrole. Dit is een workflow op basis van de documentatie, geen scoresysteem van Google.

Onderdeel Verwacht resultaat voor het fictieve document Colors
Oud adres https://example.com/notes/colors.html stuurt permanent door naar de bestemming
Bestemming https://example.com/library/colors/ serveert het document Colors
Navigatie en documentlinks Verwijzen rechtstreeks naar https://example.com/library/colors/
Canonical van de bestemming Identificeert https://example.com/library/colors/
Vermelding in de actuele sitemap Vermeldt https://example.com/library/colors/

Maak één mapping voordat je afzonderlijke instellingen wijzigt

Open op je Mac een spreadsheet of teksteditor en noteer elk oud adres naast de beoogde bestemming. Google raadt aan om als onderdeel van een verhuizing een mapping van oude naar nieuwe URL's voor te bereiden. Bewaar een kopie van de oorspronkelijke lijst, zodat het vervangen van sitemapvermeldingen je overzicht van adressen waarvoor nog omleidingen nodig zijn niet uitwist. Googles richtlijnen voor siteverhuizingen.

Document Oud pad Definitief pad
Colors /notes/colors.html /library/colors/
Palette /notes/palette.html /library/palette/
Shapes /notes/shapes.html /library/shapes/

Noteer voor elke rij waar je wijzigingen moet aanbrengen: de pagina-editor, gedeelde navigatie, de canonical-instelling, de omleidingsinstelling en de sitemapgenerator. Voeg aparte controlekolommen toe voor de openbare respons en inspectie in Search Console. Zo wordt de vage opdracht om “URL's bij te werken” omgezet in een eindige reeks wijzigingen en controles.

Controleer de bestemmingsinhoud voordat je een mapping goedkeurt. Als twee oude documenten zijn samengevoegd tot één nuttig document, kunnen beide daarheen omleiden. Stuur niet-gerelateerde documenten niet naar een algemene homepage; Google waarschuwt dat irrelevante omleidingen als soft 404's kunnen worden behandeld. Googles aanbevelingen voor het in kaart brengen van omleidingen.

Werk openbare links bij en controleer relatieve paden

Werk in je publicatie-editor met behulp van de mapping de navigatie, documentindexen, links naar verwante documenten en links in de artikeltekst bij. Als het systeem navigatie genereert op basis van paginagegevens, wijzig dan de onderliggende gegevens of het sjabloon in plaats van de gegenereerde uitvoer steeds opnieuw te corrigeren. Controleer elke vervanging voordat je opslaat, vooral wanneer het oude pad ook in toelichtende voorbeelden voorkomt.

Een padwijziging kan de bestemming van een relatieve link veranderen, zelfs als de tekst hetzelfde blijft. De WHATWG URL Standard lost relatieve verwijzingen op aan de hand van een basis-URL. Ga voor de voorbeelden hieronder ervan uit dat het document geen expliciete basis-override heeft. WHATWG URL Standard.

Document-URL Linkwaarde Opgeloste bestemming
https://example.com/notes/colors.html palette.html https://example.com/notes/palette.html
https://example.com/library/colors/ palette.html https://example.com/library/colors/palette.html
https://example.com/library/colors/ /library/palette/ https://example.com/library/palette/

Deze fictieve URL-resoluties zijn gecontroleerd met de JavaScript-API URL. De ongewijzigde waarde palette.html verwijst nu naar een locatie binnen de map Colors, dus een geslaagde tekstvervanging elders zou het probleem niet opsporen. Voor deze kleine verzameling maakt het gebruik van het bedoelde root-relatieve pad de bestemming expliciet. Als je naar een andere host verhuist, gebruik dan het juiste absolute adres of controleer of elke root-relatieve link nog steeds op de bedoelde host blijft.

Open het gepubliceerde document Colors in de browser op je Mac en volg de link naar Palette. Controleer zowel het weergegeven document als het uiteindelijke adres. Herhaal dit voor gedeelde navigatie en eventuele sectielinks. Als een link #swatches gebruikt, controleer dan of de bestemming nog steeds de bijbehorende sectie-ID bevat; alleen op basis van de padmapping kun je dat niet vaststellen.

Stel canonicals en permanente omleidingen in bij de bron

Stel voor elk nieuw HTML-document de canonical in op de definitieve absolute URL. Google raadt absolute canonical-URL's aan en accepteert het canonical-element in de HTML van het document, in de head. Als je publicatiesysteem een canonical-veld heeft, voer het adres daar in en controleer wat het systeem genereert. Googles instructies voor de implementatie van canonicals.

Voor de pagina Colors is het volgende een metadatafragment dat je binnen de bestaande document-head plaatst; het is geen volledige HTML-pagina:

<link rel="canonical" href="https://example.com/library/colors/">

Controleer of de host ook een canonical verstuurt via een HTTP-Link-responsheader. Google ondersteunt beide methoden, maar raadt aan er één te kiezen, omdat het onderhouden van beide conflicterende bestemmingen kan opleveren. Corrigeer het sjabloon of de instelling die de waarde genereert, zodat de volgende publicatie geen oud adres terugzet. Googles methoden voor canonicalisering.

Configureer het oude adres zo dat het een permanente omleiding op serverniveau naar de bestemming retourneert. RFC 9110 definieert 301 en 308 als permanente omleidingen en beschrijft de bestemming in de Location-header. Het verschil heeft ook betrekking op de afhandeling van de requestmethode: 308 behoudt de methode, terwijl 301 historisch POST-naar-GET-gedrag toestaat. Voor gewone documentverzoeken behandelt Google beide als signalen voor permanente omleidingen. RFC 9110: HTTP Semantics, Googles documentatie over omleidingen.

De exacte configuratie hangt af van je host of publicatiesysteem. Bewerken in een browser kan op zichzelf geen HTTP-responsregel aanmaken. Als je platform geen omleidingen op serverniveau kan configureren, gebruik dan de gedocumenteerde hostingconfiguratie of vraag de hostingbeheerder om de mapping te implementeren. Google beschrijft een directe meta refresh als terugvaloptie wanneer omleidingen op serverniveau niet beschikbaar zijn; JavaScript-omleidingen raadt het alleen aan als de andere benaderingen niet kunnen worden gebruikt. Een canonical-declaratie alleen verplaatst een bezoeker niet naar het nieuwe adres. Googles ondersteunde omleidingsmethoden.

Genereer de sitemap opnieuw op basis van dezelfde bestemmingen

Werk de bron van de sitemap bij en genereer de sitemap vervolgens opnieuw. Een handmatige correctie in een gegenereerd bestand gaat bij de volgende build gemakkelijk verloren. Voor deze migratie moet de actuele sitemap de definitieve URL's van Colors, Palette en Shapes bevatten in plaats van hun oude paden.

Google vereist voor sitemaps volledig gekwalificeerde absolute URL's en UTF-8-codering. Als je alleen webpagina's hoeft te vermelden, wordt een tekstsitemap ondersteund: één URL per regel, zonder koppen of toelichting. Het volledige fictieve voorbeeld met drie pagina's zou er zo uitzien:

https://example.com/library/colors/
https://example.com/library/palette/
https://example.com/library/shapes/

Googles sitemapformaten en vereisten.

Als de site al een XML-sitemap genereert, behoud dan dat ondersteunde formaat en werk de URL-vermeldingen bij. Gebruik nauwkeurige wijzigingsdatums wanneer je lastmod opgeeft; volgens Google moet deze waarde belangrijke pagina-updates weergeven. Vervang niet automatisch elke datum om de sitemap alleen maar recent te laten lijken. Googles richtlijnen voor XML-sitemaps.

Controleer het openbare resultaat op je Mac

Controleer de uitgerolde uitvoer, want een voorbeeld in de editor geeft geen uitsluitsel over de HTTP-respons op het openbare adres. Open Terminal op je Mac. De volgende diagnostische opdrachten gebruiken fictieve adressen: vervang ze vóór uitvoering door de bijbehorende openbare URL's uit je eigen mapping. Deze voorbeelden impliceren geen resultaat van een live migratie.

old_url='https://example.com/notes/colors.html'
new_url='https://example.com/library/colors/'

curl --silent --show-error --connect-timeout 10 --max-time 30 \
  --dump-header - --output /dev/null "$old_url"

curl --silent --show-error --connect-timeout 10 --max-time 30 \
  --location --max-redirs 5 --output /dev/null \
  --write-out 'status=%{http_code}\nfinal=%{url_effective}\nredirects=%{num_redirects}\n' \
  "$old_url"

curl --silent --show-error --connect-timeout 10 --max-time 30 \
  "$new_url"

De eerste opdracht toont de headers van de eerste respons zonder de omleiding te volgen. De tweede volgt omleidingen en rapporteert de eindstatus, het eindadres en het aantal omleidingen. De derde haalt de markup van de bestemming op om die te inspecteren. Deze opties worden beschreven in de curl-handleiding.

Bij een eenvoudig toegewezen pagina verwacht je een eerste 301 of 308 met de bedoelde Location, waarna het eindadres het document succesvol serveert. Controleer de teruggegeven markup op de canonical. Lees het document ook in je browser: een geslaagde HTTP-respons bewijst op zichzelf niet dat de juiste inhoud is aangekomen. Google raadt aan rechtstreeks naar de definitieve bestemming om te leiden in plaats van omleidingsketens te maken. RFC 9110: statuscodes, Googles richtlijnen voor siteverhuizingen.

Gebruik bij een mislukte rij de volgende diagnostische volgorde. Zo blijven reparaties gekoppeld aan waarneembare uitvoer.

Waarneming Volgende actie
De oude URL leidt om naar een onbedoelde pagina Corrigeer die mapping of omleidingsregel
De omleiding komt uit bij een andere omleiding Laat het oude adres rechtstreeks naar de definitieve bestemming verwijzen
De juiste pagina heeft een oude canonical Corrigeer de bron van de metadata en publiceer opnieuw
Navigatie gebruikt nog steeds een oud pad Werk de oorspronkelijke link of het gedeelde sjabloon bij
De sitemap vermeldt nog oude paden Corrigeer de invoer van de generator en genereer opnieuw
Terminal meldt een time-out Herhaal de controle nadat het verbindingsprobleem is opgelost; noteer de test als onvolledig

Dien de sitemap in en maak onderscheid tussen livecontroles en indexering

Selecteer in Search Console de property die de nieuwe URL's omvat en gebruik het rapport Sitemaps om het openbare sitemapadres in te dienen. Google beschrijft dit rapport als een indieningsmethode die ook verwerkingsfouten toont. Indienen is een hint voor ontdekking, geen garantie op indexering. Googles instructies voor het indienen van een sitemap.

Inspecteer een nieuw document door de volledige URL ervan in de inspectiebalk van Search Console in te voeren. Gebruik de live test om de huidige toegankelijkheid en mogelijke indexeerbaarheid te onderzoeken. Gebruik voor Googles canonical-keuze het geïndexeerde resultaat en het veld Door Google geselecteerde canonical. De live test kan de canonical-keuze niet voorspellen. URL-inspectietool van Search Console.

In dit voorbeeld worden paden binnen één host gewijzigd, dus de tool Adreswijziging is niet van toepassing. Google geeft uitgevers die paden verplaatsen de instructie om omleidingen in te stellen en sitemaps bij te werken. De tool is bedoeld voor verhuizingen van domeinen of subdomeinen nadat de site is verhuisd en de omleidingen zijn ingesteld. De tool Adreswijziging van Search Console.

Bewaar de mapping als onderhoudsregistratie. Markeer een rij pas als voltooid wanneer de openbare omleiding, bestemmingsinhoud, links, canonical en sitemap overeenkomen; noteer latere waarnemingen over Google-indexering apart. Behoud omleidingen zo lang mogelijk—Googles algemene migratierichtlijnen adviseren ten minste één jaar—en gebruik bij toekomstige documentbewerkingen steeds de definitieve adressen. Googles migratierichtlijnen.

Bronnen