Translations by Dominique-Alain JAN

Des petits boutons peuvent être inclus dans le texte, comme |edit|, |manage|. Ils sont ajoutés par substitution de leur code par leur image. Toutes ces images sont placées dans le fichier *shortcuts.rstext* qui est inclu à chaque fichier dans lequel des substitutions doivent être faites, en plaçant la commande « ``.. include:: /shortcuts.rstext`` »i dans la première ligne du fichier. Les substitutions sont créée par le code placé directement dans le texte, par exemple : « ``*Edit* button |edit|`` ». Les traducteurs ne doivent pas modifier le code de substitution « `|edit|``» mais seulement traduire «``*Edit* button`` » en prenant soin d'ajouter le \* sans laisser d'espace entre le \* et le texte, pour s'assurer que le mot sera affiché en gras.

Une entrée d'index doit être créée pour chaque section

Les nouvelles fonctionnalités se trouvent dans l'index et sont signalées dans le texte par « sigle: New in Mahara 1.x, [la nouvelle fonctionnalité] ».

Les sections longues doivent être séparées en plusieurs pages pour faciliter l'édition du texte.

reStructuredText ne gère pas la hiérarchie dans le niveau d'en-têtes. Ces derniers dépendent des fichiers individuels. Toutefois, pour être cohérent, la convention suivante existe :

Titre 1, par ex. 1.: ===============

Titre 2, par ex. 1.1.: ---------------

Titre 3, par ex. 1.1.1.: ~~~~~~~~~~~~~~~

Titre 4, par ex. 1.1.1.1.: ^^^^^^^^^^^^^^^

Les pages d'index n'ont pas d'en-tête en plus de l'en-tête principal. Cela permet d'éviter que la table des matières ainsi que les autres sections qui possèdes des en-têtes soient considérées comme les chapitres principaux du manuel. Gardez l'apparence des en-têtes de l'index en gras en utilisant \**.

Formattage du texte

Chaque item d'une liste à puce comment par le symbole \*.

Chaque élément d'une liste numérotée commence par \#.

Si vous désirez créer des listes à puces à plusieurs niveaux, laissez une ligne vide entre chaque niveau et placez 3 espaces devant chaque ligne. Il n'est pas nécessaire de laisser un ligne vide lorsque vous arrivez à la fin d'une sous-liste.

La mise en évidence d'une partie d'un texte se fait en débutant et terminant celui-ci par 1 \*, comme par exemple : ``*cela*``. Ce qui vous donnerait quelque chose comme *cela*.

La mise en gras d'un texte commence et se termine avec 2 \*, comme ``**cela**`` ce qui donne **cela**.

Les hyperliens

Liens externes: "```[texte du lien] <URL>`_``" - Les traducteurs du présent manuel ne doivent traduire QUE ce qu'il y a entre crochets soit le "[texte du lien]".

Les références internes pour lier un texte avec une autre partie de ce manuel s'effectuent en plaçant « ``.. [reference_text]:`` » dans une ligne juste avant en en-tête. Je laisse généralement une ligne vide entre la référence et l'en-tête.

Liens vers des références internes : "``:ref:`[texte du lien] <référence interne>```" - Les traducteurs du présent manuel ne doivent traduire QUE ce qu'il y a entre crochets soit le "[texte du lien]".

Le caractère **`** est bien l'accent grâve et non une marque de citation simple ou une apostrophe.

Une cible dans le texte peut être réalisée en place le texte à lier avec un accent grâve précédant un tiret de soulignement : ``_`une référence interne```. Le référencement est le suivant ``:ref:`[text that is linked] <the internal reference>```.

Entrées d'index

Les entrées d'index sont utilisées pour accéder rapidement à une information précise. Les entrées peuvent être créées juste au-dessus d'un en-tête ou dans le texte. Les entrées dans le texte ont l'avantage de vous amener exactement là où vous voulez vous rendre.

Les entrée d'index sont créées de la manière suivante : ``:index:`Votre image du profil <single: Nouvauté Mahara 1.10; Lien vers les image du profil>```.

Traducteurs, prêtez attention

Ne modifiez pas la cible des liens internes qui sont placés entre < >. Si vous le faites, les références ne seront plus trouvées. Il y a toujours un texte d'explication avant les < >, c'est ce texte que vous devez traduire.

De manière similaire, vous pouvez modifier le texte d'un URL mais pas l'URL lui-même, à moins que vous ne le remplaciez pour pointer sur un texte écrit dans votre langue de traduction.

Si vous traduisez les copies d'écran et les autres images, veillez à conserver intacte la structure du dossier « images ». Il est important que cette structure reste comme elle a été fixée dans `Gitorious <https://gitorious.org/mahara/manual/trees>`_.

Vous pouvez accéder aux images originales du manuel dans le dossier « images_original » et dans les sous-dossiers correspondants. Vous pouvez les utiliser pour effectuer les traductions nécessaires si vous désirez modifier le fond en gardant la numérotation.

Vous n'avez pas besoin de placer dans la traduction les images que vous ne souhaitez pas traduire, par exemple les icônes des blocs, les boutons généraux et les boutons d'édition. Toute image manquante dans les dossiers de traduction sera automatiquement remplacée par la version originale en anglais.

Le manuel de l'utilisateur est mis à jour une fois par jour et les nouvelles traductions des chaînes de caractères sont envoyées depuis le système Launchpad dans la nouvelle version du manuel. Il en est de même des images sur le Git qui sont compilées avec la création journalière du manuel.

A l'heure actuelle, toutes les chaînes de caractères ne peuvent pas être traduites dans Sphinx. Il est donc normal que certaines traces du manuel original en anglais apparaissent ici ou là. Avec un peu de chance, les versions ultérieures permettront de corriger cela.

Si vous désirez mentionner les noms des traducteurs qui ont participé à la traduction du manuel de l'utilisateur de Mahara dans votre langue, vous pouvez le faire en ajoutant une phrase après « Le manuel de l'utilisateur de Mahara a été écrit par les membres de la communauté ». Ce paragraphe apparaît avant la table des matières. Il n'y a pas d'équivalent à ce phrase dans la version originale anglaise, car il ne s'agit pas d'une traduction.