دستاویزات: 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}
		/>
	);
}

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

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