ಡಾಕ್ಯುಮೆಂಟೇಶನ್: 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 ಅನ್ನು ಸ್ಥಾಪಿಸಬಹುದು.

ಇದನ್ನು ಸಾಧಿಸಲು, ನಿಮ್ಮ ಪ್ರಾಜೆಕ್ಟ್‌ನಲ್ಲಿ ಬಹು TacoTranslate ಪೂರೈಕೆದಾರರನ್ನು ಬಳಸುವುದನ್ನು ಪರಿಗಣಿಸಿ.

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

ಅಂತಿಮವಾಗಿ, ಸ್ಟ್ರಿಂಗ್‌ಗಳನ್ನು origins‌ಗಳಲ್ಲಿ ನೀವು ಹೇಗೆ ವಿಭಜಿಸುವುದು ಎಂಬುದು ನಿಮಗಾಗಿಯೇ ಮತ್ತು ನಿಮ್ಮ ಅಗತ್ಯಗಳ ಮೇಲೆಯೇ ಅವಲಂಬಿತವಾಗಿದೆ. ಆದರೆ, ಒಂದು origin ಒಳಗೆ ಹೆಚ್ಚಿನ ಸ್ಟ್ರಿಂಗ್‌ಗಳು ಇದ್ದರೆ ಲೋಡಿಂಗ್ ಸಮಯ ಹೆಚ್ಚಾಗಬಹುದು ಎಂದು ಗಮನಿಸಿ.

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

ಗತಿಶೀಲ ವಿಷಯಗಳಿಗಾಗಿ (ಉದಾಹರಣೆಗೆ ಬಳಕೆದಾರರ ಹೆಸರುಗಳು, ದಿನಾಂಕಗಳು, ಇ-ಮೇಲ್ ವಿಳಾಸಗಳು ಮತ್ತು ಇತ್ಯಾದಿ) ನೀವು ಯಾವಾಗಲೂ ವೆರಿಯಬಲ್ಗಳನ್ನು ಬಳಸಬೇಕು.

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

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

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