Cách triển khai quốc tế hóa trong ứng dụng Next.js sử dụng Pages Router

Khi thế giới trở nên toàn cầu hóa hơn, việc các nhà phát triển web xây dựng các ứng dụng có thể phục vụ người dùng từ các quốc gia và văn hóa khác nhau trở nên ngày càng quan trọng. Một trong những cách chính để đạt được điều này là thông qua quốc tế hóa (i18n), cho phép bạn điều chỉnh ứng dụng của mình sang các ngôn ngữ, tiền tệ và định dạng ngày tháng khác nhau.

Trong hướng dẫn này, chúng ta sẽ khám phá cách thêm tính quốc tế hóa vào ứng dụng React Next.js của bạn, với việc kết xuất phía máy chủ. TL;DR: Xem ví dụ đầy đủ tại đây.

Hướng dẫn này dành cho các ứng dụng Next.js sử dụng Pages Router.
Nếu bạn đang sử dụng App Router, vui lòng xem hướng dẫn này.

Bước 1: Cài đặt một thư viện i18n

Để triển khai quốc tế hóa trong ứng dụng Next.js của bạn, trước tiên chúng ta sẽ chọn một thư viện i18n. Có một số thư viện phổ biến, bao gồm next-intl. Tuy nhiên, trong ví dụ này, chúng ta sẽ sử dụng TacoTranslate.

TacoTranslate tự động dịch các chuỗi của bạn sang bất kỳ ngôn ngữ nào bằng AI tiên tiến, và giúp bạn thoát khỏi việc quản lý tẻ nhạt các tập tin JSON.

Hãy cài đặt nó bằng cách sử dụng npm trong terminal của bạn:

npm install tacotranslate

Bước 2: Tạo tài khoản TacoTranslate miễn phí

Bây giờ bạn đã cài đặt module, đã đến lúc tạo tài khoản TacoTranslate của bạn, một dự án dịch thuật, và các khóa API liên quan. Tạo tài khoản tại đây. Nó miễn phí, và không yêu cầu bạn phải thêm thẻ tín dụng.

Trong giao diện ứng dụng TacoTranslate, tạo một dự án và chuyển đến tab khóa API của nó. Tạo một khóa read và một khóa read/write. Chúng ta sẽ lưu chúng dưới dạng biến môi trường. Khóa read là khóa mà chúng ta gọi là public và khóa read/write là secret. Ví dụ, bạn có thể thêm chúng vào tệp .env ở thư mục gốc của dự án.

TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010

Hãy chắc chắn rằng không bao giờ để lộ khóa API bí mật read/write ra môi trường sản xuất phía client.

Chúng tôi cũng sẽ thêm hai biến môi trường nữa: TACOTRANSLATE_DEFAULT_LOCALE và TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Mã ngôn ngữ dự phòng mặc định. Trong ví dụ này, chúng tôi sẽ đặt nó là en cho tiếng Anh.
• TACOTRANSLATE_ORIGIN: “Thư mục” nơi các chuỗi của bạn sẽ được lưu trữ, chẳng hạn như URL của trang web của bạn. Đọc thêm về origins tại đây.

TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Bước 3: Thiết lập TacoTranslate

To integrate TacoTranslate with your application, you’ll need to create a client using the API keys from earlier. For example, create a file named /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;

Chúng tôi sẽ tự động định nghĩa TACOTRANSLATE_API_KEY trong thời gian ngắn.

Tạo client trong một file riêng sẽ giúp bạn dễ dàng sử dụng lại sau này hơn. Bây giờ, sử dụng một /pages/_app.tsx tùy chỉnh, chúng ta sẽ thêm nhà cung cấp 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>
	);
}

Nếu bạn đã có pageProps và _app.tsx tùy chỉnh, vui lòng mở rộng định nghĩa bằng các thuộc tính và mã từ trên.

Bước 4: Triển khai kết xuất phía máy chủ

TacoTranslate cho phép kết xuất phía máy chủ đối với các bản dịch của bạn. Điều này cải thiện đáng kể trải nghiệm người dùng bằng cách hiển thị nội dung đã được dịch ngay lập tức, thay vì trước tiên là một khoảnh khắc nội dung chưa được dịch. Ngoài ra, chúng ta có thể bỏ qua các yêu cầu mạng trên phía client, vì chúng ta đã có tất cả các bản dịch cần thiết.

Chúng ta sẽ bắt đầu bằng cách tạo mới hoặc chỉnh sửa /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'),
	});
};

Chỉnh sửa kiểm tra isProduction sao cho phù hợp với thiết lập của bạn. Nếu true, TacoTranslate sẽ hiển thị khóa API công khai. Nếu chúng ta đang ở môi trường local, test, hoặc staging (isProduction is false), chúng ta sẽ sử dụng khóa API bí mật read/write để đảm bảo các chuỗi mới được gửi để dịch.

Cho đến nay, chúng tôi chỉ thiết lập ứng dụng Next.js với danh sách các ngôn ngữ được hỗ trợ. Điều tiếp theo chúng ta sẽ làm là tìm nạp bản dịch cho tất cả các trang của bạn. Để làm điều đó, bạn sẽ sử dụng getTacoTranslateStaticProps hoặc getTacoTranslateServerSideProps dựa trên yêu cầu của mình.

Các hàm này có ba đối số: Một đối tượng Next.js Static Props Context , cấu hình cho TacoTranslate và thuộc tính Next.js tùy chọn. Lưu ý rằng revalidate trên getTacoTranslateStaticProps được đặt thành 60 theo mặc định để bản dịch của bạn luôn được cập nhật.

Để sử dụng một trong hai hàm trong một trang, giả sử bạn có một tệp trang như /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!"/>;
}

Bây giờ bạn nên có thể sử dụng thành phần Translate để dịch các chuỗi trong tất cả các thành phần React của bạn.

import {Translate} from 'tacotranslate/react';

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

Bước 5: Triển khai và kiểm tra!

Chúng ta đã hoàn thành! Ứng dụng React của bạn sẽ tự động được dịch khi bạn thêm bất kỳ chuỗi nào vào thành phần Translate. Lưu ý rằng chỉ các môi trường có quyền read/write trên khóa API mới có thể tạo các chuỗi mới để dịch. Chúng tôi khuyên bạn nên có một môi trường staging đóng và bảo mật, nơi bạn có thể kiểm tra ứng dụng sản xuất của mình với một khóa API như vậy, thêm các chuỗi mới trước khi đưa vào hoạt động. Điều này sẽ ngăn chặn bất kỳ ai đánh cắp khóa API bí mật của bạn, và có thể làm phình to dự án dịch thuật của bạn bằng cách thêm các chuỗi mới không liên quan.

Hãy chắc chắn xem ví dụ đầy đủ trên hồ sơ GitHub của chúng tôi. Ở đó, bạn cũng sẽ tìm thấy một ví dụ về cách làm điều này sử dụng App Router ! Nếu bạn gặp bất kỳ vấn đề nào, hãy thoải mái liên hệ, và chúng tôi sẽ rất vui được giúp đỡ bạn.

TacoTranslate cho phép bạn tự động bản địa hóa các ứng dụng React của mình một cách nhanh chóng sang và từ bất kỳ ngôn ngữ nào. Bắt đầu ngay hôm nay!