Tutorial: Translate a page

This tutorial gives an overview about how the translation service work. It describes how to translate to German and French a page that is in English. The page has a News widget that is displaying one news item.

1. Translate the News item
   1. Create a news item in English and publish it.
   2. In the News grid, expand the Actions dropdown of the news item and click Send for translation… 
   3. Select German and French and click Mark for translation.
2. Translate the page
   1. Create and publish a page in English.
   2. On the page, drop the News widget and configure it to display the News item you have created.
   3. In the Pages grid, expand the Actions dropdown of the news item and click Send for translation… 
   4. Select German and French and click Mark for translation.
3. Create the translation project and export the translation items.
   You send items to translation agencies using projects. One project can hold one or several translations.
   1. Open the Translations module by clicking Administration » Translations.
      Under Marked for translation tab, you can see four translation items:
      • Translate the page from English to German
      • Translate the page from English to French
      • Translate the news item from English to German
      • Translate the news item from English to French
   2. Select all four translation items and in click Send selected items for translation.
      Each time you send for translation one or more items, a separate translation project is created. If you send for translation all items at once, only one project is created.
   3. Choose the translation service.
      In this example, select Export to XLIFF file.
      

      NOTE: If you have chosen to send the items to a translation service, they automatically appear in the system of the translation agency. If you have chosen to use XLIFF files that you manually send to a translation agency, you can download the files from by Projects tab.

      When the items are sent for translation, they disappear from the Marked for translation tab and appear under the Sent tab.
      A translation project is automatically created and appears in by Projects tab.

4. Translate the files
   
   1. Download the XLIFF files from by Projects tab.
   2. Expand the Actions link of your project and click Download.
      Four .xlf files are downloaded to your computer – one file for each translation item.
      

      NOTE: The .xlf file is an XML file. It contains the source and target languages. Inside the <source> tags are the translatable units. After the <source> tag, the translator can insert a <target> tag that will hold the translation or the translation can be inserted in the <source> tag, overwriting the original text. If Sitefinity CMS does not find a <target> tag, it will take the <source> tag as the translated text.

   3. Send the files to a translator over email and receive the translated files back.
5. Import the translations in Sitefinity.
   
   1. Click Administration » Translations.
   2. In the Sent tab, click Import XLIFF file.
   3. Select the files from your computer and import them.
      Translation items disappear from the Sent tab and appear in the Translated tab.
      Sitefinity CMS automatically creates the following items:
      
      • German and French version of the news item.
      • German and French version of the page.
        The German and French versions of the page are synced with the English.
        For more information, see Page translation specifics.