ഡോക്യുമെന്റേഷൻ: 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)
	};
}

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

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

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

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

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

TacoTranslate പ്രോജക്ടുകളിൽ നമ്മള്‍ origins എന്ന് വിളിക്കുന്നവ ഉണ്ടായിരിക്കും. അവയെ ваши നിങ്ങളുടെ സ്ട്രിംഗുകൾക്കും വിവർത്തനങ്ങൾക്കുമുള്ള പ്രവേശനബിന്ദുക്കളായി, ഫോൾഡറുകളായി അല്ലെങ്കിൽ ഗ്രൂപ്പുകളായി കരുതുക.

import {TacoTranslate} from 'tacotranslate/react';

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

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

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

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

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