اسناد: د TacoTranslate کارول

د TacoTranslate کارول

Pashto

د تارونو ژباړل

اوس مهال درې لارې شتون لري چې سټرینګونه ژباړل شي: د Translate کمپونینټ، د useTranslation هوک، یا د translateEntries یوټیلیټي.

د Translate برخې کارول.
ژباړې په span عنصر کې وړاندې کوي، او د HTML د ښودلو ملاتړ کوي.

import {Translate} from 'tacotranslate/react';

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

تاسې کولی شئ د عنصر ډول د بېلګې په توګه د as="p" په کارولو سره په کمپونینټ کې تغییر ورکړئ.

د useTranslation هوک کارول.
ژباړې په ساده متن کې بېرته ورکوي. د بېلګې په توګه، په meta ټاګونو کې ګټور دي.

import {useEffect} from 'react';
import {useTranslation} from 'tacotranslate/react';

function Page() {
	const helloWorld = useTranslation('Hello, world!');

	useEffect(() => {
		alert(helloWorld);
	}, [helloWorld]);

	return (
		<title>{useTranslation('My page title')}</title>
	);
}

د translateEntries توکي کارول.
په سرور کې ټکي وژباړئ. خپل OpenGraph انځورونه پیاوړي کړئ.

import {createEntry, translateEntries} from 'tacotranslate';

async function generateMetadata(locale = 'es') {
	const title = createEntry({string: 'Hello, world!'});
	const description = createEntry({string: 'TacoTranslate on the server'});

	const translations = await translateEntries(
		tacoTranslate,
		{origin: 'opengraph', locale},
		[title, description]
	);

	return {
		title: translations(title),
		description: translations(description)
	};
}

کله چې ځرګندونې زموږ سرورونو ته ورسیږي، موږ لومړی یې تایید او ذخیره کوو، بیا سمدلاسه یو ماشین ژباړه بېرته استوو. که څه هم د ماشین ژباړې عمومًا د زموږ د AI ژباړو په پرتله ټیټه کیفیت لري، خو دوی چټک لومړنی ځواب برابروي.

په ورته وخت کې، موږ یوه غیرهمغږي ژباړې دنده پیل کوو ترڅو ستاسو د لیکنې لپاره لوړ کیفیت، پرمختللې AI ژباړه تولید کړو. کله چې د AI ژباړه چمتو شي، دا به د ماشین ژباړه ځای پرځای کړي او هرکله چې تاسو د خپلو لیکنو ژباړې غوښتنه وکړئ، به واستول شي.

که تاسو یوه رشته په لاسي ډول وژباړلې وي، هغه ژباړې تر ټولو لومړیتوب لري او پر ځای یې راستنیږي.

د اصلي سرچینو کارول

TacoTranslate پروژې هغه څه لري چې موږ یې اصلونه وایو. دوی د ستاسو د متنونو او ژباړو لپاره د ننوتلو ځایونو، فولډرونو، یا ګروپونو په توګه وګڼئ.

import {TacoTranslate} from 'tacotranslate/react';

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

اصلونه تاسو ته اجازه درکوي چې سټرینګونه په معنی لرونکو کانتینرونو وویشئ. د بېلګې په توګه، تاسو کولی شئ یو اصل د سند لپاره او بل د خپلې بازارموندنې پاڼې لپاره ولرئ.

د ډیر دقیق کنټرول لپاره، تاسو کولی شئ د کمپونینټ په کچه origins تنظیم کړئ.

د دې لپاره، په خپل پروژه کې د ډېرو TacoTranslate چمتو کوونکو کارولو په اړه غور وکړئ.

مهرباني وکړئ په یاد ولرئ چې یو شان تار په مختلفو ابتدايي ځایونو کې مختلف ژباړې ترلاسه کولی شي.

په پای کې، دا چې تاسو سترینګونه په کومو اصلي ځایونو وویشئ ستاسو او ستاسو د اړتیاوو پورې اړه لري. خو، یادونه وکړئ چې د یو اصلي ځای دننه ډیر سترینګونه درلودل ممکن د بارولو وختونه زیات کړي.

د متغیرونو اداره کول

تاسو باید تل د متحرک مینځپانګې لپاره متغیرونه وکاروئ، لکه د کارونکي نومونه، نیټې، بریښنالیک پتې، او نور.

په تارونو کې متغیرونه د دوه ګوني بریکټونو په کارولو سره اعلان کیږي، لکه {{variable}}.

import {Translate} from 'tacotranslate/react';

function Greeting() {
	const name = 'Juan';
	return <Translate string="Hello, {{name}}!" variables={{name}} />;
}

import {useTranslation} from 'tacotranslate/react';

function useGreeting() {
	const name = 'Juan';
	return useTranslation('Hello, {{name}}!', {variables: {name}});
}

د HTML منځپانګې اداره کول

په اصلي ډول، د Translate کمپوننټ د HTML مینځپانګې ملاتړ کوي او وړاندې کوي. خو، تاسو کولی شئ د دې چلند څخه بهر شئ په دې سره چې useDangerouslySetInnerHTML ته false وټاکئ.

کله چې د بې باوره مینځپانګې لکه د کاروونکي لخوا جوړ شوي مینځپانګې ژباړه کوئ، د HTML رینډر کول غیر فعالول کلک سپارښتنه کېږي.

ټولې نتیجې تل د sanitize-html په مرسته له وړاندې کولو وړاندې پاکې کېږي.

import {Translate} from 'tacotranslate/react';

function Page() {
	return (
		<Translate
			string={`
				Welcome to <strong>my</strong> website.
				I’m using <a href="{{url}}">TacoTranslate</a> to translate text.
			`}
			variables={{url: 'https://tacotranslate.com'}}
			useDangerouslySetInnerHTML={false}
		/>
	);
}

پورته مثال به د ساده متن په توګه وړاندې شي.

د سرور-خوا اړخ رینډرینګ

د TacoTranslate کارول

څنګه تارونه ژباړل کیږي

د اصلي سرچینو کارول

د متغیرونو اداره کول

د HTML منځپانګې اداره کول