Vous m'avez trouvé sur Upwork ? Si vous m'avez trouvé via Upwork et souhaitez faire appel à mes services, merci de me contacter via Upwork. Les messages de clients Upwork envoyés en dehors d'Upwork ne recevront pas de réponse.
Notes de localisation🌏 Localisation

SvelteKit en vietnamien avec Paraglide JS : setup, hooks et ICU

Localisez SvelteKit en vietnamien avec Paraglide JS : scaffold automatique, locale vi, middleware hooks et messages ICU avec leur catégorie de pluriel unique.

Dao Huy (Lucas)7 min de lecture8 sections
SvelteKit en vietnamien avec Paraglide JS : setup, hooks et ICU

💡 Pour localiser une application SvelteKit en vietnamien avec Paraglide JS : lancez npx sv add paraglide, ajoutez vi dans le tableau languageTags de project.inlang/settings.json, configurez le middleware dans hooks.server.ts et importez les fonctions de messages typées. Le vietnamien n'a qu'une seule catégorie de pluriel ICU (other), ce qui simplifie les messages pluriels en une seule branche. Les chaînes vietnamiennes sont 10-20% plus longues que l'anglais.

À retenir

  • Lancez npx sv add paraglide pour créer la structure Paraglide JS + SvelteKit complète en une seule commande. La CLI crée project.inlang/settings.json, un dossier messages/ et connecte automatiquement le plugin Vite.
  • Ajoutez vi dans le tableau languageTags de project.inlang/settings.json. Créez messages/vi.json avec vos traductions vietnamiennes en utilisant les mêmes ID de messages que votre locale de base.
  • Le vietnamien n'a qu'une seule catégorie de pluriel CLDR : other. Tous les messages ICU pluriels se simplifient en une seule branche sans forme one distincte.
  • Utilisez paraglideMiddleware dans hooks.server.ts et le hook de reroutage deLocalizeUrl dans hooks.ts pour les URL préfixées et l'injection SSR correcte.
  • Les chaînes vietnamiennes sont 10-20% plus longues que l'anglais. Testez tous les libellés de boutons et éléments de navigation en viewports 375px et 390px. Les sous-ensembles de polices web doivent couvrir le bloc Unicode vietnamien complet (U+1EA0-U+1EF9).

Que nécessite vraiment la localisation SvelteKit en vietnamien ?

Localiser une application SvelteKit en vietnamien couvre quatre problèmes distincts : la gestion des messages, le routage par locale, le formatage des nombres et des dates, et les tests de mise en page. Ces problèmes sont indépendants, et vous pouvez les résoudre un par un sans que l'un bloque l'autre.

Paraglide JS gère la gestion des messages et le routage par locale. L'API JavaScript Intl gère le formatage avec la locale vi-VN. Les tests de mise en page sont une étape manuelle qui révèle les problèmes de polices et de longueur de chaînes propres au vietnamien.

Le rendu côté serveur de SvelteKit ajoute une exigence : la locale doit être détectée par requête sur le serveur et transmise au client. Le middleware de Paraglide gère cela via hooks.server.ts.

Pourquoi Paraglide JS est la bibliothèque i18n recommandée pour SvelteKit

Paraglide JS compile vos fichiers de messages en fonctions ESM typées au moment du build. Les bundlers modernes élaguent ensuite les fonctions de messages inutilisées, envoyant uniquement le code de la locale active au navigateur. Le résultat est des bundles plus légers comparés aux bibliothèques de dictionnaires en temps d'exécution.

SvelteKit a officiellement adopté Paraglide JS comme solution i18n recommandée via la CLI Svelte. Lancer npx sv add paraglide gère automatiquement toute la structure : le plugin Vite, le fichier de projet inlang, les hooks et un dossier de messages d'exemple.

Les bibliothèques alternatives fonctionnent toujours. Typesafe-i18n et svelte-i18n sont des options matures avec un support vietnamien. Mais pour les nouveaux projets SvelteKit, Paraglide est la recommandation officielle de l'équipe Svelte.

Comment configurer Paraglide JS pour le vietnamien dans SvelteKit ?

La configuration se fait en quatre étapes. Tous les fichiers doivent être édités avec un outil compatible UTF-8 pour préserver les diacritiques vietnamiens.

Étape 1 - Structure : Lancez la commande Svelte CLI pour créer la structure complète :

npx sv add paraglide

Cette commande génère project.inlang/settings.json, connecte le plugin Vite à vite.config.ts et crée messages/en.json comme fichier de locale de base.

Étape 2 - Ajouter la locale vietnamienne. Dans project.inlang/settings.json, ajoutez vi au tableau languageTags :

{ "languageTags": ["en", "vi"], "baseLocale": "en" }

Étape 3 - Créer messages/vi.json avec vos chaînes vietnamiennes. Utilisez les mêmes ID de messages que votre fichier de locale de base. Les diacritiques vietnamiens doivent être stockés en UTF-8 NFC :

{ "greeting": "Xin chào, {name}!", "items_in_cart": "{count} sản phẩm trong giỏ hàng", "checkout_button": "Thanh toán" }

Étape 4 - Ajouter le middleware dans src/hooks.server.ts et le hook de reroutage dans src/hooks.ts :

// hooks.server.ts
import type { Handle } from '@sveltejs/kit/hooks';
import { paraglideMiddleware } from '$lib/paraglide/server';
export const handle: Handle = ({ event, resolve }) =>
  paraglideMiddleware(event.request, ({ request: localizedRequest }) =>
    resolve({ ...event, request: localizedRequest }));

// hooks.ts
import type { Reroute } from '@sveltejs/kit/hooks';
import { deLocalizeUrl } from '$lib/paraglide/runtime';
export const reroute: Reroute = ({ url }) => deLocalizeUrl(url).pathname;

Formatage vietnamien : dates, nombres et devise

Paraglide gère quelle chaîne afficher. L'API JavaScript Intl gère la façon dont les nombres, les dates et la devise s'affichent. Utilisez le code de locale vi-VN pour les trois :

  • Dates : new Intl.DateTimeFormat('vi-VN', { dateStyle: 'short' }).format(date) retourne DD/MM/YYYY. Les utilisateurs vietnamiens s'attendent au jour en premier.
  • Nombres : new Intl.NumberFormat('vi-VN').format(1500000) retourne 1.500.000. Le point est le séparateur des milliers ; la virgule est le séparateur décimal, à l'inverse du français.
  • Devise (VND) : new Intl.NumberFormat('vi-VN', { style: 'currency', currency: 'VND' }).format(250000) retourne 250.000 ₫. Le VND n'a pas de subdivision décimale.
  • Tri : L'ordre alphabétique vietnamien diffère de l'ASCII. Utilisez new Intl.Collator('vi').compare pour toute liste triée côté client. L'alphabet vietnamien compte 29 lettres de base.

Quels problèmes de mise en page attendre avec les chaînes vietnamiennes ?

Les chaînes vietnamiennes sont typiquement 10-20% plus longues que leurs équivalents anglais dans les libellés UI et le texte de navigation. L'allongement vient des termes polysyllabiques et des particules grammaticales sans équivalent en anglais.

Vérifiez cette liste avant de lancer votre application SvelteKit vietnamienne :

  • Testez tous les textes de boutons et libellés de navigation aux largeurs de viewport 375px et 390px.
  • Vérifiez la couverture des polices : le vietnamien utilise des diacritiques combinatoires avec six marques de ton. Les sous-ensembles de polices web limités au latin de base peuvent manquer des glyphes vietnamiens. Ajoutez les plages Unicode : U+0102-0103, U+0110-0111, U+1EA0-1EF9.
  • Définissez lang="vi" sur l'élément <html> racine. Le template app.html de SvelteKit supporte un placeholder %lang% que Paraglide remplit au moment de la requête.
  • Appliquez overflow-wrap: break-word dans votre CSS de base. Le texte vietnamien se coupe aux espaces entre les mots-syllabes, mais les longs termes techniques peuvent déborder des conteneurs étroits.
  • Normalisez toutes les saisies en chaînes vietnamiennes vers NFC. Les diacritiques vietnamiens peuvent être encodés en NFC précomposé ou NFD décomposé, visuellement identiques mais échouant aux comparaisons de chaînes. Utilisez str.normalize('NFC') pour tout texte vietnamien saisi par l'utilisateur.

Traitement interne ou spécialiste : la vraie limite pour une application SvelteKit vietnamienne

Le travail technique, notamment la configuration de Paraglide, l'écriture des hooks et le câblage d'Intl, est entièrement réalisable en interne. N'importe quel développeur peut suivre le guide officiel Paraglide JS + SvelteKit et avoir la couche de routage opérationnelle en quelques heures. La traduction automatique gère les chaînes UI structurées comme les messages d'erreur, les libellés de champs et les textes d'aide avec une qualité acceptable pour la plupart des applications.

Là où un spécialiste vietnamien natif fait une réelle différence : le ton de l'interface produit, le texte marketing et la terminologie spécialisée. Le vietnamien distingue un registre formel (utilisé dans les applications professionnelles) d'un registre informel (utilisé dans les applications grand public), et un mauvais choix se perçoit immédiatement. Le vocabulaire sino-vietnamien transmet l'expertise dans les produits financiers, médicaux et juridiques, mais les moteurs de traduction automatique généralistes utilisent par défaut des équivalents vietnamiens purs que les spécialistes jugent imprécis.

La répartition pratique : utilisez la TA pour le contenu d'aide à longue traîne, et confiez à un réviseur humain les 50-100 chaînes UI qu'un utilisateur rencontre à chaque session. Pour les produits B2B où une équipe d'achat vietnamienne évaluera le produit, faites auditer l'interface complète par un locuteur natif avant le lancement.

Pour une localisation professionnelle de sites web et d'interfaces SaaS en vietnamien à partir du français, le service de localisation de site web en vietnamien sur ce site prend en charge la traduction et la révision technique.

FAQ

Le vietnamien nécessite-t-il une normalisation Unicode spéciale dans les fichiers de messages Paraglide ?

Oui. Les diacritiques vietnamiens peuvent être encodés en NFC précomposé (un seul point de code par caractère) ou en NFD décomposé (caractère de base plus marques combinatoires). Les deux ont le même rendu visuel dans le navigateur, mais les vérifications d'égalité de chaînes échouent. Stockez tout le contenu des fichiers de messages vietnamiens en NFC. En JavaScript : str.normalize('NFC').

Faut-il utiliser 'vi' ou 'vi-VN' comme code de locale dans Paraglide ?

Utilisez vi dans les languageTags de Paraglide et comme préfixe d'URL. Selon les recommandations W3C BCP 47, les balises de langue doivent être aussi courtes que possible. Pour l'API JavaScript Intl, vi-VN est plus explicite et garantit une recherche de données de formatage cohérente, mais vi fonctionne pour la plupart des opérations.

Comment Paraglide gère-t-il les messages pluriels vietnamiens ?

Le vietnamien n'a qu'une seule catégorie de pluriel CLDR : other. Tous les nombres correspondent à other car le vietnamien exprime la quantité via des classificateurs nominaux. La syntaxe ICU {count, plural, other {# sản phẩm}} couvre toutes les quantités. Les sélecteurs =0 et =1 restent disponibles pour les messages d'état vide spécifiques.

Comment fonctionnent les URL préfixées par locale avec Paraglide dans SvelteKit ?

Paraglide ajoute un préfixe de locale à toutes les URL : vos pages vietnamiennes sont servies sous /vi/votre-route. Le hook reroute dans hooks.ts supprime le préfixe de locale pour que le routeur basé sur les fichiers de SvelteKit voie le chemin non localisé. Le paraglideMiddleware dans hooks.server.ts détecte la locale depuis le préfixe URL et la définit pour la requête via AsyncLocalStorage.

Peut-on utiliser Paraglide JS avec l'adaptateur statique de SvelteKit pour un site entièrement statique ?

Oui. Paraglide JS fonctionne avec @sveltejs/adapter-static. Définissez strategy: ['url', 'baseLocale'] dans la configuration du plugin Vite Paraglide et prérendez toutes les variantes de locale. Ajoutez entries: ['/vi/', '/en/', '/zh/', '/fr/'] à votre configuration d'adaptateur statique pour que SvelteKit génère du HTML pour chaque locale. Les fonctions de messages compilées sont des ESM statiques et ne nécessitent aucun serveur en production.

Sources officielles

Dao Huy (Lucas)
Dao Huy (Lucas)
Diplômé de l'Université des langues étrangères, Université de Da Nang. Signe une attestation d'exactitude sur chaque traduction certifiée (USCIS, IRCC).

Écrit par Đào Huy (Lucas), traducteur vietnamien et spécialiste de la localisation (anglais, chinois et français vers le vietnamien). See translation services →

DevisWhatsApp