Help:Extension:Translate/Page translation example/fr

Bienvenue ! Une fois ce tutoriel achevé, vous saurez comment créer et gérer les pages traduisibles en utilisant l'extension Translate (Traduire). Nous souhaitons garder ce tutoriel aussi concis que possible, bien qu'il présente tous les concepts et tâches de base. Après avoir achevé ce tutoriel, vous pourrez utiliser la documentation plus approfondie concernant l'outil de traduction de page.

There is also a set of video tutorials that parallel part of this tutorial that you can use to help learn how to use the Translate extension:

Étape n°1 : Avant de commencer
Ce tutoriel suppose que l'extension Translate est déjà installée et configurée. Peut-être avez-vous déjà en tête une page qui nécessite une traduction, sinon vous pouvez utiliser la page d'exemple disponible ci-dessous pour exécuter les étapes de ce tutoriel dans votre propre wiki.

Voici une page décrivant la municipalité imaginaire de Fréttinga.

Here is the wikicode associated to it :

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


 * 1. Go to the page  in your wiki (or a draft page) and click create.
 * 2. Paste the above content and save it.

Étape n°2 : Préparation
Maintenant, nous disposons d'une page avec un texte.

Si la page est toujours sujette à de multiples modifications, il est peut-être préférable d'attendre que le nombre de modifications diminue jusqu'à un niveau acceptable avant d'ajouter la page dans le système de traduction. Cela évitera une surcharge de travail pour les traducteurs qui devront remettre à jour toutes les modifications apportées.

The page is ready for translation ? So let's see how to request translation :


 * 3. Edit
 * 4. Wrap the whole content inside  tags as shown below
 * 5. Save the page

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

Notez qu'il n'est pas utile d'ajouter les balises à tous les éléments, ou de leur apposer des étiquettes comme, l'extension fait cela pour vous.

Étape n°3 : Activer les traductions
Après avoir publié la page, vous verrez un lien en haut de la page disant « Marquer cette page pour traduction » — ou bien « Cette page contient des modifications qui n'ont pas été marquées pour la traduction » si vous n'êtes pas administrateur de traduction. Si vous êtes un administrateur de traduction, cliquez sur le lien « Marquer cette page pour traduction ». La page est automatiquement divisée en quatre unités de traduction. La première unité est le titre de la page, la deuxième est le premier paragraphe, la troisième est l'entête du second paragraphe et enfin, la quatrième est le texte du second paragraphe. Il s'agit des éléments de base des pages traduisibles : chaque unité est indépendante. Elle peut et doit être traduite dans son ensemble. Les modifications du contenu de la page sont suivis unité par unité. Les unités peuvent être réarrangées ou supprimées.

There is also a view of the page translation page template; this will be covered in later steps. You can give names to the translation units, but in this example, we choose to stick with the defaults.


 * 6. Click the "Mark this page for translation" link
 * 7. Ensure that the page body is split into three units correctly
 * 8. Click the "Mark this version for translation" button (Rappel : vous devez être administrateur de traductions pour cela)
 * 9. Return to the page

Now you will see a new link at the top, "Translate this page", that lets translators 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.

Understanding how changes are impacting translations and translations units
Tracking changes is a very important feature, so let's make some changes 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, new markers will be added by the software. Do not try to do this manually, it may confuse the software. Markers you have deleted will also be automatically deleted by the bot in the existing translations.

If you do minor changes to an existing translation unit (adding a few words or a link to a paragraph), keep the marker. If you change a whole paragraph (delete and rebuilt it), delete the marker. This way, translators will have different tasks, between reviewing a fuzzy translation or create a new translation.

let's modify something !
Here is what you will do :


 * 10. Make some additions as highlighted above
 * 11. Click the "marked for translation" link at the top
 * 12. Observe the changes
 * 13. Click the "Mark for translation" button (Rappel : vous devez être administrateur de traductions pour cela)
 * 14. Return to the original page

If you made translations as suggested in the previous step, you can now see those translations linked at the top of the page. You will also see that the translation is not 100 % up to date. If you go to the translation view, you see that the unit is marked as in need of updating.

Les traductions obsolètes seront mises en valeur par un fond rose ; l’utilisateur est averti que la traduction n'est pas terminée.

La vue modèle traduction vous aide à voir les parties de la page qui sont constantes entre toutes les versions linguistiques (le "modèle traduction de page", c'est-à-dire les parties en dehors des marqueurs "translate") et vous affiche aussi si des unités ont été déplacées ou supprimées.

Il se peut qu'il y ait un léger retard dans la mise à jour des versions traduites lié au nombre plus ou moins important de pages à mettre à jour.

Vous connaissez maintenant les bases, mais ce tutoriel n'est pas fini et va vous montrer d'autres choses que vous êtes susceptible de rencontrer.

Adding an image, a category and a list with translation markers
You 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.

Nous avons aussi retiré un paragraphe ainsi que son unité de marquage, et nous l'avons remplacée par une liste afin que vous puissiez voir ce qui se passe.


 * 15. Add an image, a category and a list to the page as shown below
 * 16. Save the page
 * 17. Click the link "marked for translation" at the top of the page
 * 18. Verify that the changes look as intended
 * 19. Click the "Mark this version for translation" button
 * 20. Return to the translatable page

Documenter une traduction
Allowing to translate only the picture title:

Or allowing to change the image file in the translated page (for localized version for exemple) and the title:

Ici vous pouvez voir que nous avons laissé la majeure partie du marquage de l'image en dehors de l'unité de traduction et qu'elle se trouve maintenant dans le modèle de traduction de page. (Rappel : le modèle de traduction de page ne change pas entre les différentes pages traduites) Cela suffit généralement mais quelquefois, les traducteurs préfèrent changer l'image, surtout si celle-ci contient du texte dans une langue différente. Dans ce cas, il est généralement plus facile d'inclure le marquage dans sa totalité à l'intérieur d'une unité (comme nous l'avons fait pour la catégorie).

Quand la traduction d'une unité joue sur le marquage, il est recommandé d'écrire une petite remarque aux traducteurs à ce sujet. Vous pouvez le faire en suivant les prochaines étapes.


 * 21. Click "Translate this page" link at the top
 * 22. Select "qqq - Page documentation" language
 * 23. Click the message name which contains the message "A typical view of Fréttinga"
 * 24. Write "Description of an image" and click "Save"

Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.

A propos des liens
De même pour les liens, il y a plusieurs méthodes pour les générer. Nous avons utilisé " Special:MyLanguage/Seagull " qui redirige automatiquement vers la version traduite de la page en fonction de la langue utilisée pour l'interface utilisateur (si cette traduction existe bien entendu). Il ne s'agit pas d'une solution ultime, parce que les utilisateurs seront toujours redirigés vers la langue utilisée dans leur interface, et non la langue dans laquelle ils lisent sur le moment. Special:MyLanguage interfère aussi avec Special:WhatLinksHere et l’empêche de fonctionner. Par contre, l'intérêt de Special:MyLanguage, c'est que vous obtiendrez toujours une version de la page, même si la traduction demandée n'existe pas.

À propos des catégories
Dans cet exemple, toute l'affectation à une catégorie se trouve être une unité de traduction. Cela permet aux traducteurs de la changer en ou suivant la convention d'appellation que vous voulez utiliser pour les catégories. Si elle se trouvait en dehors du modèle traduction, vous auriez les pages Foo, Foo/de, Foo/ru, Foo/ta et ainsi de suite dans la même catégorie. Quelquefois, cela peut convenir mais, généralement, cette façon de faire distrait les utilisateurs. Assurez-vous que vos traducteurs connaissent bien la convention locale.

À propos des titres
Pour que les titres soient considérés comme des éléments séparés du texte, n'oubliez pas d'ajouter une ligne vide (s'il n'y en n'a pas déjà une) entre le titre et le paragraphe qui le suit.

L'exemple suivant ne produira qu'une seule unité de traduction :

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

Ce qui suit créera deux unités de traduction, dont une pour le titre.

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

En ajoutant une ligne vide, vous permettrez aux traducteurs de savoir quand ils peuvent faire une pause. De plus, cela évite des problèmes de wikicode.

Operating on the whole page and its translations
It is also possible to move translatable pages including all their translations to a new name. Because many pages may need to be moved, this operation is not instant. You can delete either the whole page including all translations, or just one translated version of a page. You can access these functions from the same place they are on all other pages.

Managing all wiki's pages translations with Special pages
Special:PageTranslation lists all the pages in the system. Besides giving you an overview of all translatable pages, it is also possible to discourage pages from translation. This hides the page from most lists. It does not prevent further translations.

Now, you know !
Vous avez maintenant créé une page traduisible et essayé toutes les actions courantes qui peuvent être accomplies sur les pages traduisibles.

Going deeper ?
Pour plus d'informations, ou si vous voulez comprendre plus profondément la fonctionnalité, veuillez poursuivre la lecture sur la documentation complète de la fonctionnalité de traduction de page. Elle comprend aussi des discussions sur les différentes façons de gérer les liens, les catégories et les modèles, et les avantages et inconvénients d'utiliser des unités de traductions plus petites ou plus grandes.

Voir aussi

 * Help:Extension:Translate/Page translation administration/fr