مستندات: د 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 ژباړه چمتو شي، دا به د ماشيني ژباړې ځای ونیسي او هرکله چې تاسو د خپلو متنونو ژباړې غوښتنه وکړئ، لیږل به شي.

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

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

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

import {TacoTranslate} from 'tacotranslate/react';

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

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

د لا مفصل کنټرول لپاره، تاسو کولی شئ سرچینې په کمپوننټ کچه تنظیم کړئ.

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

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

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

د متغیرونو سمبالول

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

په سټرینګونو کې متغیرونه د دوه ګوني قوسونو په کارولو سره اعلانېږي، لکه {{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 منځپانګې اداره کول