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

උසස් භාවිතය

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

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

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

මූලාශ්‍රය හෝ ස්ථානික භාෂාව (locale) අතිරේක සැකසීම

බහු TacoTranslate සපයන්නන් භාවිත කිරීමේ අමතරව, ඔබට Translate කොම්පොනන්ට් සහ useTranslation හුක් මට්ටම්වල origin සහ locale දෙකම ඔවර්රයිඩ් කළ හැක.

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 කොම්පොනන්ට් හෝ හුක් මට්ටමේදී ඔවර්රයිඩ් කළ හැක.

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” ලෙස ස්පාඤ්ඤ භාෂාවට පරිවර්තනය විය හැක.

හොඳ ක්‍රියා ක්‍රම