డాక్యుమెంటేషన్: 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)
	};
}

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

స్ట్రింగులు మా సర్వర్లకు చేరుకున్నప్పుడు, మేము మొదట వాటిని నిర్ధారించి సేవ్ చేస్తాము, తర్వాత వెంటనే మెషీన్ అనువాదాన్ని ఇస్తాము. మెషీన్ అనువాదాలు సాధారణంగా మా AI అనువాదాల కంటే తక్కువ నాణ్యత కలిగినప్పటికీ, అవి త్వరిత ప్రాథమిక ప్రతిస్పందనను అందిస్తాయి.

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

మీరు if మీకు మీ చేత పరిభాషించబడిన స్ట్రింగ్ ఉంటే, ఆ పరిభాషలు ప్రాధాన్యత పొందుతూ వాటిని మార్చి ఇవ్వబడతాయి.

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

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

import {TacoTranslate} from 'tacotranslate/react';

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

ఒరిజిన్లు మీకు స్ట్రింగులను అర్థవంతమైన కంటైనర్లుగా వేరు చేయడానికి అనుమతిస్తాయి. ఉదాహరణకు, మీరు డాక్యుమెంటేషన్ కోసం ఒక ఒరిజిన్, మరియు మీ మార్కెటింగ్ పేజీ కోసం మరొకటి ఉండవచ్చు.

మరింత సూటి నియంత్రణ కోసం, మీరు კომპონెంట్ స్థాయిలో origins ను సెటప్ చేసుకోవచ్చు.

దీనిని సాధించడానికి, మీ ప్రాజెక్ట్‌లో పలుకు TacoTranslate ప్రొవైడర్‌లను ఉపయోగించడం పరిగణించండి.

దయచేసి గమనిక: ఒకే స్ట్రింగ్ వివిధ originsలో వేరువేరు అనువాదాలు పొందవచ్చు.

ఇంకోసారి, మీరు స్ట్రింగ్స్‌ను 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}
		/>
	);
}

పై ఉదాహరణ సాదా టెక్స్ట్ రూపంలో ప్రదర్శించబడుతుంది.

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