TacoTranslate
/
ਡੌਕਯੂਮੈਂਟੇਸ਼ਨਕੀਮਤਾਂ
 
  1. ਪ੍ਰਸਤਾਵਨਾ
  2. ਸ਼ੁਰੂਆਤ ਕਰਨਾ
  3. ਸੈੱਟਅੱਪ ਅਤੇ ਸੰਰਚਨਾ
  4. TacoTranslate ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ
  5. ਸਰਵਰ-ਸਾਈਡ ਰੈਂਡਰਿੰਗ
  6. ਉੱਨਤ ਵਰਤੋਂ
  7. ਸ੍ਰੇਸ਼ਠ ਅਭਿਆਸ
  8. ਤ੍ਰੁਟਿ ਸੰਭਾਲਣ ਅਤੇ ਡੀਬੱਗਿੰਗ
  9. ਸਮਰਥਿਤ ਭਾਸ਼ਾਵਾਂ

ਉੱਨਤ ਵਰਤੋਂ

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

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';
	// ...
}

ਅਨੁਵਾਦ ਨੂੰ ਅਣਚਾਲੂ ਕਰਨਾ

ਕਿਸੇ ਚੌਂਰ੍ਹੇ ਦੇ ਖਾਸ ਹਿੱਸਿਆਂ ਲਈ ਅਨੁਵਾਦ ਨੂੰ ਅਣਚਾਲੂ ਕਰਨ ਜਾਂ ਕੁਝ ਹਿੱਸਿਆਂ ਨੂੰ ਜਿਵੇਂ ਦਾ ਤਿਵੇਂ ਬਰਕਰਾਰ ਰੱਖਣ ਲਈ, ਤੁਸੀਂ ਤਿਰੀਆਹ ਵਰਗੇ ਕੌਸ਼ਲਾਂ triple square brackets ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ। ਇਹ ਫੀਚਰ ਨਾਮਾਂ, ਤਕਨੀਕੀ ਸ਼ਬਦਾਂ ਜਾਂ ਕਿਸੇ ਹੋਰ ਸਮੱਗਰੀ ਦੀ ਅਸਲੀ ਰੂਪਰੇਖਾ ਨੂੰ ਕਾਇਮ ਰੱਖਣ ਲਈ ਲਾਭਦਾਇਕ ਹੈ ਜੋ ਅਨੁਵਾਦ ਨਹੀਂ ਹੋਣੀ ਚਾਹੀਦੀ।

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

ਕਈ ਭਾਸ਼ਾਵਾਂ

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

ਤੁਸੀਂ 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 ਵਰਤਣਾ

ਤੁਸੀਂ Translate ਕੰਪੋਨੈਂਟ ਵਿੱਚ ਵੱਖ-ਵੱਖ ਅਨੁਵਾਦਾਂ ਜਾਂ ਅਰਥਾਂ ਨੂੰ ਸੰਭਾਲਣ ਲਈ id ਜੋੜ ਸਕਦੇ ਹੋ। ਇਹ ਖਾਸ ਤੌਰ 'ਤੇ ਉਸ ਵੇਲੇ ਲਾਭਦਾਇਕ ਹੁੰਦਾ ਹੈ ਜਦੋਂ ਇੱਕੋ ਹੀ ਲਫ਼ਜ਼ ਦੇ ਵੱਖ-ਵੱਖ ਸੰਦਰਭਾਂ ਵਿੱਚ ਵੱਖ-ਵੱਖ ਅਨੁਵਾਦ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ। ਵਿਲੱਖਣ 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” ਹੋ ਸਕਦਾ ਹੈ।

ਸ੍ਰੇਸ਼ਠ ਅਭਿਆਸ

ਇੱਕ ਉਤਪਾਦ Nattskiftet ਤੋਂਨਾਰਵੇ ਵਿੱਚ ਬਣਾਇਆ ਗਿਆ