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

TacoTranslate کا استعمال

Urdu

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

فی الحال تین طریقے ہیں جن سے سٹرنگز کا ترجمہ کیا جا سکتا ہے: Translate component، useTranslation hook، یا translateEntries utility۔

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 کہتے ہیں۔ انہیں اپنے strings اور translations کے لئے entry points، فولڈرز، یا گروپس سمجھیں۔

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}
		/>
	);
}

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

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