اسناد: د 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 چمتو کونکو کارولو ته پام وکړئ.

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

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

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

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

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