This is article is a stub for information about using external translation tools with wiki content.

This article is mostly of interest to members of the internal Microsoft community that may want to work with professional translators to ensure that a critical wiki article is published at a specific time in a specific set of languages.

Why use external translation tools for Wiki content?


In short, for the same reason that some contributors use external editing programs instead of the the built-in editor: they give a higher degree of control and allow spending more energy on the actual content than on formatting it.
Most commercial or large scale translation efforts rely on Computer Assisted Translation (CAT) tools for the same reasons: they allow the translators to be more effective and focus on translation itself.

Step-by-step guide

In this example, we'll assume you wish to translate an existing English Wiki article.
You will first get the English text, save it locally, translate it with your favorite translation process, and finally publish it to the wiki. You can see some examples of finished work in the "Examples" section.

Getting the source text
  • Go to your source article. Ensure you are logged in.
  • Go to the "EDIT" tab and select the HTML view in the editor.
  • Select the HTML text and copy it into a file: article.htm.

 Note 1: the article also has a title and tags that are not part of the HTML text. These will need to translated separately.
 Note 2: practices for tagging localized articles are evolving: some authors translate some tags, others leave some in English. 

Performing the translation
  • Use your favorite HTML translation process to translate the above file
    Note that the file is not "true" HTML and the following may require tweaking your tools configuration:
    - Lack of HTML header in the file
    - Wiki specific markup such as Table of Content ("[ TOC ]") and internal Wiki links ("[ [ article name, display text ] ]" or "[ [ article name ] ]") 
  • Save the translation
Publishing the translation on the Wiki
  • Go to a Wiki page and click the "Post An Article" link
  • Select the HTML view in the editor
  • Paste the translated HTML from the previous step
  • Paste in translated Title, adding a language code as explained in Wiki: Non-English Language Title Guidelines  
  • Add translated Tags. Make sure to add a tag with the same language code as used for the title
  • Verify that the page looks good in the "Design" view. Make corrections as needed.
  • Save the page and verify the page looks OK in the "Design" view. Make corrections as needed.

If you are planning to translate an article in multiple languages, you can save time by validating that the above process works end-to-end on a one pilot language (this could be machine translated text or a pseudo-language). Make adjustments to the English source as needed until the translated page looks good. This will save having to correct each language individually.

This article is focussed on the mechanics of using an external translation tool. The Wiki: Non-English Language Content Guidelines article has more general information about translation.

Translation in a corporate environment

Larger companies often have dedicated localization teams. These teams have expertise in engineering and business aspects of translation. They are typically most effective at handling an "English files in, translated files out" workflow and working with common file formats. This article has been written with the assumption that the "Performing the translation" step could be done in partnership with such a team. So if you own a technology but are not usually involved in translation, you may want to consider finding a "localization team" and reading this information together. As usual, feel free to edit this article if you feel it can be improved. 

Examples of professional translation on the Wiki