ሰነድ: ከፍተኛ አጠቃቀም

የተጨማሪ አጠቃቀም

Amharic

ከቀኝ ወደ ግራ ቋንቋዎችን ማስተዳደር

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

እንዲሁም የቀረበውን 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 አቅራቢዎችን መጠቀምን እጅግ እንመክራለን። ይህ የትርጉሞችንና የጽሑፍ ሀረጎችን ወደ ተለያዩ መነሻዎች — ለምሳሌ የገጽ ራስ (header), የገጽ ታችኛ ክፍል (footer) ወይም ልዩ ክፍሎች — ለማደራጀት ይጠቅማል።

ይችላሉ ስለ መነሻ ምንጮችን መጠቀም ተጨማሪ ያንብቡ።

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

መጫንን ማስተካከል

በክላይንት ወገን ሲቋንቋ ቋንቋዎችን ሲቀይሩ፣ ትርጉሞችን ማግኘት በተጠቃሚው የኮኔክሽን ፍጥነት መሠረት ጥቂት ጊዜ ሊወስድ ይችላል። በዚያ ጊዜ የመጫን (loading) ምልክት ማሳየት በማድረግ በቀየርነቱ ጊዜ ለተጠቃሚው የሚሰጠውን የእይታ እርምጃ በማቅረብ የተጠቃሚውን ልምድ ማሻሻል ይችላል።

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 መጨመር ይችላሉ። ይህ በተለይ እንደሚጠቅም ሲሆን አንደኛው ቃል በሁኔታዊ ማዕከል ሲለያይ ተለያዩ ትርጉሞች ሲያስፈልጉ ጥቅም ይላል። የተለየ መለያዎችን በመስጠት የቃሉን እያንዳንዱ ክፍል እንደ ልዩ ትርጉም በትክክል እንዲተረጉም ያረጋግጣሉ።

import {Translate} from 'tacotranslate/react';

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

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

ለምሳሌ፣ የራስ (header) መግቢያ በስፔንኛ እንደ “Iniciar sesión” ሊተረጉም ይችላል፣ እና የከታች (footer) መግቢያ እንደ “Acceder” ሊተረጉም ይችላል።

ምርጥ ልምዶች