ਦਸਤਾਵੇਜ਼ੀ: TacoTranslate ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ

TacoTranslate ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ

Punjabi

ਤਰਜਮਾ ਕਰਨਾ ਸਤਰਾਂ

ਫਿਲਹਾਲ ਤਿੰਨ ਤਰੀਕੇ ਹਨ ਸਟਰਿੰਗਜ਼ ਦਾ ਅਨੁਵਾਦ ਕਰਨ ਦੇ: Translate ਕੰਪੋਨੈਂਟ, useTranslation ਹੁੱਕ, ਜਾਂ translateEntries ਉਪਯੋਗੀ ਚੀਜ਼।

Translate ਕੰਪੋਨੇਟ ਦੀ ਵਰਤੋਂ ਕਰਨਾ।
ਇਹ ਅਨੁਵਾਦ span ਐਲਮੈਂਟ ਵਿੱਚ ਨਿਕਾਸ ਕਰਦਾ ਹੈ, ਅਤੇ HTML ਰੇਂਡਰਿੰਗ ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ।

import {Translate} from 'tacotranslate/react';

function Page() {
	return <Translate string="Hello, world!" />;
}

ਤੁਸੀਂ ਕੰਪੋਨੇਟ 'ਤੇ ਉਦਾਹਰਨ ਲਈ, as="p" ਵਰਤ ਕੇ ਤੱਤ ਦੇ ਪ੍ਰਕਾਰ ਨੂੰ ਬਦਲ ਸਕਦੇ ਹੋ।

useTranslation huk ਦਾ ਇਸਤੇਮਾਲ ਕਰਨਾ।
ਅਨੁਵਾਦਾਂ ਨੂੰ ਸਾਧਾਰਣ ਸਤਰਿੰਗ ਵਜੋਂ ਵਾਪਸ ਕਰਦਾ ਹੈ। ਉਦਾਹਰਨ ਲਈ, 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 ਤੁਹਾਨੂੰ strings ਨੂੰ ਅਰਥਪੂਰਨ ਕੰਟੇਨਰਾਂ ਵਿੱਚ ਵੱਖਰਾ ਕਰਨ ਦੀ ਆਗਿਆ ਦਿੰਦੇ ਹਨ। ਉਦਾਹਰਣ ਵਜੋਂ, ਤੁਹਾਡੇ ਕੋਲ ਇੱਕ origin ਡੌਕਯੂਮੈਂਟੇਸ਼ਨ ਲਈ ਅਤੇ ਦੂਜਾ ਤੁਹਾਡੇ ਮਾਰਕੀਟਿੰਗ ਪੇਜ ਲਈ ਹੋ ਸਕਦਾ ਹੈ।

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

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

ਕ੍ਰਿਪਾ ਕਰਕੇ ਧਿਆਨ ਦਿਓ ਕਿ ਇੱਕੋ ਜਿਹਾ ਸਤਰ ਵੱਖ-ਵੱਖ ਓਰਿਜਿਨਾਂ ਵਿੱਚ ਵੱਖ-ਵੱਖ ਅਨੁਵਾਦ ਪ੍ਰਾਪਤ ਕਰ ਸਕਦਾ ਹੈ।

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

ਚਲਾਂਦਾ ਸੰਭਾਲਣਾ

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

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

ਉਪਰੋਕਤ ਉਦਾਹਰਣ ਸਧਾਰਣ ਲਿਖਤ ਵਜੋਂ ਪ੍ਰਦਰਸ਼ਿਤ ਕੀਤਾ ਜਾਵੇਗਾ।

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