Next.js / Setup

Étape 13 de 25

Installer et initialiser Altified

Exécutez un fichier d'initialisation depuis la racine de votre projet Next.js pour configurer la traduction automatique du serveur et le routage des paramètres régionaux.

Altified prend en charge Next.js 15 ou une version ultérieure avec React 18 ou une version ultérieure. L'application doit utiliser App Router. Installez le paquet avec le même gestionnaire de paquets que celui utilisé par votre projet.

pnpm
pnpm add @altified/next pnpm exec altified init
npm
npm install @altified/next npx altified init

L'initialiseur détecte JavaScript ou TypeScript et si le projet utilise un src/ annuaire.

  • Ajoute les paramètres serveur manquants à .env.local.
  • Crée le client serveur dans lib/altified.
  • Crée un fichier proxy.js ou proxy.ts pour le routage des paramètres régionaux.
  • Enveloppe la configuration Next existante avec withAltified pour une traduction JSX automatique.

L'initialiseur n'ajoute pas d'interface utilisateur visible et ne modifie pas votre disposition racine. Vous placez vous-même le sélecteur de langue à l'endroit précis où il doit être placé dans l'en-tête, la navigation ou tout autre composant.

Lisez le résultat de la commande. Une ligne « Conservé » indique qu'un fichier ou une valeur existante a été préservée. Un avertissement signifie que l'initialiseur n'a pas pu reconnaître en toute sécurité une configuration personnalisée ; suivez l'exemple manuel à l'étape suivante.

Lorsqu'une nouvelle copie n'est pas découverte

Next.js enregistre les sources de traduction automatique pendant la compilation de l'application. Si les textes ajoutés n'apparaissent pas, supprimez le texte généré. .next Accédez au répertoire et redémarrez ou reconstruisez l'application.
Développement
rm -rf .next pnpm dev
Production
rm -rf .next pnpm build pnpm start

Consultez la page contenant la nouvelle copie dans la langue par défaut et dans chaque langue cible configurée. Il n'est pas nécessaire d'exécuter pnpm install ou pnpm exec altified init encore.