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

TacoTranslate ਦੀ ਵਰਤੋਂ

Punjabi

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

ਇਸ ਸਮੇਂ ਸਟ੍ਰਿੰਗਾਂ ਦਾ ਅਨੁਵਾਦ ਕਰਨ ਦੇ ਤਿੰਨ ਤਰੀਕੇ ਹਨ: Translate ਕੰਪੋਨੈਂਟ, useTranslation ਹੁੱਕ, ਜਾਂ translateEntries ਯੂਟਿਲਿਟੀ।

Translate ਕੰਪੋਨੈਂਟ ਦੀ ਵਰਤੋਂ।
ਅਨੁਵਾਦ span ਐਲਮੈਂਟ ਦੇ ਅੰਦਰ ਆਉਟਪੁੱਟ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਅਤੇ HTML ਨੂੰ ਰੈਂਡਰ ਕਰਨ ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ।

import {Translate} from 'tacotranslate/react';

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

ਤੁਸੀਂ ਉਦਾਹਰਨ ਵਜੋਂ ਕੰਪੋਨੈਂਟ ਤੇ as="p" ਵਰਤ ਕੇ ਐਲਿਮੈਂਟ ਦੀ ਕਿਸਮ ਬਦਲ ਸਕਦੇ ਹੋ।

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

ਜੇ ਤੁਸੀਂ ਕਿਸੇ ਸਤਰ ਨੂੰ ਮੈਨੂਅਲ ਤੌਰ 'ਤੇ ਤਰਜਮਾ ਕੀਤਾ ਹੈ, ਤਾਂ ਉਹ ਤਰਜਮੇ ਪ੍ਰਾਥਮਿਕਤਾ ਪ੍ਰਾਪਤ ਕਰਦੇ ਹਨ ਅਤੇ ਉਹੀ ਵਾਪਸ ਕੀਤੇ ਜਾਂਦੇ ਹਨ।

ਮੂਲਾਂ ਦੀ ਵਰਤੋਂ

TacoTranslate ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਉਹ ਹੁੰਦੇ ਹਨ ਜਿਨ੍ਹਾਂ ਨੂੰ ਅਸੀਂ origins ਕਹਿੰਦੇ ਹਾਂ। ਉਨ੍ਹਾਂ ਨੂੰ ਆਪਣੇ ਸਟਰਿੰਗਾਂ ਅਤੇ ਅਨੁਵਾਦਾਂ ਲਈ ਐਂਟਰੀ ਪੁਆਇੰਟ, ਫੋਲਡਰ ਜਾਂ ਗਰੁੱਪ ਸਮਝੋ।

import {TacoTranslate} from 'tacotranslate/react';

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

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

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

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

ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਦਿਓ ਕਿ ਇੱਕੋ ਸਟ੍ਰਿੰਗ ਨੂੰ ਵੱਖ-ਵੱਖ origins ਵਿੱਚ ਵੱਖ-ਵੱਖ ਅਨੁਵਾਦ ਮਿਲ ਸਕਦੇ ਹਨ।

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

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

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

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

ਉਪਰੋਕਤ ਉਦਾਹਰਨ ਸਧਾਰਨ ਪਾਠ ਵਜੋਂ ਰੈਂਡਰ ਕੀਤੀ ਜਾਏਗੀ।

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