SEO

Xingluo est livré avec un support SEO complet : Open Graph, Twitter Card, canonical, données structurées JSON-LD, images OG dynamiques, RSS, sitemap et déclarations multilingues hreflang.

Sortie head

La balise <head> dans src/layouts/Layout.astro produit :

charset, viewport
favicon (public/favicon.svg)
canonical (lien canonique)
title, meta title, meta description, meta author
sitemap lien
Open Graph : og:type, og:site_name, og:title, og:description, og:url, og:image
Twitter Card : twitter:card, twitter:title, twitter:description, twitter:image
RSS lien alternatif
hreflang liens alternatifs (par langue + x-default)
theme-color (rempli à l’exécution par theme.ts)
google-site-verification (conditionnel)

Métadonnées de page d’article

src/layouts/PostLayout.astro injecte des méta spécifiques à l’article via <Fragment slot="head">:

og:type = article
article:published_time (ISO 8601)
article:modified_time (si modDatetime est défini)
**Données structurées JSON-LD BlogPosting :

json
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Post title",
  "image": "OG image URL",
  "datePublished": "2026-06-19T10:00:00.000Z",
  "dateModified": "2026-06-20T10:00:00.000Z",
  "author": [
    {
      "@type": "Person",
      "name": "Author name",
      "url": "Author homepage"
    }
  ]
}

Normalisation canonical

La stratégie canonical sur les pages de détail d’article (PostDetailView.astro) :

canonicalURL personnalisé dans le frontmatter → utilisé en premier
L’article actuel est une vraie traduction pour cette langue (locale correspond à la langue de la page) → pointe vers sa propre URL
L’article actuel est un contenu de secours (aucune traduction disponible, utilisation de l’original) → pointe vers l’URL originale dans la langue par défaut

La stratégie 3 garantit que les moteurs de recherche ne traitent pas les pages sans traductions indépendantes comme du contenu en double. Les articles avec des traductions indépendantes ont un canonical pointant vers eux-mêmes et peuvent être indexés séparément.

Données structurées BreadcrumbList

Toutes les pages avec fil d’Ariane (liste d’articles, index de tags, liste de tags, archives, à propos, recherche) produisent automatiquement des données structurées BreadcrumbList JSON-LD :

json
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Accueil",
      "item": "https://..."
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Articles",
      "item": "https://.../posts/"
    }
  ]
}

Lorsque le dernier élément du fil d’Ariane n’a pas de lien (page actuelle), l’URL de la page actuelle est utilisée comme item. Les pages de détail d’article n’utilisent pas le composant de fil d’Ariane et ne produisent donc pas ces données structurées.

Images Open Graph

Génération dynamique

Avec features.dynamicOgImage activé (par défaut), Xingluo génère dynamiquement des images OG 1200×630 avec satori + sharp :

Niveau site : src/pages/og.png.ts, pour les pages sans image OG personnalisée
Niveau article : src/pages/posts/[...slug]/og.png.ts, généré uniquement pour les articles sans ogImage

Polices

Les images OG utilisent Noto Sans SC (voir la config fonts dans astro.config.ts, variable CSS --font-og), chargée via fontData de astro:assets. La police est uniquement pour satori et n’est pas injectée dans le CSS du site.

Solutions de repli

Police indisponible (pas de réseau) → revient à un PNG d’espace réservé 1×1 (n’échoue pas la construction)
dynamicOgImage désactivé → utilise l’image OG statique par défaut sous public/

Résolution d’image OG d’article

Le repli à quatre niveaux dans PostDetailView.astro :

ogImage du frontmatter est une chaîne → utiliser directement
ogImage du frontmatter est un objet image() → utiliser .src
dynamicOgImage activé → utiliser le point de terminaison og.png au niveau article
Sinon → image OG statique par défaut du site

RSS

src/pages/rss.xml.ts génère le flux RSS :

Le titre, la description et l’URL du site proviennent de la configuration site
Les éléments proviennent de getSortedPosts (brouillons et articles programmés déjà filtrés)
Le link de chaque élément est getPostUrl(id, filePath, config.site.lang)
pubDate est modDatetime ?? pubDatetime

Layout.astro injecte le lien de autodécouverte RSS :

html
<link
  rel="alternate"
  type="application/rss+xml"
  title="..."
  href=".../rss.xml"
/>

Sitemap

L’intégration @astrojs/sitemap (voir astro.config.ts) :

filter : filtre les chemins des pages d’archives selon features.showArchives
i18n : active la génération automatique de hreflang, mappant zh-cn → zh-CN, en → en, avec defaultLocale zh-cn

Génère sitemap-index.xml et des déclarations alternatives par langue ; robots.txt référence le sitemap.

Déclarations multilingues hreflang

Layout.astro produit <link rel="alternate"> pour chaque langue :

html
<link rel="alternate" hreflang="zh-CN" href="https://.../posts/welcome/" />
<link rel="alternate" hreflang="en" href="https://.../en/posts/welcome/" />
<link rel="alternate" hreflang="x-default" href="https://.../posts/welcome/" />

Les chemins sont normalisés via parseLocaleFromPath(stripBase(...)) après suppression des préfixes, garantissant que chaque langue correspond à la bonne URL. x-default pointe vers la langue par défaut.

robots.txt

src/pages/robots.txt.ts génère :


User-agent: *
Allow: /

Sitemap: https://site-url/sitemap-index.xml

Vérification du site

La vérification Google Search Console est configurée via site.googleVerification de deux manières :

Variable d’environnement PUBLIC_GOOGLE_SITE_VERIFICATION (injection à l’exécution)
Le champ site.googleVerification dans xingluo.config.ts

Rendu sous la forme <meta name="google-site-verification" content="...">.