ഡോക്യുമെന്റേഷൻ: TacoTranslate ഉപയോഗിക്കുന്നത്

TacoTranslate ഉപയോഗിക്കുന്നത്

Malayalam

സ്ട്രിംഗുകൾ വിവർത്തനം ചെയ്യൽ

നിലവിൽ സ്ട്രിങുകൾ വിവർത്തനം ചെയ്യാനുള്ള മൂന്ന് മാർഗങ്ങളുണ്ട്: 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)
	};
}

സ്ട്രിംഗുകൾ എങ്ങനെ വിവർത്തനം ചെയ്യപ്പെടുന്നു

സ്റ്റ്രിംഗ്‍കൾ ഞങ്ങളുടെ സെർവറുകളിൽ എത്തുമ്പോൾ, ആദ്യം ഞങ്ങൾ అవയെ സാധുത പരിശോധിച്ച് സേവ് ചെയ്യുകയും, പിന്നീട് ഉടനെ മെഷീൻ വിവർത്തനം മടക്കി നൽകുകയും ചെയ്യുന്നു. മെഷീൻ വിവർത്തനങ്ങൾ സാധാരണയായി våra AI വിവർത്തനങ്ങളേക്കാൾ നിലവാരത്തിൽ കുറവായിരിക്കാം, എങ്കിലും അവ ഒരു വേഗതയേറിയ പ്രാഥമിക പ്രതികരണം നൽകുന്നു.

ഒപ്പമെത്തേ, നിങ്ങളുടെ സ്ട്രിംഗിനായി ഉയർന്ന നിലവാരമുള്ള, ആധുനിക AI വിവര്‍ത്തനം സൃഷ്ടിക്കാൻ നാം അസിങ്ക്രോണസ് വിവര്‍ത്തന ജോബ് ആരംഭിക്കുന്നു. AI വിവര്‍ത്തനം തയ്യാറായാല്‍ അത് യന്ത്ര വിവര്‍ത്തനത്തെ മാറ്റി നല്കും — നിങ്ങള്‍ നിങ്ങളുടെ സ്ട്രിംഗുകളുടെ വിവര്‍ത്തനങ്ങള്‍ ആവശ്യപ്പെടുമ്പോള്‍ അത് അയയ്ക്കപ്പെടും.

നിങ്ങൾ ഒരു സ്ട്രിംഗ് ഹസ്തപരിഭാഷ ചെയ്‌തിട്ടുണ്ടെങ്കിൽ, ആ പരിഭാഷകൾക്ക് മുൻഗണന ലഭിക്കുകയും അവ തിരികെ നൽകപ്പെടുകയും ചെയ്യും.

ഓറിജിനുകൾ ഉപയോഗിക്കൽ

TacoTranslate പ്രോജക്ടുകളിൽ ഞങ്ങൾ മൂലങ്ങൾ എന്ന് വിളിക്കുന്നവകൾ ഉണ്ടാകുന്നു. അവയെ നിങ്ങളുടെ ടെക്സ്റ്റുകൾക്കും വിവർത്തനങ്ങൾക്കും വേണ്ട എൻട്രി പോയിന്റുകളായി, ഫോൾഡറുകളായി, അല്ലെങ്കിൽ ഗ്രൂപ്പുകളായി കരുതുക.

import {TacoTranslate} from 'tacotranslate/react';

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

ഓറിജിനുകൾ നിങ്ങളെ സ്ട്രിംഗുകൾ അർത്ഥപൂർണ്ണമായ കണ്ടെയ്നറുകളായി വേർതിരിക്കാൻ അനുവദിക്കുന്നു. ഉദാഹരണത്തിന്, ഡോക്യുമെന്റേഷനിനായി ഒരു ഓറിജിൻ ഉണ്ടാവാം, നിങ്ങളുടെ മാർക്കറ്റിംഗ് പേജിനായി മറ്റൊന്ന് ഉണ്ടാകാവുന്നതാണ്.

കൂടുതൽ സൂക്ഷ്മ നിയന്ത്രണത്തിനായി, നിങ്ങൾ കമ്പോണന്റ് തലത്തിൽ 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}
		/>
	);
}

മുകളിൽ കാണിച്ച ഉദാഹരണം സാധാരണ ടെക്സ്റ്റ് ആയി പ്രദർശിപ്പിക്കപ്പെടും.

സെർവർ-സൈഡ് റെൻഡറിംഗ്