TacoTranslate
/
دستاویزاتقیمتیں
 
  1. تعارف
  2. شروع کریں
  3. تنصیب اور ترتیب
  4. TacoTranslate کا استعمال
  5. سرور سائیڈ رینڈرنگ
  6. متقدم استعمال
  7. بہترین طریقۂ کار
  8. غلطیوں کا انتظام اور ڈیبگنگ
  9. مدد یافتہ زبانیں

TacoTranslate کا استعمال

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

اس وقت سٹرنگز کو ترجمہ کرنے کے تین طریقے موجود ہیں: 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 کہتے ہیں۔ انہیں اپنے 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}
		/>
	);
}

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

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

ایک مصنوعہ Nattskiftet سےناروے میں بنایا گیا