مستندات: پرمختللې کارونې

پرمختللې کارونې

Pashto

د ښي څخه کیڼ ژبو اداره کول

TacoTranslate ستاسو په React غوښتنلیکونو کې د هغو ژبو (RTL) لکه عربي او عبري ملاتړ اسانه کوي. د RTL ژبو سمه اداره ډاډمن کوي چې ستاسو منځپانګه د هغو کاروونکو لپاره چې له ښي څخه کيڼ ته لوستل کوي په سمه توګه ښودل کېږي.

import {useTacoTranslate} from 'tacotranslate/react';

function Document() {
	const {locale, isRightToLeft} = useTacoTranslate();

	return (
		<html lang={locale} dir={isRightToLeft ? 'rtl' : 'ltr'}>
			<body>
				// ...
			</body>
		</html>
	);
}

تاسو کولی شئ همدارنګه ورکړل شوې isRightToLeftLocaleCode تابع د React څخه بهر د اوسنۍ ژبې د معلومولو لپاره وکاروئ.

import {isRightToLeftLocaleCode} from 'tacotranslate';

function foo(locale = 'es') {
	const direction = isRightToLeftLocaleCode(locale) ? 'rtl' : 'ltr';
	// ...
}

د ژباړې غیر فعالول

د یو متن د ځانګړو برخو د ژباړې د غیرفعالولو لپاره، یا د دې لپاره چې ځینې برخې هماغسې وساتل شي، تاسو کولی شئ درې ګونې مربع بریکټونه وکاروئ. دا ځانګړتیا د نومونو، تخنیکي اصطلاحاتو، یا هر هغه محتوا د اصلي بڼې د ساتلو لپاره ګټوره ده چې باید ژباړه نشي.

import {Translate} from 'tacotranslate/react';

function Component() {
	return (
		<Translate string="Hello, [[[TacoTranslate]]]!" />
	);
}

په دې مثال کې، د “TacoTranslate” ټکی به په ژباړه کې بدل نشي.

د TacoTranslate څو چمتوونکي

موږ په کلکه سپارښتنه کوو چې په خپل اپلیکیشن کې څو TacoTranslate چمتوونکي وکاروئ. دا د خپلو ژباړو او متنونو په بېلابېلو مآخذونو کې د تنظیم لپاره ګټور دی، لکه ستاسو د سرلیک، فوټر، یا ځانګړو برخو لپاره.

تاسو کولی شئ دلته د اوریجنونو د کارولو په اړه نور معلومات ترلاسه کړئ.

TacoTranslate چمتو کوونکي د هر والد چمتو کوونکي تنظیمات ترلاسه کوي، نو تاسو اړتیا نلرئ چې نور تنظیمات تکرار کړئ.

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Header() {
	return (
		<TacoTranslate origin="header">
			// ...
		</TacoTranslate>
	);
}

function Menu() {
	return (
		<TacoTranslate origin="menu">
			// ...
		</TacoTranslate>
	);
}

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Header />
			<Menu />
		</TacoTranslate>
	);
}

د اصلي سرچینې یا محلي ترتیب بدلول

د څو TacoTranslate چمتوونکو د کارولو ترڅنګ، تاسو کولی شئ په Translate کمپونینټ او useTranslation هوک کچو کې هم د ماخذ (origin) او محلي ژبې (locale) ارزښتونه بدل کړئ.

import {Translate, useTranslation} from 'tacotranslate/react';

function Greeting() {
	const spanishHello = useTranslation('Hello!', {locale: 'es'});

	return (
		<>
			{spanishHello}
			<Translate string="What’s up?" origin="greeting" />
		</>
	);
}

د لوډ کولو مدیریت

کله چې په کلاینت اړخ کې ژبه بدلیږي، د ژباړو ترلاسه کول کېدای شي د کارونکي د اړیکې په اساس څو شېبې ونیسي. تاسو کولی شئ د بدلولو پر مهال د لیدیز غبرګون لپاره یو لوډینګ (بار کولو) ښودونکی وښایئ ترڅو د کارونکي تجربه ښه کړئ.

import {useTacoTranslate} from 'tacotranslate/react';

function Component() {
	const {isLoading} = useTacoTranslate();

	return (
		isLoading ? 'Translations are loading...' : null
	);
}

جمع جوړول

د مختلفو ژبو لپاره د جمع ښودنې او د شمېر پر بنسټ د لیبلونو د سمو څرګندولو لپاره، دا غوره عمل ګڼل کېږي:

import {Translate, useLocale} from 'tacotranslate/react';

function PhotoCount() {
	const locale = useLocale();
	const count = 1;

	return count === 0 ? (
		<Translate string="You have no photos." />
	) : count === 1 ? (
		<Translate string="You have 1 photo." />
	) : (
		<Translate
			string="You have {{count}} photos."
			variables={{count: count.toLocaleString(locale)}}
		/>
	);
}

څو ژبې

د یو اپلیکیشن په یو وخت کې د څو ژبو ملاتړ لپاره، تاسو کولی شئ د څو TacoTranslate چمتوونکي وکاروئ د مختلفو locale ارزښتونو سره لکه لاندې ښودل شوي:

تاسو کولی شئ همدارنګه locale د کمپونینټ یا هوک په کچه بدل کړئ.

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate, Translate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Spanish() {
	return (
		<TacoTranslate locale="es">
			<Translate string="Hello, world in Spanish!" />
		</TacoTranslate>
	);
}

function Norwegian() {
	return (
		<TacoTranslate locale="no">
			<Translate string="Hello, world in Norwegian!" />
		</TacoTranslate>
	);
}

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Spanish />
			<Norwegian />
		</TacoTranslate>
	);
}

د ژباړې د پېژندنې کارول

تاسو کولی شئ id د Translate کمپوننټ ته اضافه کړئ ترڅو د ورته متن لپاره بېلابېلې ژباړې یا معناوې اداره کړئ. دا په ځانګړي ډول ګټور دی کله چې یو شان متن د سیاق له مخې بېلابېلې ژباړې ته اړتیا ولري. د ځانګړو ID-ونو په ورکولو سره، تاسو ډاډ ترلاسه کوئ چې د متن هره بیلګه د خپلې مشخصې معنا سره سم په سمه توګه ژباړل شوې ده.

import {Translate} from 'tacotranslate/react';

function Header() {
	return (
		<Translate id="header" string="Login" />
	);
}

function Footer() {
	return (
		<Translate id="footer" string="Login" />
	);
}

د بېلګې په توګه، د هیډر 'login' لیبل کېدای شي په هسپانوي کې «Iniciar sesión» ته وژباړل شي، او د فوټر 'login' لیبل کېدای شي په هسپانوي کې «Acceder» ته وژباړل شي.

غوره کړنلارې