ਦਸਤਾਵੇਜ਼ੀਕਰਨ: ਉੱਨਤ ਉਪਯੋਗ

ਉੱਨਤ ਵਰਤੋਂ

Punjabi

ਸੱਜੇ ਤੋਂ ਖਬੇ ਭਾਸ਼ਾਵਾਂ ਨੂੰ ਸੰਭਾਲਨਾ

TacoTranslate ਤੁਹਾਡੇ React ਐਪਲੀਕੇਸ਼ਨਾਂ ਵਿੱਚ ਅਰਬੀ ਅਤੇ ਹਿਬਰੂ ਵਰਗੀਆਂ ਸੱਜੇ ਤੋਂ ਖੱਬੇ (RTL) ਭਾਸ਼ਾਵਾਂ ਦਾ ਸਹੀ ਤਰੀਕੇ ਨਾਲ ਸਮਰਥਨ ਕਰਨਾ ਆਸਾਨ ਬਣਾਉਂਦਾ ਹੈ। RTL ਭਾਸ਼ਾਵਾਂ ਦੀ ਸਹੀ ਸੰਭਾਲ ਇਹ ਯਕੀਨੀ ਬਣਾਉਂਦੀ ਹੈ ਕਿ ਤੁਹਾਡੀ ਸਮੱਗਰੀ ਉਹਨਾਂ ਉਪਭੋਗਤਾਵਾਂ ਲਈ ਠੀਕ ਤਰ੍ਹਾਂ ਦਰਸਾਈ ਜਾਵੇ ਜੋ ਸੱਜੇ ਤੋਂ ਖੱਬੇ ਪੜ੍ਹਦੇ ਹਨ।

import {useTacoTranslate} from 'tacotranslate/react';

function Document() {
	const {locale, isRightToLeft} = useTacoTranslate();

	return (
		<html lang={locale} dir={isRightToLeft ? 'rtl' : 'ltr'}>
			<body>
				// ...
			</body>
		</html>
	);
}

ਤੁਸੀਂ ਦਿੱਤਾ ਹੋਇਆ isRightToLeftLocaleCode ਫੰਕਸ਼ਨ ਵੀ ਵਰਤ ਸਕਦੇ ਹੋ ਤਾਂ ਜੋ React ਦੇ ਬਾਹਰ ਮੌਜੂਦਾ ਭਾਸ਼ਾ ਦੀ ਜਾਂਚ ਕੀਤੀ ਜਾ ਸਕੇ।

import {isRightToLeftLocaleCode} from 'tacotranslate';

function foo(locale = 'es') {
	const direction = isRightToLeftLocaleCode(locale) ? 'rtl' : 'ltr';
	// ...
}

ਅਨੁਵਾਦ ਨਿਸ਼ਕ੍ਰਿਆ ਕਰਨਾ

ਕਿਸੇ ਸਟਰਿੰਗ ਦੇ ਖਾਸ ਹਿੱਸਿਆਂ ਲਈ ਅਨੁਵਾਦ ਨੂੰ ਅਯੋਗ ਕਰਨ ਜਾਂ ਇਹ ਯਕੀਨੀ ਬਣਾਉਣ ਲਈ ਕਿ ਕੁਝ ਹਿੱਸੇ ਮੂਲ ਰੂਪ ਵਿੱਚ ਹੀ ਰਹਿਣ, ਤੁਸੀਂ ਤਿੰਨ ਗੁਣਾ ਵਰਗੇ ਕੋਸ਼ਤਕਾਬੰਦੀ ( ) ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ। ਇਹ ਵਿਸ਼ੇਸ਼ਤਾ ਨਾਮ, ਤਕਨੀਕੀ ਸ਼ਬਦਾਂ, ਜਾਂ ਹੋਰ ਕਿਸੇ ਵੀ ਸਮੱਗਰੀ ਦਾ ਮੂਲ ਫੋਰਮੈਟ ਬਨਾਏ ਰੱਖਣ ਲਈ ਲਾਭਦਾਇਕ ਹੈ, ਜਿਸ ਨੂੰ ਅਨੁਵਾਦ ਨਹੀਂ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ।

import {Translate} from 'tacotranslate/react';

function Component() {
	return (
		<Translate string="Hello, [[[TacoTranslate]]]!" />
	);
}

ਇਸ ਉਦਾਹਰਨ ਵਿੱਚ, ਸ਼ਬਦ “TacoTranslate” ਅਨੁਵਾਦ ਵਿੱਚ ਬਦਲਿਆ ਨਹੀਂ ਜਾਵੇਗਾ।

ਕਈ TacoTranslate ਪ੍ਰਦਾਤਾ

ਅਸੀਂ ਤੁਹਾਡੇ ਐਪ ਵਿੱਚ ਕਈ TacoTranslate ਪ੍ਰਦਾਤਾਵਾਂ ਦੀ ਵਰਤੋਂ ਕਰਨ ਦੀ ਭਰਪੂਰ ਸਿਫਾਰਿਸ਼ ਕਰਦੇ ਹਾਂ। ਇਹ ਤੁਹਾਡੇ ਅਨੁਵਾਦਾਂ ਅਤੇ ਸਤਰਾਂ ਨੂੰ ਵੱਖ-ਵੱਖ ਮੂਲਾਂ ਵਿੱਚ ਵਿਵਸਥਿਤ ਕਰਨ ਲਈ ਲਾਭਦਾਇਕ ਹੈ, ਜਿਵੇਂ ਤੁਹਾਡੇ ਹੈਡਰ, ਫੁੱਟਰ, ਜਾਂ ਖਾਸ ਭਾਗ।

ਤੁਸੀਂ ਇਥੇ origins ਦੇ ਇਸਤੇਮਾਲ ਬਾਰੇ ਹੋਰ ਪੜ੍ਹ ਸਕਦੇ ਹੋ।

TacoTranslate প্ৰদানਕਾਰਕ ਕਿਸੇ ਵੀ ਮਾਪੇ ਪ੍ਰਦਾਨਕਰਤਾ ਤੋਂ ਸੈਟਿੰਗਾਂ ਵਿਰਾਸਤ ਵਾਸਤੇ ਹਨ, ਇਸ ਲਈ ਤੁਹਾਨੂੰ ਹੋਰ ਕੋਈ ਸੈਟਿੰਗ ਦੁਹਰਾਉਣ ਦੀ ਲੋੜ ਨਹੀਂ ਪਵੇਗੀ।

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Header() {
	return (
		<TacoTranslate origin="header">
			// ...
		</TacoTranslate>
	);
}

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

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Header />
			<Menu />
		</TacoTranslate>
	);
}

ਮੂਲ ਜਾਂ ਲੋਕੇਲ ਨੂੰ ਓਵਰਰਾਈਡ ਕਰਨਾ

ਕਈ TacoTranslate ਪ੍ਰਦਾਤਿਆਂ ਦੀ ਵਰਤੋਂ ਦੇ ਨਾਲ-ਨਾਲ, ਤੁਸੀਂ Translate ਕੰਪੋਨੈਂਟ ਅਤੇ useTranslation ਹੁੱਕ ਪੱਧਰਾਂ 'ਤੇ ਦੋਵਾਂ origin ਅਤੇ locale ਨੂੰ ਵੀ اوورਰਾਈਡ ਕਰ ਸਕਦੇ ਹੋ।

import {Translate, useTranslation} from 'tacotranslate/react';

function Greeting() {
	const spanishHello = useTranslation('Hello!', {locale: 'es'});

	return (
		<>
			{spanishHello}
			<Translate string="What’s up?" origin="greeting" />
		</>
	);
}

ਲੋਡਿੰਗ ਨੂੰ ਸੰਭਾਲਣਾ

ਜਦੋਂ ਕਲਾਇੰਟ ਪਾਸੇ ਭਾਸ਼ਾਵਾਂ ਬਦਲ ਰਹੇ ਹੋਵੋ, ਤਰਜਮਿਆਂ ਨੂੰ ਪ੍ਰਾਪਤ ਕਰਨ ਵਿੱਚ ਯੂਜ਼ਰ ਦੇ ਕੰਨੈਕਸ਼ਨ ਦੇ ਅਨੁਸਾਰ ਕੁਝ ਸਮਾਂ ਲੱਗ ਸਕਦਾ ਹੈ। ਤੁਸੀਂ ਲੋਡਿੰਗ ਸੂਚਕ ਦਰਸਾ ਕੇ ਯੂਜ਼ਰ ਅਨੁਭਵ ਨੂੰ ਬਿਹਤਰ ਬਣਾ ਸਕਦੇ ਹੋ ਜਦੋਂ ਭਾਸ਼ਾ ਬਦਲੀ ਜਾ ਰਹੀ ਹੋਵੇ।

import {useTacoTranslate} from 'tacotranslate/react';

function Component() {
	const {isLoading} = useTacoTranslate();

	return (
		isLoading ? 'Translations are loading...' : null
	);
}

ਵਿਅਕਤੀਗਤਾ

ਵਿਭਿੰਨ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਬਹੁਵਚਨ ਅਤੇ ਗਿਣਤੀ-ਆਧਾਰਿਤ ਲੇਬਲ ਨੂੰ ਸਹੀ ਤਰੀਕੇ ਨਾਲ ਦਿਖਾਉਣ ਲਈ, ਇਹ ਸਭ ਤੋਂ ਵਧੀਆ ਅਮਲ ਮੰਨਿਆ ਜਾਂਦਾ ਹੈ:

import {Translate, useLocale} from 'tacotranslate/react';

function PhotoCount() {
	const locale = useLocale();
	const count = 1;

	return count === 0 ? (
		<Translate string="You have no photos." />
	) : count === 1 ? (
		<Translate string="You have 1 photo." />
	) : (
		<Translate
			string="You have {{count}} photos."
			variables={{count: count.toLocaleString(locale)}}
		/>
	);
}

ਕਈ ਭਾਸ਼ਾਵਾਂ

ਇਕੋ ਐਪਲੀਕੇਸ਼ਨ ਵਿੱਚ ਇੱਕ ਸਮੇਂ ਬਹੁਤ ਸਾਰੀਆਂ ਭਾਸ਼ਾਵਾਂ ਨੂੰ ਸਹਿਯੋਗ ਦਿੰਦਿਆਂ, ਤੁਸੀਂ ਵੱਖ-ਵੱਖ locale ਮੁੱਲਾਂ ਨਾਲ ਕਈ TacoTranslate ਪ੍ਰਦਾਤਾ ਵਰਤ ਸਕਦੇ ਹੋ:

ਤੁਸੀਂ locale ਨੂੰ ਕੰਪੋਨੈਂਟ ਜਾਂ ਹੁੱਕ ਲੈਵਲ 'ਤੇ ਵੀ ਓਵਰਰਾਈਡ ਕਰ ਸਕਦੇ ਹੋ।

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate, Translate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Spanish() {
	return (
		<TacoTranslate locale="es">
			<Translate string="Hello, world in Spanish!" />
		</TacoTranslate>
	);
}

function Norwegian() {
	return (
		<TacoTranslate locale="no">
			<Translate string="Hello, world in Norwegian!" />
		</TacoTranslate>
	);
}

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Spanish />
			<Norwegian />
		</TacoTranslate>
	);
}

ਅਨੁਵਾਦ ID ਵਰਤਣਾ

ਤੁਸੀਂ ਇੱਕ id ਨੂੰ Translate ਕੰਪੋਨੈਂਟ ਵਿੱਚ ਜੋੜ ਸਕਦੇ ਹੋ ਤਾਂ ਜੋ ਇੱਕੋ ਸਤਰ ਲਈ ਵੱਖ-ਵੱਖ ਅਨੁਵਾਦ ਜਾਂ ਅਰਥ ਸੰਭਾਲੇ ਜਾ ਸਕਣ। ਇਹ ਖਾਸ ਤੌਰ 'ਤੇ ਬਹੁਤ ਲਾਭਦਾਇਕ ਹੈ ਜਦੋਂ ਇੱਕੋ ਗੱਲ ਦਾ ਸੰਦਰਭ ਮੁਤਾਬਕ ਵੱਖ-ਵੱਖ ਅਨੁਵਾਦ ਦੀ ਲੋੜ ਹੋਵੇ। ਵਿਲੱਖਣ ID ਨਿਰਧਾਰਤ ਕਰਕੇ, ਤੁਸੀਂ ਇਹ ਯਕੀਨੀ ਬਣਾਉਂਦੇ ਹੋ ਕਿ ਸਤਰ ਦਾ ਹਰ ਇਕ ਉਦਾਹਰਨ ਆਪਣੇ ਖਾਸ ਮਤਲਬ ਅਨੁਸਾਰ ਸਹੀ ਤਰੀਕੇ ਨਾਲ ਅਨੁਵਾਦਿਤ ਕੀਤੀ ਜਾਵੇ।

import {Translate} from 'tacotranslate/react';

function Header() {
	return (
		<Translate id="header" string="Login" />
	);
}

function Footer() {
	return (
		<Translate id="footer" string="Login" />
	);
}

ਉਦਾਹਰਨ ਵੱਜੋਂ, ਹੈਡਰ ਲੌਗਿਨ ਦਾ ਅਨੁਵਾਦ ਸਪੇਨੀ ਵਿੱਚ “Iniciar sesión” ਹੋ ਸਕਦਾ ਹੈ, ਅਤੇ ਫੁਟਰ ਲੌਗਿਨ ਦਾ ਅਨੁਵਾਦ “Acceder” ਹੋ ਸਕਦਾ ਹੈ।

ਸਰਵੋੱਤਮ ਅਭਿਆਸ