TacoTranslate
/
SənədləşdirməQiymətlər
 
Təlimat
04 may 2025

Pages Router istifadə edən Next.js tətbiqində beynəlmiləlləşdirməni necə tətbiq etmək olar

React tətbiqinizi daha əlçatan edin və beynəlxalqlaşdırma (i18n) ilə yeni bazarlara çatın.

Dünyanın daha qloballaşması ilə veb inkişaf etdiricilər üçün müxtəlif ölkə və mədəniyyətlərdən olan istifadəçilərə uyğun tətbiqlər qurmaq getdikcə daha vacibdir. Bu məqsədə çatmağın əsas yollarından biri beynəlxalqlaşdırmadır (i18n), bu da tətbiqinizi müxtəlif dillərə, valyutalara və tarix formatlarına uyğunlaşdırmağa imkan verir.

Bu dərslikdə, server tərəfli render etmə ilə React Next.js tətbiqinizə beynəlxalqlaşdırmanı necə əlavə edəcəyimizi araşdıracağıq. TL;DR: Tam nümunəni burada görə bilərsiniz.

Bu təlimat Pages Router istifadə edən Next.js tətbiqləri üçündür.
Əgər App Router istifadə edirsinizsə, bunun əvəzinə bu təlimata baxın.

Addım 1: i18n kitabxanasını quraşdırın

Next.js tətbiqinizdə beynəlmiləlləşdirməni həyata keçirmək üçün əvvəlcə i18n kitabxanası seçəcəyik. next-intl daxil olmaqla bir neçə məşhur kitabxana mövcuddur. Lakin bu nümunədə TacoTranslate istifadə edəcəyik.

TacoTranslate ən müasir süni intellektdən istifadə edərək sətirlərinizi avtomatik olaraq istənilən dilə tərcümə edir və sizi JSON fayllarını yorucu şəkildə idarə etməkdən azad edir.

Gəlin onu terminalınızda npm istifadə edərək quraşdıraq:

npm install tacotranslate

Addım 2: Pulsuz TacoTranslate hesabı yaradın

Modulu quraşdırdığınıza görə, indi TacoTranslate hesabı, tərcümə layihəsi və müvafiq API açarları yaratmağın vaxtıdır. Buradan hesab yaradın. Bu pulsuzdur və kredit kartı əlavə etməyinizi tələb etmir.

TacoTranslate tətbiqinin interfeysində bir layihə yaradın və onun API açarları sekmesine keçin. Bir read açarı və bir read/write açarı yaradın. Onları mühit dəyişənləri kimi saxlayacağıq. read açarını public adlandırırıq, read/write açarı isə secret adlanır. Məsələn, onları layihənizin kök qovluğundakı .env faylına əlavə edə bilərsiniz.

.env
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010

Məxfi read/write API açarını müştəri tərəfdəki istehsal mühitlərinə heç vaxt sızdırmadığınızdan əmin olun.

Biz həmçinin daha iki mühit dəyişəni əlavə edəcəyik: TACOTRANSLATE_DEFAULT_LOCALE və TACOTRANSLATE_ORIGIN.

  • TACOTRANSLATE_DEFAULT_LOCALE: Standart ehtiyat dil kodu. Bu nümunədə onu ingilis dili üçün en olaraq təyin edəcəyik.
  • TACOTRANSLATE_ORIGIN: Sətirlərinizin saxlanacağı “qovluq”, məsələn, veb-saytınızın URL-i. Origin-lər haqqında ətraflı məlumatı burada oxuyun.
.env
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

3-cü addım: TacoTranslate-ın qurulması

TacoTranslate-i tətbiqinizə inteqrasiya etmək üçün əvvəldə əldə etdiyiniz API açarlarından istifadə edərək klient yaratmalısınız. Məsələn, /tacotranslate-client.js adlı fayl yaradın.

/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;

Tezliklə TACOTRANSLATE_API_KEY dəyişənini avtomatik olaraq təyin edəcəyik.

Klienti ayrıca faylda yaratmaq onu sonradan yenidən istifadə etməyi asanlaşdırır. İndi xüsusi /pages/_app.tsx faylından istifadə edərək, TacoTranslate provayderini əlavə edəcəyik.

/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>
	);
}

Əgər artıq xüsusi pageProps və _app.tsx istifadə edirsinizsə, zəhmət olmasa tərifi yuxarıdakı xüsusiyyətlər və kodla genişləndirin.

4-cü addım: Server tərəfli renderin tətbiqi

TacoTranslate tərcümələrinizin server tərəfində göstərilməsini təmin edir. Bu, tərcümə olunmamış məzmunun əvvəlcə qısa müddətə görünməsi əvəzinə, tərcümə edilmiş məzmunu dərhal göstərməklə istifadəçi təcrübəsini əhəmiyyətli dərəcədə yaxşılaşdırır. Bundan əlavə, ehtiyac duyduğumuz bütün tərcümələr artıq əlimizdə olduğundan, klient tərəfində şəbəkə sorğularını ötürə bilərik.

İlk olaraq /next.config.js faylını yaradacağıq və ya dəyişdirəcəyik.

/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'),
	});
};

Quraşdırmanıza uyğun olsun deyə isProduction yoxlamasını dəyişdirin. Əgər true, TacoTranslate ictimai API açarını göstərəcək. Əgər biz lokal, test və ya staging mühitindəyiksə (isProduction is false), yeni sətrlərin tərcümə üçün göndərildiyinə əmin olmaq üçün gizli read/write API açarından istifadə edəcəyik.

İndiyədək biz yalnız Next.js tətbiqini dəstəklənən dillərin siyahısı ilə qurmuşuq. Növbəti edəcəyimiz şey bütün səhifələriniz üçün tərcümələri əldə etməkdir. Bunu etmək üçün tələblərinizə əsasən ya getTacoTranslateStaticProps, ya da getTacoTranslateServerSideProps istifadə edəcəksiniz.

Bu funksiyalar üç arqument qəbul edir: biri Next.js Static Props Context obyekti, TacoTranslate üçün konfiqurasiya və istəyə bağlı Next.js xüsusiyyətləri. Qeyd edin ki, revalidate getTacoTranslateStaticProps funksiyasında varsayılan olaraq 60-a təyin edilib, beləliklə tərcümələriniz güncəllənmiş qalır.

Hər iki funksiyanı bir səhifədə istifadə etmək üçün, gəlin belə bir səhifə faylınız olduğunu fərz edək: /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!"/>;
}

Artıq bütün React komponentlərinizdəki sətirləri tərcümə etmək üçün Translate komponentindən istifadə edə bilməlisiniz.

import {Translate} from 'tacotranslate/react';

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

5-ci addım: Yerləşdirin və sınaqdan keçirin!

Hazırıq! İstənilən sətirləri Translate komponentinə əlavə etdikdə React tətbiqiniz artıq avtomatik tərcümə olunacaq. Nəzərə alın ki, yalnız API açarında read/write icazələri olan mühitlər tərcümə ediləcək yeni sətirlər yarada biləcək. Belə bir API açarı ilə istehsal tətbiqinizi sınaqdan keçirə biləcəyiniz qapalı və təhlükəsiz bir staging mühitindən istifadə etməyinizi tövsiyə edirik; bununla canlıya keçməzdən əvvəl yeni sətirlər əlavə edə bilərsiniz. Bu, hər hansı bir şəxsin məxfi API açarınızı oğurlamasının və potensial olaraq yeni, əlaqəsiz sətirlər əlavə etməklə tərcümə layihənizi lazımsız şəkildə böyütməsinin qarşısını alacaq.

Mütləq GitHub profilimizdəki tam nümunəyə baxın. Orada, həmçinin bunu App Router istifadə edərək necə edəcəyinizə dair bir nümunə də tapa bilərsiniz! Əgər hər hansı problemə rast gəlsəniz, bizə müraciət etməkdən çəkinməyin, biz məmnuniyyətlə kömək edəcəyik.

TacoTranslate React tətbiqlərinizi avtomatik olaraq 75-dən çox dilə və onlardan çevik şəkildə lokalizasiya etməyə imkan verir. İndi başlayın!

Nattskiftet-dən bir məhsulNorveçdə hazırlanmış