TacoTranslate
/
DocumentacióPreus
 
Tutorial
04 de maig

Com implementar la internacionalització en una aplicació Next.js que utilitza el Pages Router

Fes que la teva aplicació React sigui més accessible i arriba a nous mercats amb la internacionalització (i18n).

A mesura que el món es globalitza, és cada vegada més important que els desenvolupadors web creïn aplicacions que puguin atendre usuaris de diferents països i cultures. Una de les maneres clau d’aconseguir-ho és mitjançant la internacionalització (i18n), que et permet adaptar la teva aplicació a diferents idiomes, monedes i formats de data.

En aquest tutorial, explorarem com afegir la internacionalització a la teva aplicació React Next.js, amb renderització del costat servidor. TL;DR: Vegeu l’exemple complet aquí.

Aquesta guia és per a aplicacions Next.js que utilitzen el Pages Router.
Si estàs utilitzant el App Router, si us plau consulta aquesta guia en el seu lloc.

Pas 1: Instal·la una biblioteca i18n

Per implementar la internacionalització a la teva aplicació Next.js, primer triarem una biblioteca d’i18n. Hi ha diverses biblioteques populars, inclosa next-intl. Tanmateix, en aquest exemple, farem servir TacoTranslate.

TacoTranslate tradueix automàticament les teves cadenes a qualsevol idioma utilitzant IA d’última generació, i et lliura de la gestió tediosa dels fitxers JSON.

Instal·lem-ho usant npm al teu terminal:

npm install tacotranslate

Pas 2: Crea un compte gratuït a TacoTranslate

Ara que tens el mòdul instal·lat, és hora de crear el teu compte de TacoTranslate, un projecte de traducció i les claus API associades. Crea un compte aquí. És gratuït i no requereix que afegeixis una targeta de crèdit.

Dins de la interfície de l'aplicació TacoTranslate, crea un projecte i navega fins a la pestanya de les seves claus API. Crea una clau read i una altra read/write. Les guardarem com a variables d'entorn. La clau read és el que anomenem public i la clau read/write és secret. Per exemple, les podries afegir a un fitxer .env a l'arrel del teu projecte.

.env
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010

Assegura't de no filtrar mai la clau secreta read/write de l'API a entorns de producció del costat del client.

També afegirem dues variables d’entorn més: TACOTRANSLATE_DEFAULT_LOCALE i TACOTRANSLATE_ORIGIN.

  • TACOTRANSLATE_DEFAULT_LOCALE: El codi de localització predeterminat de reserva. En aquest exemple, el configurarem a en per a anglès.
  • TACOTRANSLATE_ORIGIN: La “carpeta” on es desaran les vostres cadenes, com ara l’URL del vostre lloc web. Llegiu més sobre els orígens aquí.
.env
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Pas 3: Configurar TacoTranslate

Per integrar TacoTranslate amb la teva aplicació, hauràs de crear un client utilitzant les claus API esmentades anteriorment. Per exemple, crea un fitxer anomenat /tacotranslate-client.js.

/tacotranslate-client.js
const {default: createTacoTranslateClient} = require('tacotranslate');

const tacoTranslate = createTacoTranslateClient({
	apiKey:
		process.env.TACOTRANSLATE_SECRET_API_KEY ??
		process.env.TACOTRANSLATE_PUBLIC_API_KEY ??
		process.env.TACOTRANSLATE_API_KEY ??
		'',
	projectLocale: process.env.TACOTRANSLATE_DEFAULT_LOCALE ?? '',
});

module.exports = tacoTranslate;

Definirem automàticament TACOTRANSLATE_API_KEY en breu.

Crear el client en un fitxer separat facilita la seva reutilització més endavant. Ara, utilitzant un /pages/_app.tsx personalitzat, afegirem el proveïdor TacoTranslate.

/pages/_app.tsx
import React from 'react';
import {type AppProps} from 'next/app';
import {type Origin, type Locale, type Localizations} from 'tacotranslate';
import TacoTranslate from 'tacotranslate/react';
import TacoTranslateHead from 'tacotranslate/next/head';
import tacoTranslate from '../tacotranslate-client';

type PageProperties = {
	origin: Origin;
	locale: Locale;
	locales: Locale[];
	localizations: Localizations;
};

export default function App({Component, pageProps}: AppProps<PageProperties>) {
	const {origin, locale, locales, localizations} = pageProps;

	return (
		<TacoTranslate
			client={tacoTranslate}
			origin={origin}
			locale={locale}
			localizations={localizations}
		>
			<TacoTranslateHead rootUrl="https://your-website.com" locales={locales} />
			<Component {...pageProps} />
		</TacoTranslate>
	);
}

Si ja tens pageProps i _app.tsx personalitzats, si us plau, amplia la definició amb les propietats i el codi indicats més amunt.

Pas 4: Implementació del renderitzat del costat del servidor

TacoTranslate permet el renderitzat del costat del servidor de les teves traduccions. Això millora molt l'experiència de l'usuari mostrant el contingut traduït immediatament, en comptes d'un destell de contingut no traduït primer. A més, podem evitar les peticions de xarxa al client perquè ja tenim totes les traduccions que necessitem.

Començarem creant o modificant /next.config.js.

/next.config.js
const withTacoTranslate = require('tacotranslate/next/config').default;
const tacoTranslateClient = require('./tacotranslate-client');

module.exports = async () => {
	const config = {};

	return withTacoTranslate(config, {
		client: tacoTranslateClient,
		isProduction:
			process.env.TACOTRANSLATE_ENV === 'production' ||
			process.env.VERCEL_ENV === 'production' ||
			(!(process.env.TACOTRANSLATE_ENV || process.env.VERCEL_ENV) &&
				process.env.NODE_ENV === 'production'),
	});
};

Modifica la comprovació de isProduction per adaptar-la a la teva configuració. Si true, TacoTranslate mostrarà la clau API pública. Si estem en un entorn local, de prova o d'assaig (isProduction is false), utilitzarem la clau API secreta read/write per assegurar-nos que les cadenes noves s'enviïn per a la traducció.

Fins ara, només hem configurat l'aplicació Next.js amb una llista d'idiomes compatibles. El següent que farem serà obtenir les traduccions de totes les pàgines. Per fer-ho, utilitzaràs o bé getTacoTranslateStaticProps o getTacoTranslateServerSideProps segons les teves necessitats.

Aquestes funcions accepten tres arguments: un objecte Next.js Static Props Context, la configuració per a TacoTranslate, i propietats opcionals de Next.js. Tingueu en compte que revalidate en getTacoTranslateStaticProps està establert per defecte a 60, de manera que les vostres traduccions es mantinguin actualitzades.

Per utilitzar qualsevol de les dues funcions en una pàgina, suposem que teniu un fitxer de pàgina com /pages/hello-world.tsx.

/pages/hello-world.tsx
import {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';

export async function getStaticProps(context) {
	return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}

export default function Page() {
	return <Translate string="Hello, world!"/>;
}

Ara ja hauries de poder utilitzar el component Translate per traduir cadenes a tots els teus components de React.

import {Translate} from 'tacotranslate/react';

function Component() {
	return <Translate string="Hello, world!"/>
}

Pas 5: Desplega i prova!

Ja hem acabat! La teva aplicació React ara es traduirà automàticament quan afegeixis qualsevol cadena a un component Translate. Tingues en compte que només els entorns amb permisos read/write sobre la clau API podran crear noves cadenes per traduir. Recomanem disposar d’un entorn de staging tancat i segur on puguis provar la teva aplicació de producció amb una clau API d’aquest tipus, afegint noves cadenes abans de passar-la a producció. Això impedirà que algú pugui robar la teva clau API secreta i, potencialment, inflar el teu projecte de traducció afegint cadenes noves i no relacionades.

Assegureu-vos de consultar l'exemple complet al nostre perfil de GitHub. Allà també trobareu un exemple de com fer-ho utilitzant el App Router ! Si teniu algun problema, no dubteu a contactar-nos, i estarem encantats d'ajudar-vos.

TacoTranslate us permet localitzar automàticament les vostres aplicacions React ràpidament a qualsevol idioma i des de qualsevol idioma. Comenceu avui mateix!

Un producte de NattskiftetFet a Noruega