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

Strings ఎలా అనువదించబడతాయి

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

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

మీరు دستیగా ఒక స్ట్రింగ్‌ను అనువదించFundingండి, ఆ అనువాదాలు ప్రాధాన్యత కలిగి ఉంటాయి మరియు వాటిని తిరిగి అందిస్తారు.

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

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

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

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