Documentación de LXY-TRADUCTOR / LXY-TRANSLATOR Documentation

Descripción / Description

Español:
Este módulo permite traducir texto entre diferentes idiomas usando la API de Google Translate. Se proporciona una función sencilla para traducir cadenas de texto a cualquier idioma soportado por la API.

English:
This module allows you to translate text between different languages using the Google Translate API. A simple function is provided to translate text strings to any language supported by the API.

Instalación / Installation

Español:

Para comenzar, primero debes instalar el paquete usando npm:

npm install lxy-translator

English:

To get started, you need to install the package using npm:

npm install lxy-translator

Uso Básico / Basic Usage

Español:

Una vez que hayas instalado el paquete, puedes importarlo y usarlo de la siguiente manera:

1. Importar el módulo:

   import translateText from 'lxy-translator';

2. Llamar a la función de traducción:

   (async () => {
     try {
       const translatedText = await translateText('Hola, ¿cómo estás?', 'en');
       console.log(translatedText);  // "Hello, how are you?"
     } catch (error) {
       console.error(error.message);
     }
   })();

English:

Once you’ve installed the package, you can import it and use it as follows:

1. Import the module:

   import translateText from 'lxy-translator';

2. Call the translation function:

   (async () => {
     try {
       const translatedText = await translateText('Hola, ¿cómo estás?', 'en');
       console.log(translatedText);  // "Hello, how are you?"
     } catch (error) {
       console.error(error.message);
     }
   })();

Función Principal / Main Function

Español:

La función principal de este módulo es translateText. Esta función toma dos parámetros:

• text (string): El texto que se desea traducir.
• toLanguage (string): El código del idioma al que se traducirá el texto. Ejemplos de códigos de idioma incluyen:
  • es para español
  • en para inglés
  • fr para francés
  • de para alemán

Ejemplo de uso:

const translated = await translateText('Hola, ¿cómo estás?', 'en');
console.log(translated);  // "Hello, how are you?"

English:

The main function of this module is translateText. This function takes two parameters:

• text (string): The text you want to translate.
• toLanguage (string): The language code to which the text will be translated. Examples of language codes include:
  • es for Spanish
  • en for English
  • fr for French
  • de for German

Usage example:

const translated = await translateText('Hola, ¿cómo estás?', 'en');
console.log(translated);  // "Hello, how are you?"

Manejo de Errores / Error Handling

Español:

Si ocurre un error durante la traducción (por ejemplo, si el idioma especificado no es válido), la función translateText lanzará una excepción. Puedes manejarla con un bloque try-catch:

try {
  const translatedText = await translateText('Texto', 'xyz');  // Idioma no válido
} catch (error) {
  console.error('Error al traducir:', error.message);
}

English:

If an error occurs during translation (for example, if the specified language is invalid), the translateText function will throw an exception. You can handle it using a try-catch block:

try {
  const translatedText = await translateText('Text', 'xyz');  // Invalid language
} catch (error) {
  console.error('Error translating:', error.message);
}

Opciones de Idioma / Supported Languages

Español:

Este módulo utiliza la API de Google Translate, que soporta muchos idiomas. Aquí hay algunos ejemplos de códigos de idioma soportados:

• Español: es
• Inglés: en
• Francés: fr
• Alemán: de
• Italiano: it
• Portugués: pt
• Ruso: ru

Para ver la lista completa de idiomas soportados, consulta la documentación oficial de Google Translate.

English:

This module uses the Google Translate API, which supports many languages. Here are some examples of supported language codes:

• Spanish: es
• English: en
• French: fr
• German: de
• Italian: it
• Portuguese: pt
• Russian: ru

For a full list of supported languages, refer to the official Google Translate documentation.

Contribuir / Contributing

Español:

Si deseas contribuir al proyecto, siéntete libre de hacer un fork del repositorio, realizar mejoras, y enviar un pull request. Asegúrate de seguir las buenas prácticas de programación y agregar pruebas cuando sea necesario.

English:

If you want to contribute to the project, feel free to fork the repository, make improvements, and submit a pull request. Please make sure to follow best coding practices and add tests where necessary.

Licencia / License

Este módulo está bajo la licencia MIT. Puedes ver los detalles completos en el archivo LICENSE.

Desarrollador / Developer

@LuxyTeam

¡Gracias por usar este módulo! / Thanks for using this module!