Webbplatskartor
Skapa automatiskt genererade webbplatskartfiler som du kan referera till från robots.txt. Detta underlättar för SEO och identifieringen av nytt innehåll. AEM kan generera tre typer av platskartor: utan någon konfiguration, baserat enbart på ett frågeindex eller på en manuell platskarta.
Skapa en platskarta utan någon konfiguration
Om du inte gör något ser du din webbplatskarta i sitemap.xml och har ett platskartindex i sitemap.json. Den innehåller en lista med alla dina publicerade dokument.
Om du började med en annan typ av platskarta och vill växla till den här typen måste du ta bort helix-sitemap.yaml konfigurationsfil - antingen manuellt definierad i GitHub eller automatiskt genererad - och indexera om platsen.
Domännamn som används i externa URL-adresser
Om du vill anpassa domänen som används för att skapa externa URL:er lägger du till en egenskap med namnet host eller cdn.prod.host i projektkonfigurationen (namngivna .helix/config när du använder Google Drive som backend eller .helix/config.xlsx på SharePoint) och förhandsgranska filen för att aktivera den.
Generera en platskarta baserad på ett index
Se dokumentet Indexering om du vill veta mer om indexering. Om du vill skapa en platskarta som baseras på ett index måste du se till att du redan har ställt in ett inledande frågeindex enligt vad som förklaras här. Då genereras en platskarta på platsen:
https://<branch>--<repo>--<owner>.hlx.page/sitemap.xml
Och en platskarta på följande plats:
https://<branch>--<repo>--<owner>.hlx.page/helix-sitemap.yaml
Vi rekommenderar att du skapar sitemap-index.xml fil som refererar till alla dina webbplatskartor och behåller den som en del av din projektkod i din github-repo. På så sätt är det enkelt att lägga till nya platskartor när projektet utökas.
Manuell konfiguration av platskartan
Om du behöver göra fler anpassningar än den genererade platskartekonfigurationsfilen kan du kopiera dess innehåll och klistra in det i en fil med namnet helix-sitemap.yaml i projektets rotmapp.
Obs! När du använder ett manuellt konfigurerat index och en platskarta (t.ex. kodrepo innehåller en Heilx-query.yaml- och Heilx-sitemap.yaml-fil) måste indexdefinitionen innehålla egenskapen robots för att säkerställa att platskartan utesluter sidor med robots: noindex metadata. När du använder autogenererade indexdefinitioner följer du bara rekommendationerna i indexeringsdokumentation så att dessa sidor utesluts från indexet.
Följande avsnitt innehåller de typer av platskartor som stöds.
Enkel platskarta
Följande är ett enkelt helix-sitemap.yaml. Det förutsätter att det finns ett enda index som innehåller alla sidor som behöver visas i platskartan.
sitemaps:
example:
source: /query-index.json
destination: /sitemap-en.xml
Om du vill att de senaste ändringsdatumen ska inkluderas i webbplatskartans URL-adresser lägger du till en lastmod -egenskap, inklusive ett format för din konfiguration.
sitemaps:
example:
source: /query-index.json
destination: /sitemap-en.xml
lastmod: YYYY-MM-DD
Flera webbplatskartor
Det är vanligt att det finns platskartor per avsnitt på webbplatserna och/eller per land eller språk. AEM har stöd för platskartor, inklusive motsvarande hreflang referenser. I följande exempel antar vi att det finns en mappning mellan indexen och platskartornas XML-filer.
sitemaps:
example:
languages:
en:
source: /en/query-index.json
destination: /sitemap-en.xml
hreflang: en
fr:
source: /fr/query-index.json
destination: /sitemap-fr.xml
hreflang: fr
alternate: /fr/{path}
Om det finns två sidor i det engelska och franska avsnittet som delar ett gemensamt suffix, kommer de att relateras, så t.ex. om du har en sida /welcome på engelska section and a page /fr/welcome i franska delen, den resulterande posten i /sitemap-en.xml kommer att se ut så här:
<url>
<loc>https://wwww.mysite.com/welcome</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://wwww.mysite.com/welcome"/>
<xhtml:link rel="alternate" hreflang="fr" href="https://wwww.mysite.com/fr/welcome"/>
</url>
En liknande post kommer att finnas i /sitemap-fr.xml.
Ange det primära språket manuellt
Det kan finnas situationer där du har alternativa versioner av en sida, men du inte kan använda ett gemensamt suffix för att identifiera dem, möjligen på grund av att du porterar en äldre webbplats som inte ska ha ändrat sökvägen. I så fall kan du ange en primary-language-url för den alternativa platsen, i dokumentets metadata.
Låt oss anta att vårt primära språk är engelska, vi har en sida /welcome på engelska och /fr/bienvenu i den franska delen, och den senare är en alternativ version av den första.
Först lägger vi till den informationen i dokumentet på /fr/bienvenu i sina metadata:
Detta kan också läggas till i en global metadata ark, som visas i Massmetadata.
Sedan lägger vi till en indexerad egenskap primary-language-url till det franska indexet:
primary-language-url:
select: head > meta[name="primary-language-url"]
value: attribute(el, "content")
Slutligen publicerar vi den franska sidan på nytt och återskapa platskartan.
Ange standardspråk
Ett annat vanligt krav är att ange standardspråk för en webbplatskarta med flera språk. Detta kan du göra genom att lägga till en egenskap default på webbplatskartan:
sitemaps:
example:
default: en
languages:
en:
source: /en/query-index.json
destination: /sitemap-en.xml
hreflang: en
fr:
source: /fr/query-index.json
destination: /sitemap-fr.xml
hreflang: fr
alternate: /fr/{path}
I den resulterande platskartan kommer alla poster från det engelska underträdet att ha en extra alternativ post med hreflang x-default.
Ange flera reflexer för ett underträd
Ibland måste du mappa flera reflexer till endast ett språkunderträd, d.v.s. vi vill att följande ska visas i den resulterande platskartan:
<url>
<loc>https://myhost/la/page</loc>
<xhtml:link rel="alternate" hreflang="es-VE" href="https://myhost/la/page"/>
<xhtml:link rel="alternate" hreflang="es-SV" href="https://myhost/la/page"/>
<xhtml:link rel="alternate" hreflang="es-PA" href="https://myhost/la/page"/>
</url>
Alla sidor i webbplatskartan ska visas exakt en gång, men ha flera alternativa reflektioner kopplade till sig. För att uppnå detta bör du ange en array med språk i hreflang egenskap:
sitemaps:
example:
languages:
la:
source: /la/query-index.json
destination: /sitemap-la.xml
hreflang:
- es-VE
- es-SV
- es-PA
Flera index aggregerade till en platskarta
Det finns fall där det är enklare att ha en enda större webbplatskarta än fragmenterade små platskartor, särskilt eftersom det finns en gräns för hur många webbplatskartor som kan skickas till sökmotorer per webbplats.
I följande exempel visas hur du sammanställer ett antal separata index till en enda platskarta.
sitemaps:
example:
languages:
dk:
source: /dk/query-index.json
destination: /sitemap.xml
hreflang: dk
alternate: /dk/{path}
no:
source: /no/query-index.json
destination: /sitemap.xml
hreflang: no
alternate: /no/{path}
Om du använder samma mål går det att kombinera flera små platskartor till en större platskarta.
Inkludera andra platskartor som indata
I ett blandat scenario, där inte alla språk i en platskarta hanteras i AEM, kan du inkludera platskartor från andra språkträd genom att ange en XML-sökväg som källa, som i:
sitemaps:
example:
languages:
en:
source: /en/query-index.json
destination: /sitemaps/sitemap-en.xml
hreflang: en
fr:
source: https://www.mysite.com/legacy/sitemap-fr.xml
destination: /sitemaps/sitemap-fr.xml
hreflang: fr
alternate: /fr/{path}
I det här exemplet använder vi en extern fransk platskarta för att beräkna alla platskartor. AEM kommer att fastställa alternativ för engelska webbplatskartor genom att dekonstruera de franska motsvarigheterna i den externa webbplatskartan med alternate definition.