ලේඛන: TacoTranslate භාවිතය

TacoTranslate භාවිතය

Sinhala

පෙළ පරිවර්තනය

දැන් පෙළ පරිවර්තනය කිරීමට ක්‍රම තුනක් තිබේ: Translate කොම්පෝනන්ට්, useTranslation හුක්, හෝ translateEntries යූටිලිටි.

Translate සංරචකය භාවිත කිරීම.
පරිවර්තන span මූලද්‍රව්‍යයක තුළ ප්‍රදර්ශනය කරයි, සහ HTML රෙන්ඩර කිරීමට සහය දක්වයි.

import {Translate} from 'tacotranslate/react';

function Page() {
	return <Translate string="Hello, world!" />;
}

උදාහරණයක් ලෙස, කොම්පොනෙන්ට් එකට as="p" ලබාදී එහි element වර්ගය වෙනස් කළ හැක.

useTranslation හූක් භාවිතය.
පරිවර්තන සරල පෙළක් (plain string) ලෙස ලබා දෙයි. උදාහරණයක් ලෙස 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 යන ලෙස හැඳින්වෙන දෙයක් අඩංගු වේ. ඒවා ඔබගේ පෙළ (strings) සහ පරිවර්තන සඳහා ප්‍රවේශ ස්ථාන, ෆෝල්ඩර් හෝ කණ්ඩායම් ලෙස සිතන්න.

import {TacoTranslate} from 'tacotranslate/react';

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

මූලාශ්‍ර ඔබට පද පෙළ අර්ථවත් කන්ටේනර්වලට වෙන් කිරීමට ඉඩ සලසයි. උදාහරණයක් ලෙස, ලේඛන සඳහා එක් මූලාශ්‍රයක් සහ ඔබේ වෙළඳ ප්‍රචාරක පිටුව සඳහා වෙනත් මූලාශ්‍රයක් තිබිය හැක.

වැඩි විස්තරාත්මක පාලනයක් සඳහා, ඔබට සංරචක මට්ටමේ origins සැකසිය හැකි අතර.

මෙය ඉටු කිරීමට, ඔබේ ව්‍යාපෘතිය තුළ බහු TacoTranslate සපයන්නන් භාවිතා කිරීම සලකා බලන්න.

කරුණාකර සලකන්න: එකම පෙළක් විවිධ මූලාශ්‍රවලදී වෙනස් පරිවර්තන ලැබිය හැකි බව.

අවසානයේ, පේළි (strings) කොහෙට හා කෙසේ origins වෙත වෙන් කරන්නේද යන්න ඔබට සහ ඔබගේ අවශ්‍යතාට අනුව වේ. කෙසේ වෙතත්, එක් origin එකක් තුළ පේළි බොහෝ වීමෙන් බාගත කිරීමේ කාලය (loading times) වැඩි විය හැකි බව සලකන්න.

වෙනස්කම් හසුරවීම

පරිශීලක නම්, දිනයන්, විද්‍යුත් තැපැල් ලිපින වැනි ගතික අන්තර්ගත සඳහා ඔබ සෑමවිටම විචල්‍ය (variables) භාවිතා කළ යුතුය.

පෙළවල ඇති වෙනස්කම් (variables) දෙගුණ brackets භාවිතයෙන් ප්‍රකාශ කරයි, උදාහරණයක් ලෙස {{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}
		/>
	);
}

ඉහත උදාහරණය සාමාන්‍ය පෙළක් ලෙස පෙන්වනු ඇත.

සේවාදායක පැත්තේ ප්‍රදර්ශනය

TacoTranslate භාවිතය

ස්ට්‍රිං පරිවර්තනය කරන ආකාරය

මූලාශ්‍ර භාවිත කිරීම

වෙනස්කම් හසුරවීම

HTML අන්තර්ගත කළමනාකරණය