A melhor solução para internacionalização (i18n) em aplicações Next.js
Está à procura de expandir a sua aplicação Next.js para novos mercados? O TacoTranslate torna incrivelmente fácil localizar o seu projeto Next.js, permitindo-lhe alcançar um público global sem complicações.
Porque escolher o TacoTranslate para Next.js?
- Integração sem falhas: Projetado especificamente para aplicações Next.js, o TacoTranslate integra-se facilmente no seu fluxo de trabalho existente.
- Recolha automática de strings: Não precisa mais de gerir ficheiros JSON manualmente. O TacoTranslate recolhe automaticamente as strings do seu código.
- Traduções impulsionadas por IA: Aproveite o poder da IA para fornecer traduções contextualmente precisas que se ajustam ao tom da sua aplicação.
- Suporte instantâneo a idiomas: Adicione suporte a novas línguas com apenas um clique, tornando a sua aplicação acessível globalmente.
Como funciona
À medida que o mundo se torna mais globalizado, é cada vez mais importante para os desenvolvedores web criarem aplicações que possam atender a utilizadores de diferentes países e culturas. Uma das formas principais de conseguir isso é através da internacionalização (i18n), que permite adaptar a sua aplicação a diferentes idiomas, moedas e formatos de data.
Neste tutorial, vamos explorar como adicionar internacionalização à sua aplicação React Next.js, com renderização do lado do servidor. TL;DR: Veja o exemplo completo aqui.
Este guia destina-se a aplicações Next.js que utilizam o Pages Router.
Se estiver a usar o App Router, consulte este guia em vez disso.
Passo 1: Instale uma biblioteca i18n
Para implementar a internacionalização na sua aplicação Next.js, vamos primeiro escolher uma biblioteca i18n. Existem várias bibliotecas populares, incluindo next-intl. No entanto, neste exemplo, usaremos TacoTranslate.
O TacoTranslate traduz automaticamente as suas strings para qualquer idioma utilizando IA avançada, e liberta-o da gestão tediosa de ficheiros JSON.
Vamos instalá-lo usando npm no seu terminal:
npm install tacotranslate
Passo 2: Crie uma conta gratuita no TacoTranslate
Agora que já instalou o módulo, é hora de criar a sua conta TacoTranslate, um projeto de tradução e as respetivas chaves API. Crie uma conta aqui. É gratuito e não é necessário adicionar um cartão de crédito.
Dentro da interface da aplicação TacoTranslate, crie um projeto e navegue até ao separador de chaves API. Crie uma chave read
e uma chave read/write
. Guardaremos estas como variáveis de ambiente. A chave read
é o que chamamos de public
e a chave read/write
é secret
. Por exemplo, pode adicioná-las a um ficheiro .env
na raiz do seu projeto.
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
Certifique-se de nunca divulgar a chave API secreta read/write
para ambientes de produção do lado do cliente.
Também adicionaremos mais duas variáveis de ambiente: TACOTRANSLATE_DEFAULT_LOCALE
e TACOTRANSLATE_ORIGIN
.
TACOTRANSLATE_DEFAULT_LOCALE
: O código da localidade padrão para fallback. Neste exemplo, vamos definir comoen
para inglês.TACOTRANSLATE_ORIGIN
: A “pasta” onde as suas strings serão armazenadas, como a URL do seu website. Leia mais sobre origens aqui.
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com
Passo 3: Configurar o TacoTranslate
Para integrar o TacoTranslate com a sua aplicação, será necessário criar um cliente utilizando as chaves API mencionadas anteriormente. Por exemplo, crie um ficheiro chamado /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;
Vamos definir automaticamente TACOTRANSLATE_API_KEY
em breve.
Criar o cliente num ficheiro separado torna-o mais fácil de reutilizar mais tarde. Agora, usando um /pages/_app.tsx
personalizado, vamos adicionar o fornecedor TacoTranslate
.
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>
);
}
Se já tem pageProps
e _app.tsx
personalizados, por favor, estenda a definição com as propriedades e o código mencionados acima.
Passo 4: Implementação da renderização do lado do servidor
O TacoTranslate permite a renderização do lado do servidor das suas traduções. Isto melhora significativamente a experiência do utilizador ao mostrar o conteúdo traduzido imediatamente, em vez de um breve conteúdo não traduzido primeiro. Além disso, podemos evitar pedidos de rede no cliente, porque já temos todas as traduções de que precisamos.
Vamos começar por criar ou modificar /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'),
});
};
Modifique a verificação de isProduction
para se adequar à sua configuração. Se true
, o TacoTranslate exibirá a chave de API pública. Se estivermos em um ambiente local, de teste ou de preparo (isProduction
is false
), usaremos a chave secreta read/write
API para garantir que novas cadeias de caracteres sejam enviadas para tradução.
Até agora, só configurámos a aplicação Next.js com uma lista de idiomas suportados. O próximo passo será obter as traduções para todas as suas páginas. Para isso, deverá usar ou getTacoTranslateStaticProps
ou getTacoTranslateServerSideProps
conforme as suas necessidades.
Estas funções recebem três argumentos: um objeto Next.js Static Props Context, configuração para o TacoTranslate, e propriedades opcionais do Next.js. Note que o revalidate
em getTacoTranslateStaticProps
está definido como 60 por padrão, para que as suas traduções se mantenham atualizadas.
Para usar qualquer uma das funções numa página, vamos assumir que tem um ficheiro de página como /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!"/>;
}
Agora deverá conseguir usar o componente Translate
para traduzir strings em todos os seus componentes React.
import {Translate} from 'tacotranslate/react';
function Component() {
return <Translate string="Hello, world!"/>
}
Passo 5: Publicar e testar!
Terminámos! A sua aplicação Next.js será agora traduzida automaticamente quando adicionar quaisquer strings a um componente Translate
. Note que apenas ambientes com permissões read/write
na chave API poderão criar novas strings para traduzir. Recomendamos ter um ambiente de staging fechado e seguro onde possa testar a sua aplicação de produção com uma chave API deste tipo, adicionando novas strings antes de publicar. Isto evitará que alguém roube a sua chave API secreta e potencialmente sobrecarregue o seu projeto de tradução ao adicionar novas strings não relacionadas.
Be sure to check out the complete example over at our GitHub profile. There, you’ll also find an example of how to do this using the App Router! If you encounter any problems, feel free to reach out, and we’ll be more than happy to help.
TacoTranslate lets you automatically localize your React applications quickly to and from over 75 languages. Get started today!