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

TacoTranslate کا استعمال کرنا

Urdu

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

اس وقت سٹرنگز ترجمہ کرنے کے تین طریقے ہیں: Translate کمپونینٹ، useTranslation ہُک، یا translateEntries یوٹیلیٹی۔

Translate component کا استعمال۔
ترجمے کو 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 utility استعمال کرنا۔
سرور سائیڈ پر سٹرنگز کا ترجمہ کریں۔ اپنے 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>
	);
}

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

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

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

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

آخرکار، آپ strings کو origins میں کس طرح تقسیم کرتے ہیں یہ آپ اور آپ کی ضروریات پر منحصر ہے۔ تاہم، یہ نوٹ کریں کہ ایک ہی origin میں زیادہ strings ہونے سے لوڈنگ کے اوقات بڑھ سکتے ہیں۔

متغیرات کا انتظام

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

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

ایچ ٹی ایم ایل مواد کا انتظام کرنا

ڈیفالٹ کے طور پر، 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}
		/>
	);
}

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

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