Posez votre question et obtenez un résumé du document en referencant cette page et le Provider AI de votre choix
Historique des versions
- "Mettre à jour l'utilisation de l'API useIntlayer de Solid pour un accès direct aux propriétés"v8.9.004/05/2026
- "Ajouter la commande init"v7.5.930/12/2025
- "Introduction de validatePrefix et ajout de l'étape 14 ; Gestion des pages 404 avec des routes localisées."v7.4.011/12/2025
- "Ajout de l'étape 13 ; Récupérer la locale dans vos server actions (Optionnel)"v7.3.905/12/2025
- "Ajout de l'étape 13 ; Adapter Nitro"v7.2.318/11/2025
- "Correction du préfixe par défaut en ajoutant la fonction getPrefix, useLocalizedNavigate, LocaleSwitcher et LocalizedLink."v7.1.017/11/2025
- "Mise à jour de la documentation"v6.5.203/10/2025
- "Ajouté pour Tanstack Start"v5.8.109/09/2025
Le contenu de cette page a été traduit à l'aide d'une IA.
Voir la dernière version du contenu original en anglaisSi vous avez une idée d’amélioration pour améliorer cette documentation, n’hésitez pas à contribuer en submitant une pull request sur GitHub.
Lien GitHub de la documentationCopier le Markdown du doc dans le presse-papiers
Traduisez votre site Tanstack Start avec Intlayer | Internationalisation (i18n)
Table des matières
Ce guide montre comment intégrer Intlayer pour une internationalisation transparente dans les projets Tanstack Start avec un routage tenant compte de la locale, un support TypeScript et des pratiques de développement modernes.
Qu'est-ce qu'Intlayer ?
Intlayer est une bibliothèque d'internationalisation (i18n) innovante et open-source conçue pour simplifier le support multilingue dans les applications web modernes.
Avec Intlayer, vous pouvez :
- Gérer facilement les traductions en utilisant des dictionnaires déclaratifs au niveau des composants.
- Localiser dynamiquement les métadonnées, les routes et le contenu.
- Assurer le support TypeScript avec des types autogénérés, améliorant l'autocomplétion et la détection d'erreurs.
- Bénéficier de fonctionnalités avancées, comme la détection et le changement dynamique de locale.
- Permettre un routage tenant compte de la locale avec le système de routage basé sur des fichiers de Tanstack Start.
Guide étape par étape pour configurer Intlayer dans une application Tanstack Start
Voir le Modèle d'Application sur GitHub.
Étape 1 : Créer le projet
Commencez par créer un nouveau projet TanStack Start en suivant le guide Démarrer un nouveau projet sur le site de TanStack Start.
Étape 2 : Installer les paquets Intlayer
Installez les paquets nécessaires en utilisant votre gestionnaire de paquets préféré :
Copier le code dans le presse-papiers
npm install intlayer react-intlayernpm install vite-intlayer --save-devnpx intlayer initintlayer
Le paquet principal qui fournit des outils d'internationalisation pour la gestion de la configuration, la traduction, la déclaration de contenu, la transpilation et les commandes CLI.
react-intlayer Le paquet qui intègre Intlayer avec l'application React. Il fournit des fournisseurs de contexte et des hooks pour l'internationalisation React.
vite-intlayer Comprend le plugin Vite pour intégrer Intlayer avec le bundler Vite, ainsi qu'un middleware pour détecter la locale préférée de l'utilisateur, gérer les cookies et gérer la redirection d'URL.
Étape 3 : Configuration de votre projet
Créez un fichier de configuration pour configurer les langues de votre application :
Copier le code dans le presse-papiers
import type { IntlayerConfig } from "intlayer";import { Locales } from "intlayer";const config: IntlayerConfig = { internationalization: { defaultLocale: Locales.ENGLISH, locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], },};export default config;Via ce fichier de configuration, vous pouvez configurer les URL localisées, la redirection du middleware, les noms des cookies, l'emplacement et l'extension de vos déclarations de contenu, désactiver les logs Intlayer dans la console, et plus encore. Pour une liste complète des paramètres disponibles, reportez-vous à la documentation de configuration.
Étape 4 : Intégrer Intlayer dans votre configuration Vite
Ajoutez le plugin intlayer dans votre configuration :
Copier le code dans le presse-papiers
import { tanstackStart } from "@tanstack/react-start/plugin/vite";import viteReact from "@vitejs/plugin-react";import { nitro } from "nitro/vite";import { defineConfig } from "vite";import { intlayer } from "vite-intlayer";const config = defineConfig({ plugins: [ nitro(), intlayer(), tanstackStart({ router: { routeFileIgnorePattern: ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$", }, }), viteReact(), ],});export default config;Le plugin Vite intlayer() est utilisé pour intégrer Intlayer avec Vite. Il assure la construction des fichiers de déclaration de contenu et les surveille en mode développement. Il définit les variables d'environnement Intlayer au sein de l'application Vite. De plus, il fournit des alias pour optimiser les performances.
Étape 5 : Créer le Layout Racine
Configurez votre layout racine pour supporter l'internationalisation en utilisant useParams pour détecter la locale actuelle et en définissant les attributs lang et dir sur la balise html.
Copier le code dans le presse-papiers
import { createRootRouteWithContext, HeadContent, Scripts,} from "@tanstack/react-router";import { defaultLocale, getHTMLTextDir } from "intlayer";import { type ReactNode } from "react";import { IntlayerProvider } from "react-intlayer";import { Route as LocaleRoute } from "./{-$locale}/route";export const Route = createRootRouteWithContext<{}>()({ head: () => ({ meta: [ { charSet: "utf-8", }, { content: "width=device-width, initial-scale=1", name: "viewport", }, { title: "TanStack Start Starter", }, ], }), shellComponent: RootDocument,});function RootDocument({ children }: { children: ReactNode }) { const params = LocaleRoute.useParams(); const locale = params?.locale ?? defaultLocale; return ( <html dir={getHTMLTextDir(locale)} lang={locale}> <head> <HeadContent /> </head> <body> <IntlayerProvider locale={locale}>{children}</IntlayerProvider> <Scripts /> </body> </html> );}Étape 6 : Créer le Layout de Locale
Créez un layout qui gère le préfixe de locale et effectue la validation.
Copier le code dans le presse-papiers
import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";import { validatePrefix } from "intlayer";export const Route = createFileRoute("/{-$locale}")({ beforeLoad: ({ params }) => { const localeParam = params.locale; // Valider le préfixe de locale const { isValid, localePrefix } = validatePrefix(localeParam); if (!isValid) { throw redirect({ to: "/{-$locale}/404", params: { locale: localePrefix }, }); } }, component: Outlet,});Ici,{-$locale}est un paramètre de route dynamique qui est remplacé par la locale actuelle. Cette notation rend le slot optionnel, lui permettant de fonctionner avec des modes de routage tels que'prefix-no-default', etc.
Soyez conscient que ce slot peut causer des problèmes si vous utilisez plusieurs segments dynamiques dans la même route (ex:
/{-$locale}/other-path/$anotherDynamicPath/...). Pour le mode'prefix-all', vous préférerez peut-être passer le slot en$localeà la place. Pour les modes'no-prefix'ou'search-params', vous pouvez supprimer complètement le slot.
Étape 7 : Déclarer votre contenu
Créez et gérez vos déclarations de contenu pour stocker les traductions :
Copier le code dans le presse-papiers
import type { Dictionary } from "intlayer";import { t } from "intlayer";const appContent = { content: { links: { about: t({ en: "About", es: "Acerca de", fr: "À propos", }), home: t({ en: "Home", es: "Inicio", fr: "Accueil", }), }, meta: { title: t({ en: "Welcome to Intlayer + TanStack Router", es: "Bienvenido a Intlayer + TanStack Router", fr: "Bienvenue à Intlayer + TanStack Router", }), description: t({ en: "This is an example of using Intlayer with TanStack Router", es: "Este es un ejemplo de uso de Intlayer con TanStack Router", fr: "Ceci est un exemple d'utilisation d'Intlayer avec TanStack Router", }), }, }, key: "app",} satisfies Dictionary;export default appContent;Vos déclarations de contenu peuvent être définies n'importe où dans votre application tant qu'elles sont incluses dans le répertoirecontentDir(par défaut,./app). Et correspondent à l'extension de fichier de déclaration de contenu (par défaut,.content.{json,ts,tsx,js,jsx,mjs,cjs}).
Pour plus de détails, reportez-vous à la documentation sur la déclaration de contenu.
Étape 7 : Créer des composants et hooks tenant compte de la locale
Créez un composant LocalizedLink pour une navigation tenant compte de la locale :
Copier le code dans le presse-papiers
import type { FC } from "react";import { Link, type LinkComponentProps } from "@tanstack/react-router";import { useLocale } from "react-intlayer";import { getPrefix } from "intlayer";export const LOCALE_ROUTE = "{-$locale}" as const;export type To = StripLocalePrefix<LinkComponentProps["to"]>;export type StripLocalePrefix<T extends string | undefined> = T extends | `/${typeof LOCALE_ROUTE}/` | `/${typeof LOCALE_ROUTE}` ? "/" : T extends `/${typeof LOCALE_ROUTE}/${infer Rest}` ? `/${Rest}` : T;type LocalizedLinkProps = { to?: To;} & Omit<LinkComponentProps, "to">;export const LocalizedLink: FC<LocalizedLinkProps> = (props) => { const { locale } = useLocale(); const { localePrefix } = getPrefix(locale); return ( <Link {...props} params={{ locale: localePrefix, ...(typeof props?.params === "object" ? props?.params : {}), }} to={`/${LOCALE_ROUTE}${props.to}` as LinkComponentProps["to"]} /> );};Ce composant a deux objectifs :
- Supprimer le préfixe inutile
{-$locale}de l'URL. - Injecter le paramètre de locale dans l'URL pour s'assurer que l'utilisateur est directement redirigé vers la route localisée.
Ensuite, nous pouvons créer un hook useLocalizedNavigate pour la navigation programmatique :
Copier le code dans le presse-papiers
import { useNavigate } from "@tanstack/react-router";import { getPrefix } from "intlayer";import { useLocale } from "react-intlayer";import type { StripLocalePrefix } from "@/components/localized-link";import type { FileRouteTypes } from "@/routeTree.gen";type NavigateFn = ReturnType<typeof useNavigate>;type BaseNavigateOptions = Parameters<NavigateFn>[0];type LocalizedTo = StripLocalePrefix<FileRouteTypes["to"]>;export type LocalizedNavigateOptions = Omit< BaseNavigateOptions, "to" | "params"> & { to: LocalizedTo; params?: Omit<NonNullable<BaseNavigateOptions["params"]>, "locale">;};type LocalizedNavigate = ( options: LocalizedNavigateOptions) => ReturnType<NavigateFn>;export const useLocalizedNavigate = () => { const navigate = useNavigate(); const { locale } = useLocale(); const localizedNavigate: LocalizedNavigate = (args: any) => { const { localePrefix } = getPrefix(locale); if (typeof args === "string") { return navigate({ to: `/${LOCALE_ROUTE}${args}`, params: { locale: localePrefix }, }); } const { to, ...rest } = args; const localizedTo = `/${LOCALE_ROUTE}${to}` as any; return navigate({ to: localizedTo, params: { locale: localePrefix, ...rest } as any, }); }; return localizedNavigate;};Étape 8 : Utiliser Intlayer dans vos pages
Accédez à vos dictionnaires de contenu dans toute votre application :
Page d'accueil localisée
Copier le code dans le presse-papiers
import { createFileRoute } from "@tanstack/react-router";import { getIntlayer } from "intlayer";import { useIntlayer } from "react-intlayer";import LocaleSwitcher from "@/components/locale-switcher";import { LocalizedLink } from "@/components/localized-link";import { useLocalizedNavigate } from "@/hooks/useLocalizedNavigate";export const Route = createFileRoute("/{-$locale}/")({ component: RouteComponent,});function RouteComponent() { const content = useIntlayer("app"); const navigate = useLocalizedNavigate(); return ( <div> <div> {content.title} <LocaleSwitcher /> <div> <LocalizedLink to="/">{content.links.home}</LocalizedLink> <LocalizedLink to="/about">{content.links.about}</LocalizedLink> </div> <div> <button onClick={() => navigate({ to: "/" })}> {content.links.home} </button> <button onClick={() => navigate({ to: "/about" })}> {content.links.about} </button> </div> </div> </div> );}Si vous souhaitez utiliser votre contenu dans un attribut de typestring, tel quealt,title,href,aria-label, etc., vous devez appeler la valeur de la fonction, comme ceci :
htmlCopier le codeCopier le code dans le presse-papiers
<img src="{content.image.src.value}" alt="{content.image.value}" /><img src="{content.image.src.toString()}" alt="{content.image.toString()}" /><img src="{String(content.image.src)}" alt="{String(content.image)}" />
Pour en savoir plus sur le hook useIntlayer, reportez-vous à la documentation.
Étape 9 : Créer un composant sélecteur de langue
Créez un composant pour permettre aux utilisateurs de changer de langue :
Copier le code dans le presse-papiers
import { useLocation } from "@tanstack/react-router";import { getHTMLTextDir, getLocaleName, getPathWithoutLocale, getPrefix, Locales,} from "intlayer";import type { FC } from "react";import { useLocale } from "react-intlayer";import { LocalizedLink, type To } from "./localized-link";export const LocaleSwitcher: FC = () => { const { pathname } = useLocation(); const { availableLocales, locale, setLocale } = useLocale(); const pathWithoutLocale = getPathWithoutLocale(pathname); return ( <ol> {availableLocales.map((localeEl) => ( <li key={localeEl}> <LocalizedLink aria-current={localeEl === locale ? "page" : undefined} onClick={() => setLocale(localeEl)} params={{ locale: getPrefix(localeEl).localePrefix }} to={pathWithoutLocale as To} > <span> {/* Locale - ex: FR */} {localeEl} </span> <span> {/* Langue dans sa propre locale - ex: Français */} {getLocaleName(localeEl, locale)} </span> <span dir={getHTMLTextDir(localeEl)} lang={localeEl}> {/* Langue dans la locale actuelle - ex: Francés avec la locale actuelle définie sur Locales.SPANISH */} {getLocaleName(localeEl)} </span> <span dir="ltr" lang={Locales.ENGLISH}> {/* Langue en anglais - ex: French */} {getLocaleName(localeEl, Locales.ENGLISH)} </span> </LocalizedLink> </li> ))} </ol> );};Pour en savoir plus sur le hook useLocale, reportez-vous à la documentation.
Étape 10 : Gestion des attributs HTML
Comme vu à l'étape 5, vous pouvez gérer les attributs lang et dir de la balise html en utilisant useParams dans votre composant racine. Cela garantit que les attributs corrects sont définis sur le serveur et le client.
Copier le code dans le presse-papiers
function RootDocument({ children }: { children: ReactNode }) { const params = LocaleRoute.useParams(); const locale = params?.locale ?? defaultLocale; return ( <html dir={getHTMLTextDir(locale)} lang={locale}> {/* ... */} </html> );}Étape 11 : Ajouter un middleware (Optionnel)
Vous pouvez également utiliser intlayerProxy pour ajouter un routage côté serveur à votre application. Ce plugin détectera automatiquement la locale actuelle en fonction de l'URL et définira le cookie de locale approprié. Si aucune locale n'est spécifiée, le plugin déterminera la locale la plus appropriée en fonction des préférences linguistiques du navigateur de l'utilisateur. Si aucune locale n'est détectée, il redirigera vers la locale par défaut.
Notez que pour utiliserintlayerProxyen production, vous devez déplacer le paquetvite-intlayerdedevDependenciesversdependencies.
Copier le code dans le presse-papiers
import { tanstackStart } from "@tanstack/react-start/plugin/vite";import viteReact from "@vitejs/plugin-react";import { nitro } from "nitro/vite";import { defineConfig } from "vite";import { intlayer, intlayerProxy } from "vite-intlayer";export default defineConfig({ plugins: [ intlayerProxy(), // Le proxy doit être placé avant le serveur si vous utilisez Nitro nitro(), intlayer(), tanstackStart({ router: { routeFileIgnorePattern: ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$", }, }), viteReact(), ],});Étape 12 : Internationaliser vos métadonnées (Optionnel)
Vous pouvez également utiliser le hook getIntlayer pour accéder à vos dictionnaires de contenu dans toute votre application :
Copier le code dans le presse-papiers
import { createFileRoute } from "@tanstack/react-router";import { getIntlayer } from "intlayer";export const Route = createFileRoute("/{-$locale}/")({ component: RouteComponent, head: ({ params }) => { const { locale } = params; const path = "/"; // The path for this route const metaContent = getIntlayer("app", locale); return { links: [ // Canonical link: Points to the current localized page { rel: "canonical", href: getLocalizedUrl(path, locale) }, // Hreflang: Tell Google about all localized versions ...localeMap(({ locale: mapLocale }) => ({ rel: "alternate", hrefLang: mapLocale, href: getLocalizedUrl(path, mapLocale), })), // x-default: For users in unmatched languages // Define the default fallback locale (usually your primary language) { rel: "alternate", hrefLang: "x-default", href: getLocalizedUrl(path, defaultLocale), }, ], meta: [ { title: metaContent.title }, { name: "description", content: metaContent.meta.description }, ], }; },});Étape 13 : Récupérer la locale dans vos server actions (Optionnel)
Vous pouvez vouloir accéder à la locale actuelle depuis l'intérieur de vos server actions ou de vos points de terminaison d'API.
Vous pouvez le faire en utilisant l'utilitaire getLocale d'Intlayer.
Voici un exemple utilisant les fonctions serveur de TanStack Start :
Copier le code dans le presse-papiers
import { createServerFn } from "@tanstack/react-start";import { getRequestHeader, getRequestHeaders,} from "@tanstack/react-start/server";import { getCookie, getIntlayer, getLocale } from "intlayer";export const getLocaleServer = createServerFn().handler(async () => { const locale = await getLocale({ // Récupérer le cookie de la requête (par défaut : 'INTLAYER_LOCALE') getCookie: (name) => { const cookieString = getRequestHeader("cookie"); return getCookie(name, cookieString); }, // Récupérer le header de la requête (par défaut : 'x-intlayer-locale') // Fallback utilisant la négociation Accept-Language getHeader: (name) => getRequestHeader(name), }); // Récupérer du contenu en utilisant getIntlayer() const content = getIntlayer("app", locale); return { locale, content };});Étape 14 : Gérer les pages non trouvées (Optionnel)
Lorsqu'un utilisateur visite une page inexistante, vous pouvez afficher une page 404 personnalisée et le préfixe de locale peut impacter la façon dont la page 404 est déclenchée.
Comprendre la gestion 404 de TanStack Router avec les préfixes de locale
Dans TanStack Router, la gestion des pages 404 avec des routes localisées nécessite une approche à plusieurs niveaux :
- Route 404 dédiée : Une route spécifique pour afficher l'UI 404
- Validation au niveau de la route : Valide les préfixes de locale et redirige les invalides vers 404
- Route fourre-tout (catch-all) : Capture tous les chemins non correspondants au sein du segment de locale
Copier le code dans le presse-papiers
import { createFileRoute } from "@tanstack/react-router";// Ceci crée une route dédiée /[locale]/404// Elle est utilisée à la fois comme route directe et importée comme composant dans d'autres fichiersexport const Route = createFileRoute("/{-$locale}/404")({ component: NotFoundComponent,});// Exporté séparément pour pouvoir être réutilisé dans notFoundComponent et les routes catch-allexport function NotFoundComponent() { return ( <div> <h1>404</h1> </div> );}Copier le code dans le presse-papiers
import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";import { validatePrefix } from "intlayer";import { NotFoundComponent } from "./404";export const Route = createFileRoute("/{-$locale}")({ // beforeLoad s'exécute avant que la route ne soit rendue (sur le serveur et le client) // C'est l'endroit idéal pour valider le préfixe de locale beforeLoad: ({ params }) => { const localeParam = params.locale; // validatePrefix vérifie si la locale est valide selon votre configuration intlayer const { isValid, localePrefix } = validatePrefix(localeParam); if (!isValid) { // Préfixe de locale invalide - rediriger vers la page 404 avec un préfixe de locale valide throw redirect({ to: "/{-$locale}/404", params: { locale: localePrefix }, }); } }, component: Outlet, // notFoundComponent est appelé lorsqu'une route enfant n'existe pas // ex: /en/page-inexistante déclenche cela au sein du layout /en notFoundComponent: NotFoundComponent,});Copier le code dans le presse-papiers
import { createFileRoute } from "@tanstack/react-router";import { NotFoundComponent } from "./404";// La route $ (splat/catch-all) correspond à tout chemin qui ne correspond pas aux autres routes// ex: /en/certains/chemins/tres/profonds/invalides// Cela garantit que TOUS les chemins non correspondants au sein d'une locale affichent la page 404// Sans cela, les chemins profonds non correspondants pourraient afficher une page vide ou une erreurexport const Route = createFileRoute("/{-$locale}/$")({ component: NotFoundComponent,});(Optionnel) Étape 15 : Extraer le contenu de vos composants
Si vous avez une base de code existante, transformer des milliers de fichiers peut prendre beaucoup de temps.
Pour faciliter ce processus, Intlayer propose un compilateur / extracteur pour transformer vos composants et extraire le contenu.
Pour le configurer, vous pouvez ajouter une section compiler dans votre fichier intlayer.config.ts :
Copier le code dans le presse-papiers
import { type IntlayerConfig } from "intlayer";
const config: IntlayerConfig = {
// ... Reste de votre configuration
compiler: {
/**
* Indique si le compilateur doit être activé.
*/
enabled: true,
/**
* Définit le chemin des fichiers de sortie
*/
output: ({ fileName, extension }) => `./${fileName}${extension}`,
/**
* Indique si les composants doivent être sauvegardés après avoir été transformés. De cette façon, le compilateur peut être exécuté une seule fois pour transformer l'application, puis il peut être supprimé.
*/
saveComponents: false,
/**
* Préfixe de clé de dictionnaire
*/
dictionaryKeyPrefix: "",
},
};
export default config;Exécutez l'extracteur pour transformer vos composants et extraire le contenu
Copier le code dans le presse-papiers
npx intlayer extractÉtape 16 : Générer un Sitemap (Optionnel)
Intlayer est livré avec un générateur de sitemap intégré pour vous aider à créer facilement un sitemap pour votre application. Il gère les routes localisées et ajoute les métadonnées nécessaires pour les moteurs de recherche.
Le sitemap généré par Intlayer prend en charge l'espace de nomsxhtml:link(Hreflang XML Extensions). Contrairement aux générateurs de sitemap par défaut qui ne répertorient que les URL brutes, Intlayer crée automatiquement les liens bidirectionnels requis entre toutes les versions linguistiques d'une page (par exemple,/about,/about?lang=fret/about?lang=es). Cela garantit que les moteurs de recherche indexent et servent correctement la bonne version linguistique au bon public.
Pour l'utiliser, vous devez d'abord configurer votre fichier vite.config.ts pour activer le pré-rendu de vos routes localisées et désactiver la génération de sitemap par défaut de TanStack Start.
Copier le code dans le presse-papiers
import { localeFlatMap } from "intlayer";// ... autres importsexport const pathList = ["", "/about", "/404"];const localizedPages = localeFlatMap(({ urlPrefix }) => pathList.map((path) => ({ path: `${urlPrefix}${path}`, prerender: { enabled: true, }, })));export default defineConfig({ plugins: [ // ... autres plugins tanstackStart({ // ... autres configurations sitemap: { enabled: false, }, prerender: { enabled: true, crawlLinks: false, concurrency: 10, }, pages: localizedPages, }), ],});Ensuite, créez une route src/routes/sitemap[.]xml.ts qui utilise la fonction generateSitemap :
Copier le code dans le presse-papiers
import { createFileRoute } from "@tanstack/react-router";import { generateSitemap } from "intlayer";const SITE_URL = ( import.meta.env.VITE_SITE_URL ?? "http://localhost:3000").replace(/\/$/, "");export const Route = createFileRoute("/sitemap.xml")({ server: { handlers: { GET: async () => { const sitemap = generateSitemap( [ { path: "/", changefreq: "daily", priority: 1.0 }, { path: "/about", changefreq: "monthly", priority: 0.8 }, ], { siteUrl: SITE_URL } ); return new Response(sitemap, { headers: { "Content-Type": "application/xml" }, }); }, }, },});Étape 17 : Configurer TypeScript (Optionnel)
Intlayer utilise l'augmentation de module pour bénéficier des avantages de TypeScript et rendre votre codebase plus robuste.
Assurez-vous que votre configuration TypeScript inclut les types autogénérés :
Copier le code dans le presse-papiers
{ // ... vos configurations existantes include: [ // ... vos includes existants ".intlayer/**/*.ts", // Inclure les types auto-générés ],}Configuration Git
Il est recommandé d'ignorer les fichiers générés par Intlayer. Cela vous permet d'éviter de les committer dans votre dépôt Git.
Pour ce faire, vous pouvez ajouter les instructions suivantes à votre fichier .gitignore :
Copier le code dans le presse-papiers
# Ignorer les fichiers générés par Intlayer.intlayerExtension VS Code
Pour améliorer votre expérience de développement avec Intlayer, vous pouvez installer l'extension officielle Intlayer VS Code Extension.
Installer depuis le VS Code Marketplace
Cette extension fournit :
- Autocomplétion pour les clés de traduction.
- Détection d'erreurs en temps réel pour les traductions manquantes.
- Aperçus en ligne du contenu traduit.
- Actions rapides pour créer et mettre à jour facilement les traductions.
Pour plus de détails sur l'utilisation de l'extension, reportez-vous à la documentation de l'extension Intlayer VS Code.
Aller plus loin
Pour aller plus loin, vous pouvez implémenter l'éditeur visuel ou externaliser votre contenu en utilisant le CMS.