Langues multilingues du site

ArtInStack peut publier votre site public dans plus d’une langue. Vous choisissez une langue principale (les URL par défaut, sans préfixe) et des locales supplémentaires facultatives. Les visiteurs changent de langue avec un Language Switcher dans votre en-tête ou pied de page. Les pages et articles disposent de contrôles Languages dédiés pour Generate, Preview et Publish. Les portfolios, produits et légendes photo suivent les mêmes locales publiées ; si une traduction manque, les visiteurs voient toujours le chrome dans la bonne langue et basculent en douceur vers le texte principal.

La publication de locales supplémentaires nécessite une offre avec les sites multilingues activés. La langue principale seule est disponible sans cette condition.

Prérequis

Tableau de bord → Settings → General → Site Languages

Offre : sites multilingues activés si vous avez besoin de plus que la locale principale

Tableau de bord → Settings → Integrations → Translation — requis avant Generate. Vous pouvez d’abord définir les locales et le sélecteur ; vous ne pouvez pas Generate les extras de page ou d’article sans clé API de fournisseur.

Étapes de mise en œuvre

1. Choisir la langue principale et les locales publiées

1. Ouvrez Settings → General.
2. Sous Site Languages, définissez Primary language (les nouvelles pages et la locale publique par défaut l’utilisent).
3. Sous Published locales, ajoutez chaque langue que vous voulez dans le sélecteur public. La principale est toujours incluse.
4. Enregistrez les paramètres.

Sans extras, le site reste monolingue sur des URL sans préfixe (par exemple /about). Avec des extras comme le français, les visiteurs peuvent ouvrir /fr/about, /fr/blog/…, /fr/portfolio/… et /fr/photo/….

2. Choisir un fournisseur de traduction

Ouvrez Settings → Integrations → Translation. Choisissez un fournisseur, collez votre clé API (ArtInStack la stocke chiffrée et ne la réaffiche jamais après l’enregistrement), puis enregistrez. Manual only ne suffit pas pour Generate — vous avez besoin de DeepL, Gemini ou OpenAI.

Fournisseur	Idéal pour	Comment obtenir une clé	Limites et notes
DeepL (recommandé lorsque disponible pour votre paire de langues)	Meilleure qualité pour de nombreuses langues européennes	Créez un compte API sur DeepL API et copiez la clé d’authentification	Les offres et quotas de caractères évoluent — consultez les plans API actuels de DeepL. Les allocations Developer nouvelles sont souvent un budget de caractères unique (couramment environ 1 million de caractères au total, pas mensuel) ; les offres Growth payantes ajoutent un volume récurrent. Confirmez les limites en direct dans votre console DeepL avant un Generate de site important.
Google Gemini	Coût faible ou nul pour commencer ; adapté aux brouillons que vous réviserez	Créez une clé API dans Google AI Studio	Utilise un modèle Gemini rapide et économique dans ArtInStack (pas les modèles « pro » les plus lourds). La qualité peut être inférieure à DeepL sur certaines paires — toujours Preview avant Publish. Les quotas Google du niveau gratuit s’appliquent ; voir les limites actuelles AI Studio / Gemini API de Google.
OpenAI	Vous avez déjà un compte OpenAI ; repli flexible	Créez une clé sur OpenAI API keys	Utilise un modèle de chat léger adapté au contenu du site. Facturé sur votre compte OpenAI ; définissez des limites d’usage dans leur tableau de bord.

Conseil pratique : Préférez DeepL pour Generate des pages et articles destinés au public lorsque vos locales sont prises en charge et que vous avez du quota. Utilisez Gemini pour essayer le multilingue à moindre coût ou lorsque DeepL ne convient pas. Gardez OpenAI comme alternative si vous facturez déjà là-bas. Après Generate, toujours Preview — le brouillon machine est un point de départ, pas une garantie de publication.

L’usage de caractères couvre Generate page/article et les remplissages automatiques d’entités (noms de portfolio, titres de produits, légendes et similaires) lorsque les extras sont publiés. Les grands sites consomment le quota plus vite — Generate d’abord les pages importantes.

3. Ajouter le Language Switcher

1. Ouvrez Settings → Header & Footer → Edit sur votre en-tête (ou pied de page) par défaut.
2. Depuis Header Elements ou Footer Elements, déposez Language Switcher.
3. Enregistrez le modèle.

Le sélecteur liste vos Published locales. Il reste masqué lorsqu’une seule locale est publiée. Détails : En-tête, pied de page et navigation.

4. Traduire une page (Generate → Preview → Publish)

1. Ouvrez Pages → Edit la page.
2. Continuez à modifier le texte principal sur le canevas Page Editor (le Publish principal publie toujours cette locale).
3. Ouvrez Page Settings → Languages.
4. Pour chaque locale supplémentaire : Generate un brouillon (fournisseur + clé déjà définis sous Integrations → Translation), Preview, puis Publish lorsque prêt.
5. Unpublish un extra si vous devez retirer cette locale hors ligne sans supprimer la principale.

Les corps de page supplémentaires non publiés renvoient 404 sur l’URL de cette locale (pas de corps anglais silencieux sous /fr/…). Le méta titre et la description basculent en douceur vers la principale lorsque les champs SEO de locale sont vides.

Même schéma sur Posts : ouvrez l’article → panneau Languages → Generate / Preview / Publish pour les extras (/blog/… principal, /{locale}/blog/… pour les extras).

5. Garder le reste du contenu synchronisé (bascule douce)

Rédigez portfolios, produits, catégories et légendes photo dans la langue principale. Lorsque les extras sont publiés et que les clés Translation sont configurées, les mises à jour peuvent remplir automatiquement les lignes de traduction. Tant qu’une ligne n’existe pas, les listes publiques et les pages photo affichent le texte principal avec le chrome de la locale du visiteur (mise en page, boutons, fil d’Ariane).

Vous n’avez pas besoin d’une liste de contrôle « tout traduire » avant de mettre en ligne avec des extras — publiez d’abord les pages et articles qui comptent, puis complétez le reste au fil du temps.

Ce que vous verrez

• Le sélecteur propose chaque locale publiée (endonymes).
• Les URL principales restent sans préfixe ; les extras utilisent /{locale}/….
• Les extras de page/article publiés rendent le HTML traduit ; les extras non publiés renvoient 404.
• Galeries, produits et photos conservent les chemins de locale ; les légendes manquantes basculent vers la principale.

Dépannage et pièges courants

Problème	À vérifier
Impossible d’ajouter des locales publiées	L’offre doit inclure les sites multilingues ; la principale seule fonctionne toujours
Pas de lignes Languages sur une page	Ajoutez des extras sous Settings → Site Languages, puis rouvrez Page Settings
Generate demande une clé API	Settings → Integrations → Translation — choisissez DeepL, Gemini ou OpenAI (pas Manual only) et collez une clé
Generate échoue ou s’arrête en milieu de site	Quota du fournisseur épuisé ou clé invalide — vérifiez la console du fournisseur ; les budgets DeepL Developer sont souvent des totaux uniques
Sélecteur absent sur le site en direct	Modèle enregistré avec Language Switcher ; plus d’une locale publiée ; republiez ou actualisez en force
Page /fr/… en 404	La locale française de cette page est Missing ou Draft — Publish sous Languages
Titre encore en principal sur une photo française	Bascule douce attendue jusqu’à ce qu’une traduction de légende existe ; le chrome doit quand même être en français

Vérifier votre configuration

• Site Languages affiche la langue principale et les locales publiées prévues.
• Integrations → Translation affiche un fournisseur machine avec une clé enregistrée.
• L’en-tête ou le pied de page inclut Language Switcher lorsque les extras sont actifs.
• Une page a une locale supplémentaire Live ; son URL /{locale}/… charge le corps traduit.
• Ouvrir la même page sans extra publié renvoie 404 (pas le HTML principal sous l’URL préfixée).

Documentation associée

• En-tête, pied de page et navigation — bloc Language Switcher
• Paramètres de page et remplacements — onglet Page Settings
• Prévisualiser et publier — flux de publication principal
• Paramètres SEO de page — champs méta (Generate remplit le SEO de locale depuis la principale)
• Publier et mettre à jour des articles de blog — articles et extras