Language translation plugin that uses Microsoft's Translator API.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
locales
spec
templates
.gitignore
Gemfile
LICENSE
README.md
Rakefile
lita-translation.gemspec

README.md

lita-translation

Language translation plugin that uses Microsoft's Translator API.

Installation

Add lita-translation to your Lita instance's Gemfile:

gem "lita-translation"

Configuration

This plugin requires you to obtain a client id and secret for Microsoft's Translation API. Register an account at the Microsoft Azure Marketplace, and then register an application that uses the translation API service.

Required attributes

  • client_id (String) - A human readable identifier for your client that you provide on registration.
  • client_secret (String) - A key generated by Microsoft for your client.

Example

Lita.configure do |config|
  config.handlers.translation.client_id = "my-translation-id"
  config.handlers.translation.client_secret = "some key"
end

Usage

An OAuth token is automatically requested by the plugin whenever a fresh one is unavailable.

Microsoft uses ISO-639 codes to identify languages. Klingon is available.

  • languages - List language codes supported by Microsoft's Translator API
  • determine '[text]' - Determine language of the given text
  • translate '[text]' to [code] (from [code]) - Translate the given text from one language to another
  • translate me to [code] (from [code]) - Begin auto-translating all user's speech to the given language
  • stop translating me - End any auto-translation

Source language is optional during translation. Microsoft will attempt to detect the source language if none is supplied.

License

MIT