ਡੌਕਯੁਮੇਨਟੇਸ਼ਨ: TacoTranslate ਦਾ ਉਪਯੋਗ

TacoTranslate ਦੀ ਵਰਤੋਂ

Punjabi

ਸਟ੍ਰਿੰਗਾਂ ਦਾ ਅਨੁਵਾਦ

ਹੁਣ ਤੱਕ ਸਤਰਾਂ ਦਾ ਅਨੁਵਾਦ ਕਰਨ ਦੇ ਤਿੰਨ ਤਰੀਕੇ ਹਨ: 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 ਕਹਿੰਦੇ ਹਾਂ। ਇਨ੍ਹਾਂ ਨੂੰ ਆਪਣੇ ਸਤਰਾਂ ਅਤੇ ਅਨੁਵਾਦਾਂ ਲਈ ਪ੍ਰਵੇਸ਼ ਸਥਾਨਾਂ, ਫੋਲਡਰਾਂ ਜਾਂ ਸਮੂਹਾਂ ਵਜੋਂ ਸੋਚੋ।

import {TacoTranslate} from 'tacotranslate/react';

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

ਔਰਜਿਨ ਤੁਹਾਨੂੰ ਸਟਰਿੰਗਜ਼ ਨੂੰ ਮਾਅਨੀਪੂਰਨ ਕੰਟੇਨਰਾਂ ਵਿੱਚ ਵੰਡਣ ਦੀ ਮਨਜ਼ੂਰੀ ਦਿੰਦਾ ਹੈ। ਉਦਾਹਰਨ ਵਜੋਂ, ਤੁਹਾਡੇ ਕੋਲ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਲਈ ਇੱਕ ਔਰਜਿਨ ਅਤੇ ਆਪਣੀ ਮਾਰਕੀਟਿੰਗ ਪੇਜ਼ ਲਈ ਦੂਜਾ ਹੋ ਸਕਦਾ ਹੈ।

ਵਧੇਰੇ ਸੂక్షਮ ਨਿਯੰਤਰਣ ਲਈ, ਤੁਸੀਂ ਕੰਪੋਨੈਂਟ ਪੱਧਰ 'ਤੇ origins ਸੈਟਅਪ ਕਰ ਸਕਦੇ ਹੋ।

ਇਸ ਨੂੰ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ, ਆਪਣੇ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ ਕਈ TacoTranslate ਪ੍ਰਦਾਤਿਆਂ ਦਾ ਇਸਤੇਮਾਲ ਕਰਨ ਬਾਰੇ ਸੋਚੋ.

ਕਿਰਪਾ ਕਰਕੇ ਨੋਟ ਕਰੋ ਕਿ ਇੱਕੋ ਸਟਰਿੰਗ ਵੱਖ-ਵੱਖ origins ਵਿੱਚ ਵੱਖ-ਵੱਖ ਅਨੁਵਾਦ ਪ੍ਰਾਪਤ ਕਰ ਸਕਦੀ ਹੈ।

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

ਵੈਰੀਏਬਲਾਂ ਨੂੰ ਸੰਭਾਲਣਾ

ਤੁਹਾਨੂੰ ਹਮੇਸ਼ਾਂ ਗਤਿਸ਼ੀਲ ਸਮੱਗਰੀ ਲਈ ਵੈਰੀਏਬਲਸ ਦੀ ਵਰਤੋਂ ਕਰਨੀ ਚਾਹੀਦੀ ਹੈ, ਜਿਵੇਂ ਕਿ ਯੂਜ਼ਰ ਨਾਮ, ਤਾਰਿਖਾਂ, ਈ-ਮੇਲ ਪਤੇ, ਅਤੇ ਹੋਰ।

ਸਟ੍ਰਿੰਗਜ਼ ਵਿੱਚ ਵੈਰੀਏਬਲ ਦੋਹਰੇ ਕੋਠੇ ਬ੍ਰੈਕਟਾਂ ਦੇ ਵਰਤੋਂ ਨਾਲ ਘੋਸ਼ਿਤ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਜਿਵੇਂ {{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}
		/>
	);
}

ਉਪਰ ਦਿੱਤਾ ਗਿਆ ਉਦਾਹਰਨ ਸਧਾਰਣ ਲਿਖਤ ਵਜੋਂ ਦਰਸਾਇਆ ਜਾਵੇਗਾ।

ਸਰਵਰ-ਸਾਈਡ ਰੈਂਡਰਿੰਗ