Koppel vertaalde documentpagina’s op basis van hun gedeelde inhoud en doel, en noteer vervolgens de exacte URL voor elke taal. Verschillende slugs zijn geen probleem. Met deze Mac-werkwijze kan een redacteur van openbare documenten die koppeling opbouwen en nauwkeurige taallinks en zoekannotaties voorbereiden.

Waarom overeenkomende slugs niet nodig zijn

Stel dat een Engels document uitlegt hoe je een raster met gekleurde vierkanten maakt. De Franse vertaling legt dezelfde taak uit, maar de twee adressen eindigen anders. Google staat gelokaliseerde woorden in URL’s expliciet toe en raadt afzonderlijke URL’s aan voor verschillende taalversies. Je hoeft de vertalingen niet een nieuwe naam te geven zodat hun paden overeenkomen. Meertalige en multiregionale websites beheren.

Er zijn twee afzonderlijke vragen om te beantwoorden: ‘Zijn deze URL’s identiek?’ en ‘Zijn deze documenten vertalingen van elkaar?’ De WHATWG URL Standard definieert URL-gelijkheid aan de hand van een vergelijking van geserialiseerde URL’s. Die vergelijking stelt geen vertaalrelatie tussen verschillende adressen vast. Bepaal voor deze werkwijze de relatie op basis van de documenten en leg die vervolgens expliciet vast. URL Standard, URL-equivalentie.

De onderstaande voorbeelden zijn fictieve adressen voor openbare documenten onder example.com; ze illustreren een voorgestelde koppeling, geen live opgehaalde pagina’s. De taak is om gelijkwaardige Engelse en Franse instructies aan elkaar te koppelen en het bestaande adres van elke pagina te behouden.

Maak een koppelingsrecord op je Mac

Begin met één documentpaar. Houd de bronpagina en de voorgestelde vertaling geopend in afzonderlijke Safari-tabbladen, naast een lokaal koppelingsdocument. Je hebt de volledige tekst van beide versies nodig en, voor de uiteindelijke implementatie, toegang tot de publicatie-instellingen voor taalrelaties of paginametadata.

Leg de exacte adressen vast

Druk in Safari op Command-L om het Smart Search-veld te selecteren en vervolgens op Command-C om het adres te kopiëren. Herhaal dit voor de vertaling zodra die is geladen. Apple documenteert beide sneltoetsen. Door het adres vast te leggen dat na het navigeren wordt bereikt, kun je ook een onverwachte bestemming opmerken. Sneltoetsen en gebaren in Safari op de Mac.

Voor een kleine verzameling volstaat Teksteditor. Maak een nieuw document, kies Opmaak > Maak platte tekst en bewaar het als translation-map.txt. Als je een bestaand document met opgemaakte tekst omzet, wordt de opmaak verwijderd; gebruik daarom voor dit record een nieuw document. Deze handelingen volgen de instructies van Apple voor Teksteditor. Documenten maken, openen en omzetten in Teksteditor op de Mac.

Gebruik een stabiele document-ID die de onderliggende taak beschrijft. Hieronder staat een volledig voorbeeldrecord, geen configuratiebestand dat een publicatiesysteem automatisch inleest:

Document-ID: tile-grid
Leestaak: Een raster met vier kolommen gekleurde vierkanten maken
Engelse URL: https://example.com/en/docs/arrange-tiles
Franse URL: https://example.com/fr/guides/disposer-les-carres
Engelse taalcode: en
Franse taalcode: fr
Controle van de reikwijdte: Dezelfde instructies, hetzelfde diagram en dezelfde documenteditie
Koppelingsbesluit: Vertaalpaar

De ID biedt een vast aanknopingspunt als titels of slugs veranderen. Houd de adressen in afzonderlijke velden in plaats van het ene adres uit het andere af te leiden. Als je in dit voorbeeld /en/ vervangt door /fr/, ontstaat een niet-geverifieerd adres en mis je het werkelijke pad van de vertaling.

Controleer of de documenten dezelfde taak afronden

Vergelijk de inleiding, instructies, diagramlabels, voorbeelden en editie. Vertaalde titels hoeven niet woord voor woord op elkaar te lijken. Vraag je in plaats daarvan af of een lezer die de andere taal kiest gelijkwaardige instructies voor dezelfde activiteit krijgt.

Gebruik deze beslissingstabel voordat je een pagina aan de koppeling toevoegt. Dit is een redactioneel hulpmiddel om alternatieve versies van dezelfde inhoud te identificeren:

Wat je aantreft Koppelingsbesluit
Dezelfde rasterinstructies en editie, met vertaalde tekst Leg vast als vertaalpaar
De ene pagina gaat over rasters; de andere over kleuren kiezen Houd het als afzonderlijke documenten
De ene vertaling beschrijft een eerdere editie Los het editieverschil op voordat je ze groepeert
Alleen de navigatie is vertaald Leg het hoofddocument niet vast als volledig vertaald
Er bestaat geen overeenkomstig document Laat die taal weg uit de koppeling voor dit document

Een Frans overzicht met links naar verschillende tekenactiviteiten vervangt bijvoorbeeld niet de specifieke Engelse rasterinstructies. Noteer de ontbrekende vertaling als een openstaande contenttaak. Een algemene bestemming kan nog steeds nuttig zijn als navigatie, maar biedt niet het gelijkwaardige document dat deze koppeling vereist.

Koppel de pagina’s voor lezers en Google

Je lokale record is de redactionele bron voor de relatie. De gepubliceerde pagina’s hebben ook een manier nodig om die relatie aan te geven. Begin met zichtbare taallinks die lezers rechtstreeks naar de gekoppelde tegenhanger brengen. Google raadt links tussen taalversies aan, zodat lezers kunnen kiezen, en adviseert om bezoekers niet automatisch om te leiden op basis van hun veronderstelde taal. Meertalige en multiregionale websites beheren.

Voor zoekannotaties ondersteunt Google drie gelijkwaardige methoden: HTML-elementen, HTTP-responheaders en XML-sitemaps. Kies één methode die je eenvoudig kunt onderhouden. Elke taalversie moet zichzelf en de alternatieven aanduiden met volledig gekwalificeerde URL’s en wederzijdse links. Google informeren over gelokaliseerde versies van je pagina.

Bereid voor HTML-pagina’s de alternatieve links voor

De WHATWG HTML Standard bepaalt dat alternate met een andere waarde voor hreflang een vertaling aangeeft. Dit HTML-metadatagedeelte is bedoeld voor het fictieve paar en hoort in het bestaande element head van elke pagina. Het is geen volledig HTML-document. HTML Standard, linktype ‘alternate’.

<link rel="alternate" hreflang="en" href="https://example.com/en/docs/arrange-tiles">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/guides/disposer-les-carres">

Plaats hetzelfde paar op beide pagina’s. De bestemmings-URL’s blijven verschillend, inclusief hun slugs. Volgens de documentatie van Google zijn retourlinks vereist en worden codes die alleen de taal aangeven, zoals en en fr, ondersteund. Google informeren over gelokaliseerde versies van je pagina.

Gebruik voor PDF’s een ondersteunde publicatiemethode

Een PDF kan het bovenstaande fragment niet in een HTML-element head opnemen. Google documenteert HTTP-Link-responheaders voor bestanden die geen HTML zijn. Voor een fictief PDF-paar zou het volledige headerveld er zo uitzien: Google informeren over gelokaliseerde versies van je pagina.

Link: <https://example.com/en/files/tile-grid.pdf>; rel="alternate"; hreflang="en", <https://example.com/fr/fichiers/grille-de-carres.pdf>; rel="alternate"; hreflang="fr"

Configureer dat veld in het antwoord voor elke PDF. RFC 8288 definieert de HTTP-koppelingssyntaxis, waaronder het doel tussen punthaken en de parameter hreflang. Dit zijn antwoordinstellingen; als je de headertekst in de zichtbare tekst van de PDF typt, configureer je die instellingen niet. RFC 8288: Web Linking.

Als je publicatiesysteem geen HTML-metadata of responheaders kan aanpassen, ondersteunt Google ook een sitemap met taalannotaties. Elke URL-vermelding bevat alle versies, inclusief zichzelf. Gebruik de gedocumenteerde sitemapstructuur via je publicatiesysteem of de beheerder ervan. Een lokaal koppelingsbestand implementeert op zichzelf geen van deze methoden. Google informeren over gelokaliseerde versies van je pagina.

Houd vertaalrelaties gescheiden van omleidingen en canonieke URL’s

Een taalgelijkwaardige pagina, een voorkeur-URL voor een duplicaat en een verplaatste pagina vertegenwoordigen verschillende relaties. Door dat onderscheid te maken voorkom je dat een goedbedoelde aanpassing van de koppeling lezers wegleidt van het document dat ze hebben gekozen.

Mechanisme Gedocumenteerd doel Toepassing op deze taak
rel="alternate" met hreflang Taalalternatieven aanduiden De gekoppelde vertalingen met elkaar verbinden
rel="canonical" Een voorkeur-URL aanduiden voor dubbele of sterk gelijkende pagina’s Dubbele adressen binnen de juiste taal afhandelen
Location in een omleidingsantwoord De bestemming van de omleiding aanduiden Een verplaatst adres afhandelen
Content-Language De beoogde taaldoelgroep van de representatie beschrijven De doelgroep van het antwoord aanduiden
Content-Location De resource aanduiden die bij de meegeleverde representatie hoort De locatie van de representatie beschrijven

Google raadt aan om bij gebruik van hreflang een canonieke URL in dezelfde taal te gebruiken, of de beste vervanging als die er niet is. Voor deze afzonderlijke vertaalde documenten is een zelfverwijzende canonieke URL op elke voorkeurstaal-URL een eenvoudige implementatie. Laat de Franse canonieke URL niet naar het Engels verwijzen alleen omdat de Engelse tekst als eerste is geschreven. Een canonieke URL opgeven met rel="canonical" en andere methoden.

RFC 9110 definieert Location in omleidingsantwoorden, Content-Language en Content-Location afzonderlijk. Het laatste is metadata over de representatie, geen vervanging voor de doel-URL. Geen van deze velden somt op zichzelf de vertaalpaarrelatie van dit document op; behoud de alternatieve links voor die relatie. RFC 9110: HTTP-semantiek.

Controleer beide richtingen en onderhoud de koppeling

Doorloop de volgende controles voordat je de koppeling overdraagt voor implementatie. Herhaal ze na latere publicatiewijzigingen voor de openbare uitvoer; een correct record en correcte gepubliceerde metadata zijn twee afzonderlijke zaken.

  1. Open beide vastgelegde adressen en vergelijk de daadwerkelijke documentinhoud.
  2. Volg de zichtbare taallink van Engels naar Frans en vervolgens terug. Controleer of elke bestemming de specifieke tegenhanger is.
  3. Vergelijk de geconfigureerde alternatieve URL’s teken voor teken met het koppelingsrecord.
  4. Controleer of beide versies dezelfde vertaalset aanduiden, inclusief zichzelf.
  5. Controleer de canonieke instellingen afzonderlijk voor elke taal.
  6. Werk bij een adreswijziging de koppeling en elke verwijzing naar dat adres in het paar bij.

Wees voorzichtig met het opschonen van URL’s. RFC 9110 behandelt de hoofdlettergevoeligheid van schema en host als ongevoelig, terwijl andere onderdelen volgens de normalisatieregels hoofdlettergevoelig worden vergeleken. Zet een pad niet om in kleine letters en verwijder geen afsluitende slash alleen om twee records er hetzelfde uit te laten zien; behoud de geverifieerde bestemming. RFC 9110, normalisatie en vergelijking van HTTP(S).

Voor het fictieve paar is het nuttige resultaat een stabiel tile-grid-record dat twee exacte adressen met elkaar verbindt, met gelijkwaardige inhoud en links die in beide richtingen werken. Bewaar dat record bij de onderhoudsnotities van het document, zodat een toekomstige vertaling of slugwijziging aanleiding kan zijn om de relatie bewust bij te werken.

Bronnen