@siamf/google-translate
Version:
A nodejs package for translating text using google translate for free! It also support batching translation!
218 lines (167 loc) • 6.72 kB
Markdown
A nodejs package for translating text using google translate for free! It also support batching translation!
A Node.js package for translating text using Google Translate for free, with support for batching translation, involves several steps. Below is a detailed guide on how you can achieve this using the google-translate-nodejs package.
<a href="https://www.buymeacoffee.com/siamahnaf" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
- Fast and lightweight
- Batching translation. You can translate one text to many target language at a time.
- No unnecessary Dependencies
- Now Multi translation is supported. You can translate a object into multiple languages
- Small in Size (16KB)
## Installing
Using npm
```bash
$ npm install @siamf/google-translate
```
## Batch Translation Example
```javascript
import { translate } from "@siamf/google-translate";
const { data } = await translate.batch("How are you", ["bn", "fr", "en", "es", "de", "ar", "ja", "ko", "ru", "pt", "it", "hi", "zh", "tr", "nl", "sv", "pl", "vi", "th"]);
console.log(data);
//And result will be printed like-
{
source: { lan: 'auto', text: 'How are you' },
target: [
{ lan: 'bn', text: 'আপনি কেমন আছেন' },
{ lan: 'fr', text: 'Comment vas-tu' },
{ lan: 'en', text: 'How are you' },
{ lan: 'es', text: 'Cómo estás' },
{ lan: 'de', text: 'Wie geht es dir' },
{ lan: 'ar', text: 'كيف حالك' },
{ lan: 'ja', text: '元気ですか' },
{ lan: 'ko', text: '어떻게 지내세요' },
{ lan: 'ru', text: 'Как вы' },
{ lan: 'pt', text: 'Como vai' },
{ lan: 'it', text: 'Come stai' },
{ lan: 'hi', text: 'आप कैसे हैं?' },
{ lan: 'zh', text: '你好吗' },
{ lan: 'tr', text: 'Nasılsın' },
{ lan: 'nl', text: 'Hoe is het' },
{ lan: 'sv', text: 'Hur mår du' },
{ lan: 'pl', text: 'Jak się masz' },
{ lan: 'vi', text: 'Bạn có khỏe không' },
{ lan: 'th', text: 'คุณเป็นอย่างไร' }
]
}
//For typescript you can import Response Types also-
import { BatchResponse } from "@siamf/google-translate";
```
- Type: `String`
- Description: The main text which need to be translated
- Type: `String[]` `(String array)`
- Description: A array of string with lanuage code
- Type: `Object`
- Description: Options Object (Optional)
##### from
- Type: `String`
- Description: From Language
- Default: `auto`
## Single Translation Example
```javascript
import { translate } from "@siamf/google-translate";
const { data } = await translate.single("How are you", "fr");
console.log(data);
//And result will be printed like-
{
source: { lan: 'auto', text: 'How are you?' },
target: { lan: 'fr', text: 'Comment vas-tu?' }
}
//For typescript you can import Response Types also-
import { SingleResponse } from "@siamf/google-translate";
```
- Type: `String`
- Description: The main text which need to be translated
- Type: `String`
- Description: The target language code
- Type: `Object`
- Description: Options Object (Optional)
##### from
- Type: `String`
- Description: From Language
- Default: `auto`
## Multi Translation Example
```javascript
import { translate } from "@siamf/google-translate";
const text = {
title: "How are you?",
description: "Here's a collection of news, notes, and highlights from Wednesday's on-field action.",
otherText: "Other text"
}
const target = ["bn", "fr", "es", "ar", "de"]
const { data } = await translate.multi(text, target);
console.log(data);
//And result will be printed like-
{
source: { lan: 'auto' },
target: [
{
languageCode: 'bn',
title: 'আপনি কেমন আছেন?',
description: 'এখানে বুধবারের মাঠের অ্যাকশন থেকে খবর, নোট এবং হাইলাইটগুলির একটি সংগ্রহ রয়েছে৷',
otherText: 'অন্যান্য পাঠ্য'
},
{
languageCode: 'fr',
title: 'Comment vas-tu?',
description: "Voici une collection d'actualités, de notes et de faits saillants de l'action sur le terrain de mercredi.",
otherText: 'Autre texte'
},
{
languageCode: 'es',
title: '¿Cómo estás?',
description: 'Aquí hay una colección de noticias, notas y momentos destacados de la acción en el campo del miércoles.',
otherText: 'Otro texto'
},
{
languageCode: 'ar',
title: 'كيف حالك؟',
description: 'فيما يلي مجموعة من الأخبار والملاحظات والأحداث البارزة من الأحداث الميدانية يوم الأربعاء.',
otherText: 'نص آخر'
},
{
languageCode: 'de',
title: 'Wie geht es dir?',
description: 'Hier finden Sie eine Sammlung von Neuigkeiten, Notizen und Highlights vom Spielfeldeinsatz am Mittwoch.',
otherText: 'Anderer Text'
}
]
}
//For typescript you can import Response Types also-
import { MultiResponse } from "@siamf/google-translate";
```
- Type: `Object`
- Description: The main text which need to be translated. It can be any object.
- Type: `String[]`
- Description: The target languages code. Array of string.
- Type: `Object`
- Description: Options Object (Optional)
##### from
- Type: `String`
- Description: From Language
- Default: `auto`
## Issues or correction
If you face any issues to any function, please let me know by creating a issue on github.
## Stay in touch
- Author - [Siam Ahnaf](https://www.siamahnaf.com/)
- Website - [https://www.siamahnaf.com/](https://www.siamahnaf.com/)
- Twitter - [https://twitter.com/siamahnaf198](https://twitter.com/siamahnaf198)
- Github - [https://github.com/siamahnaf](https://github.com/siamahnaf)
## License
Released under [__MIT license__](https://opensource.org/licenses/MIT).