TacoTranslate
/
ሰነዶችክፍያዎች
 
ማስተማሪያ
ሜይ 04 2025

በPages Router እየተጠቀመ ባለ የNext.js መተግበሪያ ዓለም አቀፋዊነትን እንዴት መተግበር እንደሚቻል

የReact መተግበሪያዎን ለብዙ ሰዎች ቀላል ያደርጉ፣ እና በአለምአቀፍ ቋንቋ (i18n) በመጠቀም ወደ አዲስ ገበያዎች ይደርሱ።

ዓለም እየአለላለጠ እየሆነ የሚገናኝ ሲሆን፣ ከተለያዩ ሀገራት እና ባህላት የመጡ ተጠቃሚዎችን ሊያገለግሉ የሚችሉ መተግበሪያዎችን ለመፍጠር ለድህረ ገፅ አብራሪዎች እየጨመረ አስፈላጊ ነው። ይህን ለማሳካት ከዋና መንገዶች አንዱ እንደሆነ ኢንተርናሽናላይዜሽን (internationalization, i18n) ይጠቀማል፣ ይህም መተግበሪያዎትን ወደ ተለያዩ ቋንቋዎች፣ የገንዘብ ስርዓቶች እና የቀን ቅርጾች ለማስተካከል ይፈቅዳል።

በዚህ መመሪያ እኛ እንዴት ኢንተርናሽናላይዜሽን (i18n)ን ወደ የReact Next.js መተግበሪያዎት እንጨምር እና በሰርቨር በኩል ማቅረብ (server side rendering) ጋር እንዴት እንደሚሰራ እንመለከታለን። 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 መተግበሪያ በይነገጽ ውስጥ ፕሮጀክት ይፍጠሩ፣ ከዚያም ወደ 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_LOCALE እና TACOTRANSLATE_ORIGIN.

  • TACOTRANSLATE_DEFAULT_LOCALE: ነባሪ የመመለሻ አካባቢ ኮድ። በዚህ ምሳሌ ለእንግሊዝኛ en እንዲሆን እናደርገዋለን።
  • TACOTRANSLATE_ORIGIN: የእርስዎ ድረ-ገጽ URL ያሉ የጽሑፍ ሕብረቁምፊዎችዎ የሚቀመጡበት “አቃፊ”። ስለ መነሻዎች እዚህ የበለጠ ያንብቡ።
.env
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

ደረጃ 3፦ TacoTranslateን ማዋቀር

TacoTranslate ကို သင့်အက်ပ်လီကေးရှင်းနှင့် ပေါင်းစည်းရန် ယခင်က ဖန်တီးထားသော API key များကို အသုံးပြု၍ client တစ်ခု ဖန်တီးရန် လိုအပ်ပါသည်။ ဥပမာအားဖြင့် /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 መተግበሪያውን ከድጋፍ ያላቸው ቋንቋዎች ዝርዝር ጋር ብቻ እንደተቀመጠ ነው። ቀጣይው የምናደርገው ለሁሉም ገጾችዎ ትርጉሞችን ማግኘት ነው። ለዚህ እርምጃ በፈለጉት መሠረት getTacoTranslateStaticProps ወይም getTacoTranslateServerSideProps ይጠቀሙ።

እነዚህ ፋንክሽኖች ሶስት አማራጮችን (arguments) ይወስዳሉ: አንዱ Next.js Static Props Context ኦቤግት፣ ሌላው ለTacoTranslate የቅኝት ቅኝታ እና አማራጭ Next.js ባህሪዎች። እዚህ ላይ revalidate በ getTacoTranslateStaticProps ላይ በነባር ወደ 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!"/>;
}

አሁን በሁሉም የReact ኮምፖነንቶችዎ ውስጥ ያሉ ጽሑፎችን ለመተርጎም Translate ኮምፖነንቱን መጠቀም መቻል አለብዎት።

import {Translate} from 'tacotranslate/react';

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

ደረጃ 5፦ ያሰማሩ እና ይፈትሹ!

ተጠናቋል! በTranslate ኮምፖነንት ውስጥ ማንኛውንም ሕብረቁምፊ ሲጨምሩ የእርስዎ React መተግበሪያ አሁን በራስ-ሰር ይተረጎማል። በAPI ቁልፉ ላይ read/write ፈቃድ ያላቸው አካባቢዎች ብቻ አዲስ የሚተረጎሙ ሕብረቁምፊዎችን መፍጠር እንደሚችሉ ያስታውሱ። ምርታማ መተግበሪያዎን እንደዚህ ባለ API ቁልፍ በመጠቀም ለመፈተሽ፣ እና ወደ ምርት ከመልቀቅዎ በፊት አዳዲስ ሕብረቁምፊዎችን ለመጨመር የተዘጋ እና የተጠበቀ የስቴጂንግ አካባቢ እንዲኖርዎት እንመክራለን። ይህም ማንም ሰው ሚስጥራዊ API ቁልፍዎን እንዳይሰርቅ እና አዳዲስ፣ ተዛማጅ ያልሆኑ ሕብረቁምፊዎችን በመጨመር የትርጉም ፕሮጀክትዎን እንዳያበዛው ይከላከላል።

እባክዎ በGitHub ፕሮፋይላችን ላይ ያለውን ፍጹም ምሳሌ እንዲመለከቱ ያረጋግጡ። እዚያ በApp Router እንዴት ይህን እንደሚያደርጉ የሚገልጽ ምሳሌ ደግሞ ያገኛሉ! ማንኛውንም ችግኝ ከተገናኙ እባክዎ ያናግሩን፣ እኛም ለመርዳት በጣም ደስ ይላንዎታል።

TacoTranslate የReact መተግበሪያዎችን በራስሰር ፈጣን ሁኔታ ወደ እና ከ 75 ቋንቋዎች በላይ ይለዋወጣል። ዛሬ ይጀምሩ!

ከ Nattskiftet የተሠራ ምርትበኖርዌይ የተሠራ