Mappa översatta dokumentsidor utifrån deras gemensamma innehåll och syfte och anteckna sedan den exakta URL:en för varje språk. Det går bra med olika sluggar. Det här Mac-arbetsflödet hjälper en redaktör för offentliga dokument att skapa mappningen och förbereda korrekta språklänkar och sökannoteringar.
Varför sluggarna inte behöver matcha
Anta att ett engelskt dokument förklarar hur man ordnar ett rutnät med färgade kvadrater. Den franska översättningen beskriver samma uppgift, men de två adresserna slutar på olika sätt. Google tillåter uttryckligen lokaliserade ord i URL:er och rekommenderar separata URL:er för olika språkversioner. Du behöver inte byta namn på översättningarna så att sökvägarna matchar. Hantera webbplatser med flera regioner och språk.
Det finns två separata frågor att besvara: ”Är dessa URL:er identiska?” och ”Är dessa dokument översättningar av varandra?” WHATWG:s URL-standard definierar URL-likhet genom jämförelse av serialiserade URL:er. Den jämförelsen fastställer inte att olika adresser har ett översättningssamband. I det här arbetsflödet avgör du sambandet utifrån dokumenten och antecknar det sedan uttryckligen. URL-standarden, URL-ekvivalens.
Exemplen nedan är syntetiska adresser till offentliga dokument under example.com; de visar en föreslagen mappning, inte sidor som hämtats live. Uppgiften är att koppla ihop likvärdiga instruktioner på engelska och franska och samtidigt behålla varje sidas befintliga adress.
Skapa en mappningspost på din Mac
Börja med ett dokumentpar. Ha källsidan och den föreslagna översättningen öppna i separata Safari-flikar, tillsammans med ett lokalt mappningsdokument. Du behöver hela texten för båda versionerna och, inför den slutliga implementeringen, åtkomst till publiceringsinställningarna som styr språkversionernas relationer eller sidmetadata.
Spara de exakta adresserna
I Safari trycker du på Command-L för att markera Smart Search-fältet och sedan på Command-C för att kopiera adressen. Upprepa för översättningen när den har lästs in. Apple dokumenterar båda kortkommandona. Om du sparar adressen efter navigeringen ser du också om du hamnat på en oväntad destination. Kortkommandon och gester i Safari på Mac.
För en liten samling räcker Textredigerare. Skapa ett nytt dokument, välj Format > Gör till ren text och spara det som translation-map.txt. Om du konverterar ett befintligt dokument med formaterad text tas formateringen bort, så använd ett nytt dokument för den här posten. Så här beskriver Apples instruktioner för Textredigerare dessa åtgärder. Skapa, öppna och konvertera dokument i Textredigerare på Mac.
Använd en stabil dokumentidentifierare som beskriver den underliggande uppgiften. Följande är en fullständig exempelpost, inte en konfigurationsfil som ett publiceringssystem automatiskt läser:
Dokument-ID: tile-grid
Läsarens uppgift: Ordna ett rutnät med fyra kolumner av färgade kvadrater
URL på engelska: https://example.com/en/docs/arrange-tiles
URL på franska: https://example.com/fr/guides/disposer-les-carres
Språkkod för engelska: en
Språkkod för franska: fr
Kontroll av omfattning: Samma instruktioner, diagram och dokumentutgåva
Mappningsbeslut: Översättningspar
Identifieraren ger dig en fast punkt även om titlar eller sluggar ändras. Spara adresserna i separata fält i stället för att härleda den ena från den andra. Om du byter ut /en/ mot /fr/ i det här exemplet får du en overifierad adress och missar den faktiska översatta sökvägen.
Kontrollera om dokumenten leder till samma resultat
Jämför introduktionen, instruktionerna, diagramtexterna, exemplen och utgåvan. Översatta titlar behöver inte likna varandra ord för ord. Fråga i stället om en läsare som väljer det andra språket får likvärdiga instruktioner för samma aktivitet.
Använd följande beslutstabell innan du lägger till en sida i mappningen. Den är ett redaktionellt hjälpmedel som utgår från behovet av att identifiera alternativa versioner av samma innehåll:
| Det du hittar | Mappningsbeslut |
|---|---|
| Samma rutnätsinstruktioner och utgåva, med översatt text | Registrera som ett översättningspar |
| Den ena sidan handlar om rutnät; den andra om att välja färger | Behandla dem som separata dokument |
| Den ena översättningen beskriver en tidigare utgåva | Lös skillnaden mellan utgåvorna innan du grupperar dem |
| Bara navigeringen är översatt | Registrera inte huvuddokumentet som fullständigt översatt |
| Det finns inget motsvarande dokument | Lämna det språket utanför mappningen för det här dokumentet |
En fransk översikt som länkar till flera teckningsaktiviteter ersätter till exempel inte de specifika engelska instruktionerna för rutnätet. Anteckna den saknade översättningen som en utestående innehållsuppgift. En bredare sida kan fortfarande fungera som navigering, men den tillhandahåller inte det likvärdiga dokument som behövs för den här mappningen.
Koppla ihop de mappade sidorna för läsare och Google
Din lokala post är den redaktionella källan för sambandet. De publicerade sidorna behöver också ett sätt att uttrycka det. Börja med synliga språklänkar som tar läsarna direkt till den mappade motsvarigheten. Google rekommenderar länkar mellan språkversioner så att läsarna kan välja och avråder från att automatiskt omdirigera besökare utifrån ett antaget språk. Hantera webbplatser med flera regioner och språk.
För sökannoteringar stöder Google tre likvärdiga metoder: HTML-element, HTTP-svarshuvuden och XML-webbplatskartor. Välj en metod som är enkel att underhålla. Varje språkversion bör identifiera sig själv och sina alternativa versioner med fullständiga URL:er och ömsesidiga länkar. Informera Google om lokaliserade versioner av din sida.
För HTML-sidor: förbered länkar till alternativa versioner
WHATWG:s HTML-standard anger att alternate med ett annat värde för hreflang betecknar en översättning. Här är ett HTML-metadatafragment för det syntetiska paret. Det hör hemma inuti varje sidas befintliga head-element. Det är inte ett komplett HTML-dokument. HTML-standarden, länktypen ”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">
Lägg samma par på båda sidorna. Destinations-URL:erna är fortfarande olika, inklusive deras sluggar. Googles dokumentation kräver returlänkar och stöder koder som endast anger språk, till exempel en och fr. Informera Google om lokaliserade versioner av din sida.
För PDF-filer: använd en publiceringsmetod som stöds
En PDF kan inte ta emot föregående fragment i ett HTML-head. Google dokumenterar HTTP-Link-svarshuvuden för filer som inte är HTML. För ett syntetiskt PDF-par skulle hela fältet för svarshuvudet se ut så här: Informera Google om lokaliserade versioner av din sida.
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"
Konfigurera det fältet i svaret för varje PDF. RFC 8288 definierar syntaxen för HTTP-länkar, inklusive målet inom vinkelparenteser och parametern hreflang. Det här är svarsinställningar; att skriva in svarshuvudet i PDF-filens synliga text konfigurerar dem inte. RFC 8288: webblänkning.
Om ditt publiceringssystem inte kan redigera HTML-metadata eller svarshuvuden stöder Google även en webbplatskarta med språkannoteringar. Varje URL-post listar alla versioner, inklusive sig själv. Använd den dokumenterade strukturen för webbplatskartor via ditt publiceringssystem eller dess förvaltare. En lokal mappningsfil implementerar inte någon av de här metoderna. Informera Google om lokaliserade versioner av din sida.
Håll översättningsrelationer åtskilda från omdirigeringar och kanoniska URL:er
En språkalternativlänk, en föredragen URL för dubbletter och en flyttad sida beskriver olika relationer. Skillnaden förhindrar att en välmenad mappningsändring leder bort läsare från dokumentet de har valt.
| Mekanism | Dokumenterat syfte | Tillämpning på den här uppgiften |
|---|---|---|
rel="alternate" med hreflang |
Identifiera språkversioner | Koppla ihop de mappade översättningarna |
rel="canonical" |
Ange en föredragen URL bland dubbletter eller mycket likartade sidor | Hantera dubblettadresser inom rätt språk |
Location i ett omdirigeringssvar |
Ange omdirigeringens destination | Hantera en adress som har flyttats |
Content-Language |
Beskriva det avsedda språket för representationens målgrupp | Märka svarsmottagarna med språk |
Content-Location |
Identifiera resursen som motsvarar den medföljande representationen | Beskriva representationens plats |
Google rekommenderar en kanonisk URL på samma språk när du använder hreflang, eller den bästa ersättningen om ingen sådan finns. För de separata översatta dokumenten är det enkelt att låta varje föredragen språk-URL ha en kanonisk URL som hänvisar till sig själv. Undvik att låta den franska kanoniska URL:en peka på engelska bara för att den engelska texten skrevs först. Så anger du en kanonisk URL med rel="canonical" och andra metoder.
RFC 9110 definierar Location i omdirigeringssvar, Content-Language och Content-Location separat. Det sistnämnda är metadata om representationen, inte en ersättning för mål-URL:en. Inget av dessa fält anger i sig dokumentets översättningspar; behåll alternativa länkar för det sambandet. RFC 9110: HTTP-semantik.
Verifiera båda riktningarna och underhåll mappningen
Gå igenom följande kontroller innan du lämnar över mappningen för implementering. Upprepa dem mot det offentliga resultatet efter varje senare publiceringsändring; en korrekt post och korrekta publicerade metadata är två separata saker.
- Öppna båda de sparade adresserna och jämför det faktiska dokumentinnehållet.
- Följ den synliga språklänken från engelska till franska och sedan tillbaka. Kontrollera att varje destination är den specifika motsvarigheten.
- Jämför de konfigurerade alternativa URL:erna med mappningsposten tecken för tecken.
- Kontrollera att båda versionerna anger samma översättningsuppsättning, inklusive sig själva.
- Kontrollera de kanoniska inställningarna separat för varje språk.
- Om en adress ändras uppdaterar du mappningen och alla hänvisningar till den adressen i paret.
Var försiktig när du rensar URL:er. RFC 9110 anger att skiftläget i schemat och värdnamnet inte spelar någon roll, medan övriga delar jämförs skiftlägeskänsligt enligt standardens normaliseringsregler. Gör inte om en sökväg till gemener och ta inte bort ett avslutande snedstreck bara för att två poster ska se likadana ut; behåll den verifierade destinationen. RFC 9110, normalisering och jämförelse av HTTP(S).
För det syntetiska paret är resultatet en stabil tile-grid-post som kopplar ihop två exakta adresser, med likvärdigt innehåll och fungerande länkar i båda riktningarna. Spara posten tillsammans med dokumentets underhållsanteckningar så att en framtida översättning eller ändring av en slug kan uppdatera sambandet på ett genomtänkt sätt.
Källor
- Hantera webbplatser med flera regioner och språk — Google Search Central.
- Informera Google om lokaliserade versioner av din sida — Google Search Central.
- Så anger du en kanonisk URL med rel="canonical" och andra metoder — Google Search Central.
- URL-standarden — WHATWG.
- HTML-standarden: länkar — WHATWG.
- RFC 9110: HTTP-semantik — RFC Editor, IETF.
- RFC 8288: webblänkning — RFC Editor, IETF.
- Kortkommandon och gester i Safari på Mac — Apple Support.
- Skapa, öppna och konvertera dokument i Textredigerare på Mac — Apple Support.