ಡಾಕ್ಯುಮೆಂಟೇಶನ್: 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 ಪ್ರೊವೈಡರ್‌ಗಳನ್ನು ಬಳಸುವುದು ನಿಮ್ಮ ಯೋಜನೆಯಲ್ಲಿ.

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

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

ಚರಗಳನ್ನು ನಿರ್ವಹಿಸುವುದು

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

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

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

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