Help:Extension:Translate/Page translation example

Welcome! After completing this tutorial you'll know how to create and manage translatable pages using Translate extension. We aim to keep this tutorial as short as possible while introducing all the basic concepts and tasks. After completing this tutorial you can use the in-depth documentation about page translation feature.

Step 1: Before starting
This tutorial assumes that Translate extension is already installed and configured. You might already have a page in mind, or you can use the example page provided below to try out the steps in this tutorial in your own wiki.

This is a page describing the imaginary municipality of Fréttinga.

Fréttinga is a small municipality in Mungoland, located in the Bamungo island. It hosts a population of about 400 people. It has some agriculture and fishing and tourists like to visit it in the summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day.


 * 1. Go to the page Fréttinga in your wiki and click create.
 * 2. Paste the above source code and save it.

Step 2: Preparations
Now we have a page with some text. If the page is still seeing lots of changes and big refactorings, it is better to wait until the edits slow down to normal level before adding the page into the translation system, just to avoid causing too much work for translators who need to keep up with the changes.


 * 3. Edit Fréttinga
 * 4. Wrap the whole content inside ... tags like shown below
 * 5. Save the page

&lt;translate> Fréttinga is a small municipality in Mungoland, located in the Bamungo island. It hosts population of about 400 people. It has some agriculture and fishing and tourists like to visit it in the summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. &lt;/translate>

Step 3: Enabling translations
[Screenshot of the link] [Screenshot of the marking page]

After saving the page, you will see a text saying "Mark this page for translation" (or "This page contains changes which are not marked for translation." if you are not a translation admin). Click the link. The page has been automatically split into three translation units. The first unit is the title of the page and two following units are the paragraphs of the page source. These are the basics items of translatable pages: each unit is independent; it can and must be translated as a whole; changes to page content are tracked into unit level and units can be rearranged or deleted. There is also a view of the page translation page template, but let's ignore that for now and return into that in later steps. You can give names to the sections, but let's go with the defaults.


 * 6. Click the "Mark this page for translation" link
 * 7. Ensure that the page body is split into two units correctly
 * 8. Click the ZZZ button
 * 9. Return to the page

Now you will see a new link at the top, KKK, that lets translators to translate the page. You might have a look at the translation tutorial which uses this page as an example and try out few translations now. Then return here for the next step.

Step 4: Doing changes
[Screenshot of page with outdated translations] Tracking changes is a very important feature, so let's do some and see how it works. When you open the page for editing you will see that it has been modified with markers like. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker too. When deleting a unit, delete the marker too. When adding new paragraphs, don't try to add the markers manually, it may confuse the software which will do it for you anyway.

&lt;languages /> &lt;translate> &lt;!--T:1--> Fréttinga is a small municipality in Mungoland, located in the Bamungo island. It hosts population of about 400 people. It has some agriculture and fishing and tourists like to visit it in the summer time. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. In 2009 January the roof of the church in the island fell down. It was rebuilt collaboratively in the following summer. &lt;/translate>


 * 10. Make some additions as highlighted above
 * 11. Click the "Mark this page for translation" link at the top
 * 12. Fuzzy [check default value] [explain term?]
 * 13. Click the ZZZZ button
 * 14. Return to the original page

If you did translations as suggested in previous step, you can now see those translations linked at the top. You will also see that the translation is not 100% up to date. If you go look at the translated version, you will see the new paragraph, and the changed paragraphs will be highlighted. This is shown in the screenshot. Translators will also be asked to update the translations where needed (see the tutorial). All these changes are done automatically under the "FuzzyBot" default user name (from the "fuzzy" marker added to outdated translations).

You now know the basics, but this tutorial will continue with more things that you are likely to encounter.

Step 5: Adding other wiki elements
We have a basic translatable page now, but it is very dull. Let's add an image and some other stuff to make it look more like a normal wiki page and see how those elements interact with translation. [Also the removal of the paragraph replaced by the list]


 * Add an image, a category and a list to the page as shown below. [at least a wikilink! with or without description?[//meta.wikimedia.org/w/index.php?title=Terms_of_use&diff=3182023&oldid=3182016]]
 * Save the page
 * Click the link JJJJ on the top
 * Verify that the changes look correct
 * Click the MMMM button
 * Return to the page

&lt;languages /> &lt;translate> &lt;!--T:1--> Fréttinga is a small municipality in Mungoland, located in the Bamungo island. It hosts a population of about 400 people. It has some agriculture and fishing and tourists like to visit it in the summer time. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. Main events: * The roof of the church fell down in 2009 * New church was built in 1877 &lt;/translate>

[in this simplest example, should the category be translated or be part of the layout?]

Step 6: Preparing for future
[Translation page template?]

[Mention about discouraging, page deletion and moving]