ಡಾಕ್ಯುಮೆಂಟೇಶನ್: TacoTranslate ಬಳಿಸುವುದು

TacoTranslate ಅನ್ನು ಬಳಸುವುದು

Kannada

ಸ್ಟ್ರಿಂಗ್‌ಗಳನ್ನು ಅನುವಾದಿಸುವುದು

ಪ್ರಸ್ತುತ ಸ್ಟ್ರಿಂಗ್‌ಗಳನ್ನು ಅನುವಾದಿಸಲು ಮೂರು ಮಾರ್ಗಗಳಿವೆ: Translate ಘಟಕ, useTranslation ಹುಕ್, ಅಥವಾ translateEntries ಉಪಕರಣ.

Translate ಘಟಕವನ್ನು ಬಳಸುವುದು.
ಅನುವಾದಗಳನ್ನು span ಎಲೆಮೆಂಟ್‌ನೊಳಗೆ ನೀಡುತ್ತದೆ ಮತ್ತು HTML ರೆಂಡರಿಂಗ್ ಅನ್ನು ಬೆಂಬಲಿಸುತ್ತದೆ.

import {Translate} from 'tacotranslate/react';

function Page() {
	return <Translate string="Hello, world!" />;
}

ಉದಾಹರಣೆಗೆ, ನೀವು ಕಂಪೋನಂಟ್‌ನಲ್ಲಿ as="p" ಅನ್ನು ಬಳಸಿ ಎಲಿಮೆಂಟ್ ಪ್ರಕಾರವನ್ನು ಬದಲಾಯಿಸಬಹುದು.

useTranslation ಹಕ್ ಅನ್ನು ಬಳಸುವುದು.
ಅನುವಾದಗಳನ್ನು ಸರಳ ಸ್ಟ್ರಿಂಗ್ ರೂಪದಲ್ಲಿ ಹಿಂತಿರುಗಿಸುತ್ತದೆ. ಉದಾಹರಣೆಗೆ, 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>
	);
}

translateEntries ಉಪಕರಣವನ್ನು ಬಳಸುವುದು.
ಸರ್ವರ್‌ ಪಾರ್ಶ್ವದಲ್ಲಿ ಸ್ಟ್ರಿಂಗ್‌ಗಳನ್ನು ಅನುವಾದಿಸಿ. ನಿಮ್ಮ 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)
	};
}

ಸ್ಟ್ರಿಂಗ್‌ಗಳು ಹೇಗೆ ಅನುವಾದವಾಗುತ್ತವೆ

ಸ್ಟ್ರಿಂಗ್‌ಗಳು ನಮ್ಮ ಸರ್ವರ್‌ಗಳಿಗೆ ಬಂದಾಗ, ನಾವು ಮೊದಲು ಅವನ್ನು ಪರಿಶೀಲಿಸಿ ಸಂರಕ್ಷಿಸುತ್ತೇವೆ ಮತ್ತು ತಕ್ಷಣ ಒಂದು ಯಂತ್ರಭಾಷಾಂತರವನ್ನು ಮರಳಿ ನೀಡುತ್ತೇವೆ. ಯಂತ್ರಭಾಷಾಂತರಗಳು ಸಾಮಾನ್ಯವಾಗಿ ನಮ್ಮ AI ಭಾಷಾಂತರಗಳಿಗಿಂತ ಗುಣಮಟ್ಟದಲ್ಲಿ ಕಡಿಮೆಯಾಗಿದ್ದರೂ, ಅವು ತ್ವರಿತ ಪ್ರಾಥಮಿಕ ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಒದಗಿಸುತ್ತವೆ.

ಒಂದೇ ಸಮಯದಲ್ಲಿ, ನಾವು ನಿಮ್ಮ ಸ್ಟ್ರಿಂಗ್‌ಗಾಗಿ ಉನ್ನತ ಗುಣಮಟ್ಟದ, ಅತ್ಯಾಧುನಿಕ AI ಅನುವಾದವನ್ನು ರಚಿಸಲು ಅಸಿಂಕ್ರೋನಸ್ ಅನುವಾದ ಕೆಲಸವನ್ನು ಪ್ರಾರಂಭಿಸುತ್ತೇವೆ. AI ಅನುವಾದ ಸಿದ್ಧವಾದಾಗ, ಅದು ಯಂತ್ರ ಅನುವಾದವನ್ನು ಬದಲಿಸುತ್ತದೆ ಮತ್ತು ನೀವು ನಿಮ್ಮ ಸ್ಟ್ರಿಂಗ್‌ಗಳಿಗಾಗಿ ಅನುವಾದಗಳನ್ನು ವಿನಂತಿಸುವಾಗ ಅದು ಕಳುಹಿಸಲಾಗುತ್ತದೆ.

ನೀವು ಸ್ಟ್ರಿಂಗ್ ಅನ್ನು ಕೈಯಿಂದ ಅನುವಾದಿಸಿದ್ದರೆ, ಆ ಅನುವಾದಗಳಿಗೆ ಆದ್ಯತೆ ಸಿಗುತ್ತದೆ ಮತ್ತು ಅವುಗಳನ್ನು ಬದಲಾಗಿ ವಾಪಸ್ ನೀಡಲಾಗುತ್ತದೆ.

ಮೂಲಗಳ ಬಳಕೆ

TacoTranslate ಯೋಜನೆಗಳಲ್ಲಿ ನಾವು ಮೂಲಗಳು ಎಂದು ಕರೆಯುವವುಗಳಿವೆ. ಅವುಗಳನ್ನು ನಿಮ್ಮ ಸ್ಟ್ರಿಂಗ್‌ಗಳು ಮತ್ತು ಅನುವಾದಗಳಿಗಾಗಿ ಪ್ರವೇಶ ಬಿಂದುಗಳು, ಫೋಲ್ಡರ್‌ಗಳು ಅಥವಾ ಗುಂಪುಗಳಂತೆ ಪರಿಗಣಿಸಿ.

import {TacoTranslate} from 'tacotranslate/react';

function Menu() {
	return (
		<TacoTranslate origin="application-menu">
			// ...
		</TacoTranslate>
	);
}

Origins ನಿಮಗೆ ಸ್ಟ್ರಿಂಗ್‌ಗಳನ್ನು ಅರ್ಥಪೂರ್ಣ ಕಂಟೇನರ್‌ಗಳಾಗಿ ವಿಭಜಿಸಲು ಅವಕಾಶ ನೀಡುತ್ತದೆ. ಉದಾಹರಣೆಗೆ, ನೀವು ಡಾಕ್ಯುಮೆಂಟೇಶನ್‌ಗಾಗಿ ಒಂದು origin ಹೊಂದಿಸಬಹುದು ಮತ್ತು ನಿಮ್ಮ ಮಾರ್ಕೆಟಿಂಗ್ ಪುಟಕ್ಕಾಗಿ ಮತ್ತೊಂದು origin ಹೊಂದಿಸಬಹುದು.

ಹೆಚ್ಚು ಸೂಕ್ಷ್ಮ ನಿಯಂತ್ರಣಕ್ಕಾಗಿ, ನೀವು ಕಾಂಪೋನಂಟ್ ಮಟ್ಟದಲ್ಲಿ origins ಅನ್ನು ಹೊಂದಿಸಬಹುದು.

ಇದನ್ನು ಸಾಧಿಸಲು, ನಿಮ್ಮ ಯೋಜನೆಯಲ್ಲಿ ಬಹು TacoTranslate ಪ್ರೊವೈಡರ್‌ಗಳನ್ನು ಬಳಸುವುದನ್ನು ಪರಿಗಣಿಸಿ.

ದಯವಿಟ್ಟು ಗಮನಿಸಿ: ಒಂದೇ ಸ್ಟ್ರಿಂಗ್‌ ವಿಭಿನ್ನ ಮೂಲಗಳಲ್ಲಿ ವಿಭಿನ್ನ ಭಾಷಾಂತರಗಳನ್ನು ಪಡೆಯಬಹುದು.

ಕೊನೆಗೆ, ಸ್ಟ್ರಿಂಗ್‌ಗಳನ್ನು ಮೂಲಗಳಾಗಿ ನೀವು ಹೇಗೆ ಬೇರ್ಪಡಿಸುವುದು ಎಂಬುದನ್ನು ನಿಮ್ಮ ಅಗತ್ಯಗಳು ಮತ್ತು ನಿಮ್ಮ decisiones ಅಡಿ ನೀವು ನಿರ್ಧರಿಸಬಹುದು. ಆದರೆ, ಒಂದೇ ಮೂಲದೊಳಗೆ ಅನೇಕ ಸ್ಟ್ರಿಂಗ್‌ಗಳು ಇದ್ದರೆ ಲೋಡಿಂಗ್ ಸಮಯವು ಹೆಚ್ಚಾಗಬಹುದು ಎಂಬುದನ್ನು ಗಮನದಲ್ಲಿಡಿ.

ಚರಗಳ ನಿರ್ವಹಣೆ

ನೀವು ಸದಾ ಡೈನಾಮಿಕ್ ವಿಷಯಗಳಿಗಾಗಿ ವೇರಿಯಬಲ್‌ಗಳನ್ನು ಬಳಸಬೇಕು, ಉದಾಹರಣೆಗೆ ಬಳಕೆದಾರರ ಹೆಸರುಗಳು, ದಿನಾಂಕಗಳು, ಇ‑ಮೇಲ್ ವಿಳಾಸಗಳು ಮತ್ತು ಇತ್ಯಾದಿ.

ಸ್ಟ್ರಿಂಗ್‌ಗಳಲ್ಲಿ ಇರುವ ಚರಗಳನ್ನು ದ್ವಿಗುಣ ಬ್ರಾಕೆಟ್‌ಗಳ ಮೂಲಕ ಘೋಷಿಸಲಾಗುತ್ತದೆ, ಉದಾಹರಣೆಗೆ {{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}});
}

HTML ವಿಷಯ ನಿರ್ವಹಣೆ

ಮೂಲರೂಪವಾಗಿ, Translate ಕಂಪೋನಂಟ್ HTML ವಿಷಯವನ್ನು ಬೆಂಬಲಿಸಿ ಪ್ರದರ್ಶಿಸುತ್ತದೆ. ಆದರೆ ನೀವು ಈ ವರ್ತನೆಯನ್ನು ನಿಷ್ಕ್ರಿಯಗೊಳಿಸಲು useDangerouslySetInnerHTML ಅನ್ನು false ಎಂದು ಹೊಂದಿಸಬಹುದು.

ಬಳಕೆದಾರರ ಮೂಲಕ ಸೃಷ್ಟಿಸಲಾದ ವಿಷಯಗಳಂತಹ ನಂಬಲಾರದ ವಿಷಯಗಳನ್ನು ಅನುವಾದಿಸುವಾಗ HTML ರೆಂಡರಿಂಗ್ ಅನ್ನು ನಿಷ್ಕ್ರಿಯಗೊಳಿಸುವುದು ದೃಢವಾಗಿ ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ.

ಎಲ್ಲಾ ಔಟ್‌ಪುಟ್‌ಗಳನ್ನು ಪ್ರದರ್ಶಿಸುವ ಮೊದಲು ಯಾವಾಗಲೂ sanitize-html ಮೂಲಕ ಸ್ವಚ್ಛೀಕರಿಸಲಾಗುತ್ತದೆ.

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

ಮೇಲಿನ ಉದಾಹರಣೆ ಸಾಮಾನ್ಯ ಪಠ್ಯವಾಗಿ ಪ್ರದರ್ಶಿಸಲಾಗುತ್ತದೆ.

ಸರ್ವರ್-ಸೈಡ್ ರೆಂಡರಿಂಗ್