ಡಾಕ್ಯುಮೆಂಟೇಶನ್: 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 ಪ್ರಾಜೆಕ್ಟುಗಳು ನಾವು ಮೂಲಗಳು ಎಂದು ಕರೆಯುವ ಅಂಶಗಳನ್ನು ಒಳಗೊಂಡಿರುತ್ತವೆ. ನಿಮ್ಮ ಸ್ಟ್ರಿಂಗ್‌ಗಳು ಮತ್ತು ಅನುವಾದಗಳಿಗಾಗಿ avugḷannu ಪ್ರವೇಶ ಬಿಂದುಗಳು, ಫೋಲ್ಡರ್‌ಗಳು ಅಥವಾ ಗುಂಪುಗಳೆಂದು ಪರಿಗಣಿಸಿ.

import {TacoTranslate} from 'tacotranslate/react';

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

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

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

ಇದನ್ನು ಸಾಧಿಸಲು, ನಿಮ್ಮ ಯೋಜನೆಯಲ್ಲಿ ಅನೇಕ 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}
		/>
	);
}

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

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