Bruke TacoTranslate
Oversette strenger
Det finnes for øyeblikket tre måter å oversette strenger på: Translate-komponenten, useTranslation-hooken eller translateEntries-verktøyet.
Bruk av Translate-komponenten.
Viser oversettelser i et span-element og støtter gjengivelse av HTML.
import {Translate} from 'tacotranslate/react';
function Page() {
return <Translate string="Hello, world!" />;
}Du kan endre elementtypen ved å bruke for eksempel as="p" på komponenten.
Bruk av useTranslation-hooken.
Returnerer oversettelser som en ren tekststreng. Nyttig for eksempel i meta-tagger.
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>
);
}Bruk av translateEntries-verktøyet.
Oversett strenger på serversiden. Gjør OpenGraph-bildene dine enda bedre.
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)
};
}Hvordan strenger oversettes
Når strenger når serverne våre, validerer og lagrer vi dem først, og returnerer deretter umiddelbart en maskinoversettelse. Selv om maskinoversettelser generelt har lavere kvalitet enn AI-oversettelsene våre, gir de et raskt første svar.
Samtidig starter vi en asynkron oversettelsesjobb for å generere en AI-oversettelse av høy kvalitet og med toppmoderne teknologi for strengen din. Når AI-oversettelsen er klar, erstatter den maskinoversettelsen og sendes hver gang du ber om oversettelser av strengene dine.
Hvis du har oversatt en streng manuelt, har disse oversettelsene forrang og blir returnert i stedet.
Bruke opphav
TacoTranslate-prosjekter inneholder det vi kaller opprinnelser. Tenk på dem som inngangspunkter, mapper eller grupper for strengene og oversettelsene dine.
import {TacoTranslate} from 'tacotranslate/react';
function Menu() {
return (
<TacoTranslate origin="application-menu">
// ...
</TacoTranslate>
);
}Opprinnelser lar deg dele opp strenger i meningsfulle beholdere. Du kan for eksempel ha én opprinnelse for dokumentasjon og en annen for markedsføringssiden din.
For mer granulær kontroll kan du sette opp origins på komponentnivå.
For å oppnå dette kan du vurdere å bruke flere TacoTranslate-leverandører i prosjektet.
Vær oppmerksom på at den samme strengen kan få ulike oversettelser i forskjellige opphav.
Til syvende og sist er det opp til deg og dine behov hvordan du deler inn strenger i opphav. Vær imidlertid oppmerksom på at mange strenger i ett opphav kan øke innlastingstidene.
Håndtering av variabler
Du bør alltid bruke variabler for dynamisk innhold, for eksempel brukernavn, datoer, e-postadresser og mer.
Variabler i strenger deklareres ved hjelp av doble klammeparenteser, som {{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}});
}Administrere HTML-innhold
Som standard støtter og gjengir Translate-komponenten HTML-innhold. Du kan imidlertid velge bort denne funksjonaliteten ved å angi useDangerouslySetInnerHTML til false.
Det anbefales på det sterkeste å deaktivere HTML-gjengivelse når du oversetter innhold du ikke stoler på, for eksempel brukergenerert innhold.
All utdata blir alltid renset med sanitize-html før de gjengis.
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}
/>
);
}Eksempelet ovenfor vil bli gjengitt som ren tekst.