دستاویزات: TacoTranslate کا استعمال

TacoTranslate کا استعمال

Urdu

اسٹرنگز کا ترجمہ

فی الحال سٹرنگز کو ترجمہ کرنے کے تین طریقے ہیں: 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 پروجیکٹس میں وہ چیزیں شامل ہوتی ہیں جنہیں ہم origins کہتے ہیں۔ انہیں اپنی سٹرنگز اور تراجم کے لیے انٹری پوائنٹس، فولڈرز، یا گروپس کے طور پر تصور کریں۔

import {TacoTranslate} from 'tacotranslate/react';

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

Origins آپ کو سٹرنگز کو معنی خیز کنٹینرز میں الگ کرنے دیتے ہیں۔ مثال کے طور پر، آپ دستاویزات کے لیے ایک origin اور اپنے مارکیٹنگ پیج کے لیے دوسرا رکھ سکتے ہیں۔

زیادہ باریک کنٹرول کے لیے، آپ کمپونینٹ کی سطح پر 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}
		/>
	);
}

مندرجہ بالا مثال سادہ متن کے طور پر پیش کی جائے گی۔

سرور-سائیڈ رینڈرنگ