TacoTranslate
/
文档定价
 
教程
5月04日

如何在使用 Pages Router 的 Next.js 应用中实现国际化

通过国际化(i18n)使您的 React 应用更加易用,开拓新市场。

随着世界日益全球化,网页开发者构建能够满足来自不同国家和文化用户需求的应用程序变得越来越重要。实现这一目标的关键方法之一是国际化(i18n),它使您能够让应用程序适应不同的语言、货币和日期格式。

在本教程中,我们将探讨如何为您的 React Next.js 应用添加支持服务器端渲染的国际化功能。 TL;DR: 在这里查看完整示例。

本指南适用于使用 Pages Router 的 Next.js 应用。
如果您使用 App Router,请改为参阅此指南。

第 1 步: 安装一个 i18n 库

要在你的 Next.js 应用中实现国际化,我们首先会选择一个 i18n 库。有几个流行的库可供选择,包括 next-intl. 然而,在本例中,我们将使用 TacoTranslate.

TacoTranslate 使用尖端的 AI 自动将你的字符串翻译成任何语言,让你摆脱对 JSON 文件繁琐管理的麻烦。

让我们在终端中使用 npm 来安装它:

npm install tacotranslate

第 2 步: 创建一个免费的 TacoTranslate 账户

既然您已经安装了该模块,是时候创建您的 TacoTranslate 帐户、一个翻译项目以及相关的 API 密钥了。在此创建帐户。 这是免费的,且无需您添加信用卡。

在 TacoTranslate 应用程序 UI 中,创建一个项目,然后导航到其 API 密钥选项卡。创建一个 read 密钥和一个 read/write 密钥。我们将把它们保存为环境变量。read 密钥就是我们所说的 public,而 read/write 密钥是 secret。例如,您可以将它们添加到项目根目录下的 .env 文件中。

.env
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010

务必不要将秘密 read/write API 密钥泄露到客户端的生产环境中。

我们还将添加另外两个环境变量: TACOTRANSLATE_DEFAULT_LOCALETACOTRANSLATE_ORIGIN.

  • TACOTRANSLATE_DEFAULT_LOCALE: 默认的回退语言代码。在此示例中,我们将其设置为 en,代表英语。
  • TACOTRANSLATE_ORIGIN: 存放字符串的“文件夹”,例如您网站的 URL。 在此了解有关 origins 的更多信息。
.env
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

第3步:设置 TacoTranslate

要将 TacoTranslate 集成到您的应用程序中,您需要使用之前的 API 密钥创建一个客户端。例如,创建一个名为 /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;

我们将很快自动定义 TACOTRANSLATE_API_KEY

将客户端创建在单独的文件中可以让日后更容易复用。现在,使用自定义的 /pages/_app.tsx,我们将添加 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>
	);
}

如果你已经有自定义的 pageProps_app.tsx,请使用上面的属性和代码来扩展这些定义。

步骤 4: 实现服务器端渲染

TacoTranslate 允许对翻译进行服务器端渲染。这能显著提升用户体验,能够立即显示翻译后的内容,而不是先闪现未翻译的内容。此外,我们可以在客户端跳过网络请求,因为我们已经拥有所需的全部翻译。

我们将从创建或修改 /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'),
	});
};

修改 isProduction 检查以适合您的设置。如果 true,TacoTranslate 将显示公有 API 密钥。如果我们在本地、测试或暂存环境 (isProduction is false) 中,我们将使用密钥 read/write API 密钥来确保发送新字符串进行翻译。

到目前为止,我们仅为 Next.js 应用设置了支持语言的列表。接下来我们要为你所有的页面获取翻译。为此,你可以根据需求使用 getTacoTranslateStaticPropsgetTacoTranslateServerSideProps

这些函数接受三个参数:一个 Next.js Static Props Context 对象、TacoTranslate 的配置,以及可选的 Next.js 属性。注意, getTacoTranslateStaticProps 中的 revalidate 默认为 60,以确保你的翻译保持最新。

要在页面中使用任一函数,假设你有一个像 /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!"/>;
}

现在你应该可以使用 Translate 组件在你所有的 React 组件中翻译字符串。

import {Translate} from 'tacotranslate/react';

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

第5步: 部署并测试!

完成了!当您将任意字符串添加到 Translate 组件时,您的 React 应用现在将被自动翻译。请注意,只有在 API 密钥具有 read/write 权限的环境中,才可以创建要翻译的新字符串。我们建议设置一个封闭且受保护的预发布(staging)环境,在那里使用这样的 API 密钥测试您的生产应用,并在上线前添加新的字符串。这样可以防止任何人窃取您的秘密 API 密钥,并防止有人通过添加新的、不相关的字符串来膨胀您的翻译项目。

别忘了在我们的 GitHub 资料页 查看完整示例。在那里,您还会找到一个如何使用 App Router 来实现此操作的示例!如果您遇到任何问题,请随时 联系我们,我们将非常乐意提供帮助。

TacoTranslate 可自动将您的 React 应用快速在超过 75 种语言之间相互本地化。 立即开始!

来自 Nattskiftet 的产品挪威制造