مستندات: د 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 ژباړو په پرتله ټیټه کچه کیفیت لري، خو دا یو چټک ابتدايي ځواب برابروي.

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

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

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

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

import {TacoTranslate} from 'tacotranslate/react';

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

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

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

د دې د لاسته راوړلو لپاره، په خپل پروژه کې د څو 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 منځپانګې اداره کول