The Microsoft Document Translator translates Microsoft Office, plain text, HTML, PDF files and SRT caption files, from and to any of the 60+ languages supported by the Microsoft Translator web service. Document Translator uses the customer's own credentials and subscription to perform the Translation. Document Translator can also use custom MT systems trained via Custom Translator (https://portal.customtranslator.azure.ai) or the Translator Hub (https://microsoft.com/translator/hub.aspx). It will determine automatically whether the provided custom category is a Custom Translator or a Translator Hub category. Document Translator uses Version 3 of the Translator API, unless the used category points to a Translator Hub custom system.
Translate one or more Office documents, plain text HTML or PDF documents to another language, in one go.
- Translate an Office document and receive a translated Office document in full fidelity, as an Office document. The translated Office document is fully editable like any normal Office document.
- Translate a text-based PDF document and receive a translated document in Microsoft Word.
- Translate HTML or plain text files and receive translated HTML or plain text.
- Enter account credentials
- Define a Hub-customized system to use (optional)
- Define a CUstom Translator-customized system to use (optional)
- Select the files to translate
- Choose from and to languages. Specifying a "From"-language is optional, in that case the system auto-detects the language.
- Document Translator creates translated files in the same folder as the original, with a name like originalname.language.docx
Runs on Windows 7 and above. Requires .Net Framework 4.5. The Release is an MSI package, install directly in Windows.
- Start Microsoft Document Translator from the Start Menu.
- Visit the settings page and follow the links to subscribe to Microsoft Translator. Free for up to 2 million characters per month.
- On the settings page, follow the link to obtain your API key, and copy the key to the settings page.
- Go to the document translation page and select the documents to translate.
- Select the from and to languages.
- Hit Go.
Document Translator can be run from the command line:
Translate documents:
DocumentTranslatorCmd translatedocuments /documents:d:\testdocuments\*.docx /from:en /to:de,el
*When a wildcard is given, Document Translator recurses through subdirectories.
Set credentials:
DocumentTranslatorCmd setcredentials /APIkey:AzureKey
Get Word Alignments
DocumentTranslatorCmd getalignments /documents:test.txt /from:en /to:fr
Builds a CSV file containing 3 columns: source, target, and word alignment information in the format
[[SourceTextStartIndex]:[SourceTextEndIndex]–[TgtTextStartIndex]:[TgtTextEndIndex]] *
for every word of the source. The information for each word is separated by a space, including for non-space-separated languages (scripts) like Chinese. Example alignment string: "0:0-7:10 1:2-11:20 3:4-0:3 3:4-4:6 5:5-21:21".
In other words, the colon separates start and end index, the dash separates the languages, and space separates the words. One word may align with zero, one, or multiple words in the other language, and the aligned words may be non-contiguous. When no alignment information is available, the Alignment element will be empty. No error.
Microsoft Document Translator is written in C#, compiled in Visual Studio 2017.
It depends on
- First Floor MUI
- Microsoft.Practices.Prism for the messaging and interfaces
- OpenXml for the Office document handling
- Wix Toolkit for the installer
- HTML Agility Pack
- Newtonsoft JSON
*You need to install these separately if you want to build.
This project uses:
(c) First Floor Software
Under the Ms-PL: https://github.com/firstfloorsoftware/mui/blob/master/LICENSE.md
Available from: https://github.com/firstfloorsoftware/mui
Under the Ms-PL: : https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE
Available from: https://github.com/zzzprojects/html-agility-pack
All requests to the Translator service are SSL encrypted, using the certificate of the Microsoft Translator service. Document Translator stores the Azure Key unencypted in the user profile on the machine. For enterprise use we recommend to implement a more secure storage mechanism.
For questions and support please turn to the Microsoft Translator developer forum:
https://social.msdn.microsoft.com/Forums/en-US/home?category=translation
Please branch and contribute back your enhancements. Especially interested in additional file formats.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.