డాక్యుమెంటేషన్: TacoTranslate‌ను ఉపయోగించడం

TacoTranslate ఉపయోగించడం

Telugu

స్ట్రింగ్‌లను అనువదించడం

ప్రస్తుతం స్ట్రింగులను అనువదించడానికి మూడు మార్గాలు ఉన్నాయి: 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)
	};
}

స్ట్రింగ్‌లు ఎలా అనువదించబడతాయి

స్ట్రింగ్‌లు మా సర్వర్లకు చేరినపుడు, మేము వాటిని eerst ధృవీకరించి సేవ్ చేయబడతాయి, తదనంతరం వెంటనే మెషిన్ అనువాదాన్ని తిరిగి అందిస్తాము. సాధారణంగా మెషిన్ అనువాదాలు మా AI అనువాదాల కంటే నాణ్యతలో తక్కువగా ఉంటాయి, అయినప్పటికీ అవి వేగవంతమైన ప్రారంభ ప్రతిస్పందనను అందిస్తాయి.

అదే సమయంలో, మీ స్ట్రింగ్ కోసం ఉన్నత-నాణ్యతైన, ఆధునిక AI అనువాదాన్ని సృష్టించడానికి మేము అసింక్రోనస్ అనువాద కార్యకలాపాన్ని ప్రారంభిస్తాము. AI అనువాదం సిద్ధమైన వెంటనే అది యంత్ర అనువాదాన్ని భర్తీ చేస్తుంది మరియు మీరు మీ స్ట్రింగ్‌లకు అనువాదాలు కోరినప్పుడల్లా పంపబడుతుంది.

మీరు ఒక స్ట్రింగ్‌ను మాన్యువల్‌గా అనువదించి ఉంటే, ఆ అనువాదాలకు ప్రాధాన్యం ఉండి అవే తిరిగి ఇవ్వబడతాయి.

మూలాలను ఉపయోగించడం

TacoTranslate ప్రాజెక్టుల్లో మనం మూలాలు అని పిలిచే అంశాలు ఉంటాయి. మీ స్ట్రింగ్‌లు మరియు అనువాదాల కోసం వాటిని ప్రవేశ బిందువులు, ఫోల్డర్లు లేదా గుంపులుగా భావించండి.

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

పైన ఉన్న ఉదాహరణ సాధారణ పాఠ్యంగా ప్రదర్శించబడుతుంది.

సర్వర్-సైడ్ రెండరింగ్