ලේඛනය: උසස් පරිහරණය

උසස් භාවිතය

Sinhala

දකුණෙන් වමට ලියන භාෂා හසුරවීම

TacoTranslate ඔබේ React යෙදුම්වල අරාබි සහ හෙබ්රූ වැනි දකුණෙන් වමට කියවන (right-to-left, RTL) භාෂා සඳහා සහය ලබාදීමට පහසු කරයි. RTL භාෂා නිසි ලෙස හසුරුවීමෙන් දකුණෙන් වමට කියවන පරිශීලකයින්ට ඔබගේ අන්තර්ගතය නිවැරදි ලෙස ප්‍රදර්ශනය වන බව සහතික වේ.

import {useTacoTranslate} from 'tacotranslate/react';

function Document() {
	const {locale, isRightToLeft} = useTacoTranslate();

	return (
		<html lang={locale} dir={isRightToLeft ? 'rtl' : 'ltr'}>
			<body>
				// ...
			</body>
		</html>
	);
}

ඔබට ද සපයන ලද isRightToLeftLocaleCode ක්‍රියාවලිය භාවිතා කර React වලින් පිටත වර්තමාන භාෂාව පරීක්ෂා කළ හැක.

import {isRightToLeftLocaleCode} from 'tacotranslate';

function foo(locale = 'es') {
	const direction = isRightToLeftLocaleCode(locale) ? 'rtl' : 'ltr';
	// ...
}

පරිවර්තනය අක්‍රීය කිරීම

පේළියක විශේෂ කොටස් කිහිපයක් සඳහා පරිවර්තනය අක්‍රිය කිරීමට හෝ එම කොටස් මුල් ආකාරයෙන්ම රඳවා තබා ගැනීමට, ඔබට ත්‍රිත්ව වර්ගකෝෂ (triple square brackets) භාවිතා කළ හැක. මෙම විශේෂාංගය නාම, තාක්ෂණික පද හෝ පරිවර්තනය කළ නොහැකි වෙනත් අන්තර්ගතයක් මුල් ආකාරයෙන් පැවතින සේම රඳවා තබා ගැනීමට ප්‍රයෝජනවත් වේ.

import {Translate} from 'tacotranslate/react';

function Component() {
	return (
		<Translate string="Hello, [[[TacoTranslate]]]!" />
	);
}

මෙම උදාහරණයේ, “TacoTranslate” යන වචනය පරිවර්තනයේදී වෙනස් නොවේ.

බහු TacoTranslate සැපයුම්කරුවන්

අපි ඔබගේ යෙදුමේ බහු TacoTranslate සපයන්නන් භාවිතා කිරීමට දැඩි ලෙස ප්‍රෝත්සාහ කරමු. මෙය ඔබේ පරිවර්තන සහ පෙළ විවිධ මූලාශ්‍රවලට — උදාහරණයක් ලෙස ශීර්ෂකය, පාදකය හෝ විශේෂ කොටස් — වෙන් කොට සංවිධානය කිරීමට ප්‍රයෝජනවත් වේ.

ඔබ මෙහි origins භාවිතා කිරීම පිළිබඳ වැඩිදුර කියවිය හැක.

TacoTranslate සපයන්නන් ඕනෑම මව් සපයන්නාකෙනෙකුගෙන් සැකසුම් උරුම කරගනී, එනිසා ඔබට වෙනත් සැකසුම් නැවත පවරන අවශ්‍යතාව නොමැත.

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Header() {
	return (
		<TacoTranslate origin="header">
			// ...
		</TacoTranslate>
	);
}

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

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Header />
			<Menu />
		</TacoTranslate>
	);
}

මුලාශ්‍රය හෝ හෝස්තුභූමිය ඔවරයිඩ් කිරීම

බහු TacoTranslate ප්‍රවෘත්තිකරුවන් භාවිතා කිරීමට අමතරව, ඔබට Translate කොම්පොනන්ට් හා useTranslation හුක් මට්ටමින් ද මූලාශ්‍රය සහ භාෂාව අතුල්කර ගත හැක.

import {Translate, useTranslation} from 'tacotranslate/react';

function Greeting() {
	const spanishHello = useTranslation('Hello!', {locale: 'es'});

	return (
		<>
			{spanishHello}
			<Translate string="What’s up?" origin="greeting" />
		</>
	);
}

ලෝඩ් කිරීමේ කළමනාකරණය

ග්‍රාහක පැත්තේ භාෂාව වෙනස් කරන විට, පරිශීලකයාගේ සම්බන්ධතාවය අනුව පරිවර්තන ලබා ගැනීමට කිහිප මොහොතක් ගත විය හැක. මාරුව සිදුවන අතරතුර දෘශ්‍ය ප්‍රතිචාර ලබා දී පරිශීලක අත්දැකීම වැඩිදියුණු කිරීම සඳහා ඔබට ලෝඩින් සංදර්ශකයක් පෙන්විය හැක.

import {useTacoTranslate} from 'tacotranslate/react';

function Component() {
	const {isLoading} = useTacoTranslate();

	return (
		isLoading ? 'Translations are loading...' : null
	);
}

බහුවචනීකරණය

බහුවචනීකරණය හා ගණන මත පදනම් වූ ලේබල නිවැරදිව විවිධ භාෂාවල පෙන්වීම සඳහා, මෙය හොඳම ක්‍රියාපටිපාටියක් ලෙස සැලකේ:

import {Translate, useLocale} from 'tacotranslate/react';

function PhotoCount() {
	const locale = useLocale();
	const count = 1;

	return count === 0 ? (
		<Translate string="You have no photos." />
	) : count === 1 ? (
		<Translate string="You have 1 photo." />
	) : (
		<Translate
			string="You have {{count}} photos."
			variables={{count: count.toLocaleString(locale)}}
		/>
	);
}

බහු භාෂා

එකම යෙදුමකදී එකවර බහු භාෂා සහය ලබාදීමට, ඔබට බහු TacoTranslate සැපයුම්කරුවන් භාවිතා කළ හැක වෙනස් locale අගයන් සමඟ:

ඔබට තවද locale කොම්පොනන්ට් හෝ හූක් මට්ටමේදී අතිරේකව පිහිටුවිය හැක.

import createTacoTranslateClient from 'tacotranslate';
import {TacoTranslate, Translate} from 'tacotranslate/react';

const tacoTranslateClient = createTacoTranslateClient({apiKey: 'YOUR_API_KEY'});

function Spanish() {
	return (
		<TacoTranslate locale="es">
			<Translate string="Hello, world in Spanish!" />
		</TacoTranslate>
	);
}

function Norwegian() {
	return (
		<TacoTranslate locale="no">
			<Translate string="Hello, world in Norwegian!" />
		</TacoTranslate>
	);
}

export default function App() {
	return (
		<TacoTranslate client={tacoTranslateClient} origin="page" locale="es">
			<Spanish />
			<Norwegian />
		</TacoTranslate>
	);
}

පරිවර්තන හැඳුනුම් (IDs) භාවිතය

ඔබට id Translate කොම්පොනන්ට්ට එකතු කර එකම පෙළ සඳහා වෙනස් පරිවර්තන හෝ අර්ථයන් හැසිරවිය හැක. එකම පෙළට සන්දර්භය අනුව වෙනස් පරිවර්තන අවශ්‍ය වන විට මෙය විශේෂයෙන් ප්‍රයෝජනවත් වේ. අද්විතීය ID පවරා දීමෙන්, පෙළේ සෑම උදාහරණයක්ම එහි නිශ්චිත අර්ථයට අනුව නිවැරදිව පරිවර්තනය වන බව ඔබ සහතික කළ හැක.

import {Translate} from 'tacotranslate/react';

function Header() {
	return (
		<Translate id="header" string="Login" />
	);
}

function Footer() {
	return (
		<Translate id="footer" string="Login" />
	);
}

උදාහරණයක් ලෙස, ශීර්ෂයේ ලොගින් “Iniciar sesión” ලෙසත්, පාදකයේ ලොගින් “Acceder” ලෙසත් ස්පාඤ්ඤ භාෂාවට පරිවර්තනය විය හැක.

හොඳ ක්‍රියා පටිපාටි