ડોક્યુમેન્ટેશન: TacoTranslate ઉપયોગ કરવો

TacoTranslate નો ઉપયોગ કરવો

Gujarati

સ્ટ્રિંગ્સનું અનુવાદ કરવું

હાલમાં સ્ટ્રિંગ્સનું અનુવાદ કરવા માટે ત્રણ રીતો ઉપલબ્ધ છે: Translate ઘટક, useTranslation હૂક, અથવા translateEntries ઉપયોગિતા.

Translate કમ્પોનન્ટનો ઉપયોગ.
span عنصرની અંદર અનુવાદો આઉટપુટ કરે છે, અને HTML રેન્ડરિંગને સમર્થન આપે છે.

import {Translate} from 'tacotranslate/react';

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

તમે તત્વ પ્રકારમાં ફેરફાર કરી શકો છો જેમ કે, ઉદાહરણ તરીકે, as="p" ને કોમ્પોનન્ટ પર વાપરીને.

useTranslation હૂકનો ઉપયોગ.
અનુવાદોને સાદા ટેક્સ્ટ તરીકે પરત આપે છે. ઉદાહરણ તરીકે meta ટ Tagsગ્સમાં ઉપયોગી.

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 તમને સ્ટ્રિંગ્સને અર્થપૂર્ણ કન્ટેનરમાં અલગ કરવાનો અવકાશ આપે છે. ઉદાહરણ તરીકે, તમારી પાસે દસ્તાવેજીકરણ માટે એક origin અને તમારા માર્કેટિંગ પેજ માટે બીજું origin હોઈ શકે છે.

વધુ વિમર્શાત્મક નિયંત્રણ માટે, તમે કમ્પોનેન્ટ સ્તર પર origins ને સેટ કરી શકો છો.

આને પૂર્ણ કરવા માટે, તમારા પ્રોજેક્ટમાં એકથી વધુ TacoTranslate પ્રદાતાઓનો ઉપયોગ કરવા પર વિચાર કરો.

કૃપા કરીને નોંધો કે એક જ સ്ട્રિંગ અલગ-અલગ ઓરીજીનિસમાં જુદી જુદી ભાષાંતરીઓ પ્રાપ્ત કરી શકે છે.

અર્થાત, તમે સ્ટ્રિંગ્સને મૂળો માં કેવી રીતે વહેચો તે તમારા અને તમારી જરૂરિયાતો પર નિર્ભર છે. જોકે, નોંધ લો કે એક જ મૂળમાં ઘણી સ્ટ્રિંગ્સ હોવાને કારણે લોડિંગ સમય વધારી શકે છે.

ભરાવો ચલમાન

તમારે હંમેશાં ડાયનેમિક સામગ્રી માટે વેરીએબલ્સનો ઉપયોગ કરવો જોઈએ, જેમ કે વપરાશકર્તાના નામો, તારીખો, ઈ-મેલ સરનામાંઓ, અને વધુ.

સ્ટ્રિંગ્સમાં વેરિએબલ્સ ડબલ બ્રેકેટ્સનો ઉપયોગ કરીને ઘોષિત કરવામાં આવે છે, જેમ કે {{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}
		/>
	);
}

ઉપરનું ઉદાહરણ સામાન્ય લખાણ તરીકે દર્શાવાશે.

સર્વર-સાઇડ રેન્ડરિંગ