Փաստաթղթավորում: Լավագույն պրակտիկաներ

Լավագույն պրակտիկաներ

Armenian

URL-ները պահեք փոփոխականներում.

Երբ թարգմանում եք տողեր, որոնք պարունակում են URL-ներ կամ նման տվյալներ, լավ պրակտիկա է այդ URL-ները պահպանել փոփոխականներում և այնուհետև հղում կատարել դրանց ձեր կաղապարներում։

<Translate
	string={`Click <a href="{{url}}">here</a>`}
	variables={{url: 'https://tacotranslate.com'}}
/>

Օգտագործեք ARIA պիտակները

Ինտերակտիվ տարրերի, օրինակ՝ կոճակների տեքստը թարգմանելիս կարևոր է ներառել ARIA պիտակները՝ հասանելիությունը ապահովելու համար։ ARIA պիտակները օգնում են էկրանի ընթերցողներին տրամադրել տարրի գործառույթի նկարագրություն։

Օրինակ՝ եթե ունեք կոճակ, որը թույլ է տալիս օգտատերերին պատճենել տեքստը կոդի բլոկից, կարող եք օգտագործել aria-label հատկանիշը՝ հստակ նկարագրություն տալու համար:

<Translate
	aria-label={useTranslation('Copy to clipboard')}
	string="Copy"
/>

Այս ամենում ինչ-որ բան շատ մետա է։

Գլոբալ աղբյուրների զանգվածը և բազմակի կոմպոնենտային աղբյուրներ

Այս օրինաչափը գործում է միայն Next.js Pages Router օգտագործելու դեպքում։

Երբ աշխատում եք մեծ հավելվածների հետ, օգտակար է տողերն ու թարգմանությունները բաժանել մի քանի, փոքր աղբյուրների։ Այս մոտեցումը օգնում է նվազեցնել բունդլների չափը և փոխանցման ժամանակները, ապահովելով արդյունավետ և հեշտորեն մասշտաբվող տեղայնացում։

Սա պարզ է միայն հաճախորդի կողմում մատուցելիս, սակայն աղբյուրների կառավարումը արագորեն բարդանում է, երբ սերվերի կողմի մատուցման համար բեռնում եք թարգմանությունները։ Այնուամենայնիվ, դուք կարող եք ավտոմատացնել աղբյուրների կառավարումը՝ օգտագործելով TacoTranslate հաճախորդի origins զանգվածը։

Օրինակ, հետևյալ դեպքում մենք մեր կոմպոնենտները և էջերը բաժանել ենք առանձին ֆայլերի։

components/pricing-table.tsx

import TacoTranslate, {Translate} from 'tacotranslate/react';
import tacoTranslate from '../tacotranslate-client';

// Set an origin name for this component
const origin = 'components/pricing-table';

// Push the origin into the origins array as this file is imported
tacoTranslate.origins.push(origin);

export default function PricingTable() {
	return (
		<TacoTranslate origin={origin}>
			<Translate string="Pricing table" />
			// ...
		</TacoTranslate>
	);
}

pages/pricing.tsx

import TacoTranslate, {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';
import PricingTable from '../components/pricing-table';

const origin = 'pages/pricing';
tacoTranslateClient.origins.push(origin);

export default function PricingPage() {
	return (
		<TacoTranslate origin={origin}>
			<Translate string="Pricing page" />
			<PricingTable />
		</TacoTranslate>
	);
}

// We will now fetch translations for all imported components and their origins automatically
export async function getStaticProps(context) {
	return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}

Մանրամասն տեղեկությունների համար տեսեք մեր սերվերային կողմի ցուցադրման օրինակները՝ getTacoTranslateStaticProps.

Սխալների կառավարում և շտկում