دستاویزات: 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 پراجیکٹس میں وہ چیزیں شامل ہوتی ہیں جنہیں ہم ماخذ کہتے ہیں۔ انہیں اپنی سٹرنگز اور تراجم کے لیے انٹری پوائنٹس، فولڈرز، یا گروپس سمجھیں۔

import {TacoTranslate} from 'tacotranslate/react';

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

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

مزید باریک کنٹرول کے لیے، آپ کمپوننٹ کی سطح پر origins ترتیب دے سکتے ہیں۔

یہ حاصل کرنے کے لیے، اپنے پروجیکٹ میں متعدد TacoTranslate فراہم کنندگان استعمال کرنے پر غور کریں۔

براہِ کرم نوٹ کریں کہ ایک ہی سٹرنگ کو مختلف origins میں مختلف تراجم مل سکتے ہیں۔

آخرکار، آپ سٹرنگز کو اوریجنز میں کیسے تقسیم کرتے ہیں یہ آپ اور آپ کی ضروریات پر منحصر ہے۔ تاہم، نوٹ کریں کہ ایک ہی اوریجن میں بہت سی سٹرنگز ہونے سے لوڈنگ کے اوقات میں اضافہ ہو سکتا ہے۔

متغیرات کو سنبھالنا

متحرک مواد کے لیے آپ کو ہمیشہ متغیرات (variables) استعمال کرنی چاہئیں، جیسے صارف کے نام، تاریخیں، ای میل پتے، وغیرہ۔

اسٹرنگز میں متغیرات کو ڈبل بریکٹس کے ذریعے ظاہر کیا جاتا ہے، جیسے {{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}
		/>
	);
}

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

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