డాక్యుమెంటేషన్: 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 అనువాదం సిద్ధంగా ఉన్నప్పుడు, అది మెషిన్ అనువాదాన్ని మార్చి మీరు మీ స్ట్రింగుల అనువాదాలను అడిగేటప్పుడు పంపబడుతుంది.

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

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

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

import {TacoTranslate} from 'tacotranslate/react';

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

Origins మనకు స్ట్రింగ్స్‌ను అర్థవంతమైన కంటైనర్లుగా వేరు చేయడానికి అనుమతిస్తాయి. ఉదాహరణకు, మీరు ఒక 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}
		/>
	);
}

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

సర్వర్-సైట్ రేండరింగ్