ලේඛන: උසස් භාවිතය

උසස් භාවිතය

Sinhala

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

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

import {useTacoTranslate} from 'tacotranslate/react';

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

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

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

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 සපයන්නන් භාවිතා කිරීමට දැඩිව නිර්දේශ කරමු. මෙය ඔබගේ පරිවර්තන සහ පෙළ විවිධ මූලාශ්‍රවලට (උදාහරණයට: හෙඩරය, ෆූටර්ය හෝ විශේෂ කොටස්) සංවිධානය කිරීම සඳහා ප්‍රයෝජනවත් වේ.

ඔබට මෙහි මූලාශ්‍ර භාවිතය පිළිබඳව වැඩිදුර කියවිය හැක.

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>
	);
}

Origin හෝ locale මාරු කිරීම

බහු 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)}}
		/>
	);
}

බහු භාෂා

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

ඔබට locale component හෝ hook මට්ටමේදී override කළ හැක.

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>
	);
}

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

ඔබට Translate කොම්පොනන්ට් එකට id එකක් එක් කර එකම පෙළ සඳහා විවිධ පරිවර්තන හෝ අර්ථ කළමනාකරණය කළ හැක. එය විශේෂයෙන් ප්‍රයෝජනවත් වේ, එකම පෙළ සන්දර්භය අනුව වෙනස් පරිවර්තන අවශ්‍ය වන විට. අද්විතීය 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” ලෙස ස්පාඤ්ඤ භාෂාවට පරිවර්තනය විය හැක.

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