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

TacoTranslate کا استعمال

Urdu

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

فی الحال متن کو ترجمہ کرنے کے تین طریقے ہیں: Translate کمپونینٹ، useTranslation ہک، یا translateEntries یوٹیلیٹی۔

Translate کمپونینٹ کا استعمال۔
ترجمے ایک span عنصر کے اندر دکھائے جاتے ہیں، اور HTML کی رینڈرنگ کی حمایت کرتے ہیں۔

import {Translate} from 'tacotranslate/react';

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

آپ مثال کے طور پر کمپونینٹ پر as="p" استعمال کر کے عنصر کی قسم تبدیل کر سکتے ہیں۔

useTranslation ہک کا استعمال۔
یہ ترجمے سادہ متن (string) کی صورت میں واپس کرتا ہے۔ مثال کے طور پر 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 آپ کو اسٹرنگز کو معنی خیز کنٹینرز میں الگ کرنے دیتے ہیں۔ مثال کے طور پر، آپ دستاویزات کے لیے ایک 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}
		/>
	);
}

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

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