###stata-translate is a tool for translating Stata strings using the Google Translate API

###Overview

stata-translate takes advantage of Stata's Java foreign interface to provide one-step translation of strings from within Stata. A new command, gtranslate, is provided by the gtranslate.ado file. The ado file calls a Java class that can access the Stata data model through the foreign interface. This Java class relies on an included additional Java class which provides access to the Google Translate REST API.

###Installation

We intend to distribute a compiled jar file through the Boston College Statistical Software Components (SSC) archive, the main repository for Stata plugins. A copy will also be available here. Until then, follow the instructions for compilation.

###Compilation

Clone this repository and compile using maven: mvn install (add -DskipTests to skip testing). Copy or symlink target/stata-translate-*-jar-with-dependencies.jar and src/main/stata/gtranslate.ado to your Stata ado path.

If you wish to run the junit tests, you must modify src/main/resources/config.properties to include your Google Translate API key.

Maven must be able to find your copy of stata-sfi.jar for it to compile the project. Install the jar file to your local maven repository: mvn install:install-file -Dfile=stata-sfi.jar -DgroupId=com.stata.sfi -DartifactId=sfi -Dversion=13 -Dpackaging=jar

###Use

stata-translate is intended to be used through the gtranslate.ado client. See gtranslate.sthlp for instructions. Stata's help gtranslate command renders the markup in the sthlp file.

###License

stata-translate is licensed under version 2.0 of the Apache License. The jar releases contain bundled dependencies redistributed under the terms of those dependencies' licenses.