azure-web-translate

1.0.5 • Public • Published

Translate HTML with Azure Translator API

This package allows you to translate HTML content from a given URL using the Azure Translator API. It scrapes text from the webpage, translates it using the Azure Translator API, and returns the translated HTML content.

Features

  • Translates the text content of an HTML webpage.
  • Skips non-translatable elements like <script>, <iframe>, <noscript>, <style>, <svg>, and <video>.
  • Leverages the Azure Translator API for high-quality translations.
  • Stores translations in a JSON file for easy access and reuse.

Installation

To use this package in your project, install it via npm:

npm i azure-web-translate

Usage

Basic Example

Below is an example of how to use the translateHTML function to translate a webpage to French:

const translateWebpage  = require('azure-web-translate');

const url = 'https://example.com';
const targetLanguage = 'ru';

const AZURE_TRANSLATOR_KEY = process.env.AZURE_TRANSLATOR_KEY;
const AZURE_TRANSLATOR_ENDPOINT = process.env.AZURE_TRANSLATOR_ENDPOINT;
const AZURE_LOCATION = process.env.AZURE_LOCATION;

translateWebpage(url, targetLanguage, AZURE_TRANSLATOR_KEY, AZURE_TRANSLATOR_ENDPOINT, AZURE_LOCATION)
  .then(translatedHtml => {
    const fs = require('fs');
    fs.writeFileSync('translated.html', translatedHtml);
  })
  .catch(error => {
    console.error('Error:', error);
  });

translateHTML(url, targetLanguage, azureKey, azureRegion, options)

Translates the HTML content of a given URL.

  • url (string): The URL of the webpage to translate.
  • targetLanguage (string): The target language code (e.g., 'fr' for French).
  • azureKey (string): Your Azure Translator API key.
  • azureRegion (string): Your Azure region.

Returns a Promise that resolves with the translated HTML content.

Limitations

  • The Azure Translator API has rate limits and character quotas. Ensure your Azure account has sufficient quota for your translation needs.
  • Very large webpages may require multiple API calls and take longer to translate.
  • Some complex HTML structures or dynamically loaded content may not translate perfectly.

Readme

Keywords

none

Package Sidebar

Install

npm i azure-web-translate

Weekly Downloads

6

Version

1.0.5

License

ISC

Unpacked Size

6.6 kB

Total Files

4

Last publish

Collaborators

  • shubhamm26