Modes d'URL

Un site Chinaski multilingue peut présenter ses langues sous trois formes d'URL différentes. Le mode en vigueur est décidé par le réglage Language URL mode (Settings → Permalinks), et le plus souvent, il est décidé *pour* vous : le mode suit le nombre de langues que vous configurez. Cette page explique chaque mode et les règles qui l'entourent.

Les trois modes

Path: le code de langue est le premier segment de chemin : https://example.com/en/about, https://example.com/es/sobre. Chaque langue se construit dans son propre répertoire dans la sortie. C'est le mode par défaut pour les sites multilingues.
None: aucun code de langue nulle part dans l'URL. Le contenu vit juste sous la racine du domaine dans un unique arbre de sortie. C'est le mode des sites monolingues : un site monolingue l'utilise toujours.
Subdomain: la langue devient son propre sous-domaine : un post qui est https://en.example.com/blog/hello en anglais est https://es.example.com/blog/hola en espagnol. Les URL canoniques des pages, les alternatives hreflang, les entrées de sitemap et même les liens View de l'administration utilisent automatiquement l'hôte par langue.

Vous ne le définissez pas, en général ; il suit votre liste de langues

Le mode est dérivé, pas autonome. Lorsque vous changez vos langues actives, le mode est recalculé pour vous :

Plus d'une langue → path (sauf si vous avez explicitement choisi subdomain, qui est conservé).
Exactement une langue → none.

Une valeur périmée ne peut pas s'infiltrer : le réglage est normalisé à chaque changement de langues, à chaque enregistrement des permaliens, et une fois de plus au chargement de l'application. Cela protège contre un mode « path » périmé sur un site monolingue, qui servirait des 404. Si vous définissez subdomain pour votre site multilingue, il reste ainsi jusqu'à ce que vous le changiez. Il n'est jamais aplati en silence.

Vous n'avez rien à faire après avoir changé les langues : le mode s'ajuste à l'enregistrement, et l'enregistrement de l'onglet Permalinks déclenche toujours un rebuild pour que l'arbre de sortie corresponde.

Ce qui change sur votre serveur

Lorsque le mode est none, tout est servi depuis le répertoire racine de la sortie. Avec le mode path ou subdomain, la racine du serveur web déployé pointe vers le répertoire de la langue par défaut à la place (le code de la langue par défaut est intégré à la racine de documents du serveur web). Un déploiement standard synchronise cela automatiquement : les scripts de déploiement mettent à jour la configuration du site nginx vers la bonne racine et rechargent le service.

Si vous utilisez le mode subdomain avec votre propre reverse proxy, votre hébergement doit répondre à chaque <lang>.your-domain.com ; le builder génère les bonnes URL, mais votre proxy a besoin des règles d'hôte correspondantes.

Interactions avec d'autres réglages

Home redirect: avec du contenu multilingue, la racine du domaine peut rediriger vers le blog ou ailleurs ; réglez-le sur l'onglet Permalinks. Rebuild requis après modification.
Alternatives hreflang: les liens alternatifs par langue sont générés en modes path et subdomain lorsqu'une Site URL est configurée ; un site monolingue (none) n'a par définition pas d'alternatives.
URL canoniques: en mode subdomain, le canonique de chaque langue se situe sur son propre sous-domaine ; sinon tous les canoniques partagent le domaine unique que vous avez défini comme Site URL.