Kutumia TacoTranslate
Kutafsiri mnyororo za herufi
Kwa sasa kuna njia tatu za kutafsiri misururu ya herufi: komponenti ya Translate
, hook ya useTranslation
, au zana ya translateEntries
.
Kutumia komponenti ya Translate
.
Hutoa tafsiri ndani ya elementi ya span
, na inaunga mkono kuonyesha HTML.
import {Translate} from 'tacotranslate/react';
function Page() {
return <Translate string="Hello, world!" />;
}
Unaweza kubadilisha aina ya kipengee kwa kutumia, kwa mfano, as="p"
kwenye komponenti.
Kutumia hook ya useTranslation
.
Hurejesha tafsiri kama kamba ya maandishi. Inafaa, kwa mfano, kwenye tagi za meta
.
import {useEffect} from 'react';
import {useTranslation} from 'tacotranslate/react';
function Page() {
const helloWorld = useTranslation('Hello, world!');
useEffect(() => {
alert(helloWorld);
}, [helloWorld]);
return (
<title>{useTranslation('My page title')}</title>
);
}
Kutumia zana ya translateEntries
.
Tafsiri maandishi upande wa seva. Boresha kwa kiasi kikubwa picha zako za OpenGraph.
import {createEntry, translateEntries} from 'tacotranslate';
async function generateMetadata(locale = 'es') {
const title = createEntry({string: 'Hello, world!'});
const description = createEntry({string: 'TacoTranslate on the server'});
const translations = await translateEntries(
tacoTranslate,
{origin: 'opengraph', locale},
[title, description]
);
return {
title: translations(title),
description: translations(description)
};
}
Jinsi maandishi yanavyotafsiriwa
Wakati mifungu ya maandishi inafika kwenye seva zetu, kwanza tunaihakiki na kuihifadhi, kisha mara moja tunarejesha tafsiri ya mashine. Ingawa tafsiri za mashine kwa ujumla ni za ubora mdogo ikilinganishwa na tafsiri zetu za AI, zinatoa mwitikio wa awali kwa haraka.
Kwa wakati huo huo, tunaanzisha kazi ya tafsiri isiyo papo hapo ili kuzalisha tafsiri ya AI ya ubora wa hali ya juu kwa kamba yako ya maandishi. Mara tafsiri ya AI itakapokuwa tayari, itachukua nafasi ya tafsiri ya mashine na itatumwa kila unapoomba tafsiri za kamba zako.
Ikiwa umefasiri kamba ya maandishi kwa mkono, tafsiri hizo zinapewa kipaumbele na zinarudishwa badala yake.
Kutumia vyanzo
Miradi ya TacoTranslate yanajumuisha kile tunachokiita origins. Tazama kama sehemu za kuingia, mafolda, au vikundi kwa ajili ya maandishi yako na tafsiri zako.
import {TacoTranslate} from 'tacotranslate/react';
function Menu() {
return (
<TacoTranslate origin="application-menu">
// ...
</TacoTranslate>
);
}
Origins zinakuwezesha kutenganisha maandishi ndani ya makontena yenye maana. Kwa mfano, unaweza kuwa na origin moja kwa ajili ya nyaraka na nyingine kwa ajili ya ukurasa wako wa masoko.
Ili kupata udhibiti wa kina zaidi, unaweza kusanidi origins kwenye ngazi ya component.
Ili kufanikisha hili, fikiria kutumia watoa huduma kadhaa wa TacoTranslate ndani ya mradi wako.
Tafadhali kumbuka kwamba kamba hiyo hiyo inaweza kupata tafsiri tofauti katika vyanzo tofauti.
Hatimaye, jinsi unavyotenganisha maandishi katika asili kunategemea wewe na mahitaji yako. Hata hivyo, kumbuka kwamba kuwa na maandishi mengi ndani ya asili moja kunaweza kuongeza muda wa upakiaji.
Kushughulikia vibadilishaji
Unapaswa kila wakati kutumia vigezo kwa maudhui yanayobadilika, kama majina ya watumiaji, tarehe, anwani za barua pepe, na mengineyo.
Vigezo katika kamba za maandishi vinatangazwa kwa kutumia mabano mawili, kama {{variable}}
.
import {Translate} from 'tacotranslate/react';
function Greeting() {
const name = 'Juan';
return <Translate string="Hello, {{name}}!" variables={{name}} />;
}
import {useTranslation} from 'tacotranslate/react';
function useGreeting() {
const name = 'Juan';
return useTranslation('Hello, {{name}}!', {variables: {name}});
}
Kusimamia yaliyomo ya HTML
Kwa chaguo-msingi, komponenti ya Translate
inaunga mkono na huonyesha yaliyomo ya HTML. Hata hivyo, unaweza kujiondoa kwenye tabia hii kwa kuweka useDangerouslySetInnerHTML
kuwa false
.
Kuzima uonyesaji wa HTML inashauriwa sana wakati wa kutafsiri maudhui yasiyo ya kuaminika, kama maudhui yanayotengenezwa na watumiaji.
Matokeo yote daima husafishwa kwa kutumia sanitize-html kabla ya kuonyeshwa.
import {Translate} from 'tacotranslate/react';
function Page() {
return (
<Translate
string={`
Welcome to <strong>my</strong> website.
I’m using <a href="{{url}}">TacoTranslate</a> to translate text.
`}
variables={{url: 'https://tacotranslate.com'}}
useDangerouslySetInnerHTML={false}
/>
);
}
Mfano hapo juu utaonyeshwa kama maandishi ya kawaida.