Suggestion:

Ce document est en cours de rédaction, néanmoins n'hésitez pas à donner votre avis... Peut être même que ce document à terme pourrait faire l'objet d'un cookbook mettant à disposition l'expérience et les développements utiles à tout traducteur.

Introduction

Le but de ce document est de tenter d'établir un guide de traduction pour parvenir à :

  • Une francisation la plus complète possible du système dès l'installation, fidèle à la version distribuée.
  • Mettre en place une politique de traduction de qualité permettant la participation d'un maximum de personnes.

La francisation du système Pm Wiki englobe principalement deux aspects :

  • La francisation du système lui même.
  • La traduction de la documentation.

Ces deux aspects sont intimement liés. La documentation doit refléter exactement le système.

Concrètement, ces deux aspects correspondent à deux types de fichiers. Le système (tout ce qui se voit, sauf le contenu éditable des pages) est conservé dans des fichiers système "XLPage" situés dans le répertoire wikilib.d (et script). Il ne sont pas modifiable depuis l'interface du wiki et il ne faut pas les modifier sur son installation personnelle car ils sont recouverts lors des mises à jour. Le fichier local/config.php est aussi concerné, mais lui ne peut pas être mis à jour automatiquement (ce répertoire ne doit être utilisé que par le propriétaire du site).

L'autre aspect, la documentation, est constituée de pages ordinaires du wiki (ici même) et donc modifiables par tous.

Principes:

Les pages non interactives doivent être modifiées en priorité (c'est fait pour l'essentiel) et leur contenu publié et facilement accessible pour tous les candidats traducteurs. Les interprétations de traduction doivent être discutées sur la liste française (disponible depuis Mai 2007) et une fois adoptées ne plus être remises en cause sous peine de détruire l'effort de traduction.

Note de jdd: J'ai profondément remanié cette page, non pas pour un désaccord avec le contenu mais pour la rendre plus lisible. L'ancienne version doit être disponible dans l'historique.

Proposition de mise en oeuvre :

Dénomination des pages de documentation:

Utiliser les noms de page en anglais a un aspect très pratique:

  • Simplicité, pas d'ambiguité. Il suffit d'ajouter "Fr" au nom du groupe pour avoir une correspondance.
  • De fait induit une certaine aptitude à l'automatisation supplémentaires (utilisation plus aisées des variables de page par exemple, comparaison facile des deux langues, filtrage en local...)
  • Les liens sont déjà (sauf exception) en place pour la traduction; il suffit juste d'ajouter "|+" au lien. Par exemple :
* page (nom): [[documentation guidelines]]
* page (titre): [[documentation guidelines|+]]
(jdd) je ne comprends pas ce passage, je n'arrive pas à faire marcher les exemples
  • Malgré la dénomination des pages en anglais, la langue de Molière peut-être mise en avant (même durant les recherches) grâce à:
    • L'utilisation systèmatique de la balise (:title:) en début de chaque page
(jdd) j'imagine que ce qui suit est déjà fait? si oui, inutile de le conserver ici-
  • Et le remplacement dans Recherche de (:searchresults:) par :
[[#recherche]]
(:if ! equal {=$Group} {<$Group}:)

:[[{=$Group}]] /:
(:if:)
: :[[{=$FullName}|+]]
[[#recherche]]

(:searchresults fmt=PmWikiFr.Recherche#recherche:)
  • et surtout les noms de fichiers ne comportent plus d'accents comme actuellement, rendant impossible l'utilisation de Pm Wiki Fr dans certains hébergeurs (les noms sont mêmes faux dans la version actuellement téléchargeable)

Ceci a été fait PRZ?

Pas complètement jdd? - la liste des pages du groupe Pm Wiki Fr actuellement dans le fichier i18n est bizarre happy smiley - peut-être simplement le fichier i18n est-il trop vieux!

Il y a deux façons de résoudre le problème de nom. Toutes les deux demandent de conserver une page dans Pm Wiki Fr avec le nom en anglais.

  • Utiliser la balise (:title:) come indiqué ici. C'est la méthode la plus simple, à utiliser chaque fois que possible;
  • mettre dans la page en anglais une balise (:redirect nomenfrançais:) vers la page en français. C'est la solution la plus simple si la page mal nommée existe déjà. On peut aussi avoir une page au nom français, si celui-ci est évident, avec un redirect vers la page au nom anglais.

L'état de la traduction:

Outre la page état de la traduction, mise à jour manuellement, il existe la page Liste des pages de PmWikiFr générée automatiquement, et donc toujours à jour.

jdd? Gestion des sources propositions supplémentaires

Pages nouvelles en français

Faut-il encourager la création de pages en français qui ne soient pas dans le wiki anglais? A mon avis c'est à éviter, ou alors à loger dans un emplacement bien délimité de la doc. Pour tous ceux qui le peuvent, il vaut bien mieux écrire la page en anglais et ensuite seulement la page en français (qui, au besoin, peut-être traduite par d'autres). En fait il faudrait distinguer "traduction" et "écriture d'une doc supplémentaire" qui sont deux choses différentes.

Audiences et Index

Un seul fichier d'index (Documentation Index) calqué sur la version anglaise est préférable comme référence officielle.

Bien sûr, toutes les pages de la documentation ne s'adressent pas aux même personnes suivant leur type (utilisateur,administrateur...) et leur expérience. Un classement de cette nature des pages sur la doc officielle est en cours actuellement, il suffit de le suivre:

  • mots-clés pour le type d'audience : lecteurs, auteurs, administrateurs, tous (pour l'ensemble des trois catégories)
  • mots-clés pour les niveaux de difficultés : basique, intermédiaire, avancé

Utilisation de la balise suivante sur chaque haut de page:

%audience% lecteurs, auteurs (basique)

lecteurs, auteurs (basique)

Néanmoins il est toujours possible de conserver plusieurs index parallèles comme il existent actuellement dans la barre de navigation qui ne seraient que des liens finalement vers les mêmes pages de documentation référencées dans l'index officiel.
A noter également que l'utilisation d'un index général permet l'utilisation d'un wiki trail sur l'ensemble de la documentation.

Proposition d'index:

Pour les autres index les documents pourraient y être classés par ordre de difficulté par exemple

Référence pour la francisation :

-------- En cours, à faire -------------

Dans local/config.php:

Dans Pm Wiki Fr.XL Page

  • Page de recherche :

----------------------------------------

A voir


Bonsoir, j'ai crée la page Pm Wiki Fr.Search et modifié la page Pm Wiki Fr.Edit Quick Reference pour qu'elles soient le reflet de la version anglaise, j'ai modifié Pm Wiki Fr.XL Page pour que les versions francaises soient utilisées.
J'ai aussi fait Pm Wiki Fr/Recherche, qui décide si c'est Search ou Recherche que l'on officialise ?
Par contre j'ai un problème avec Pm Wiki Fr.Upload Quick Reference à priori la version francaise n'est pas prise en compte, j'avais crée le PITS/00463 pm à fait les corrections mais pour la page d'upload ca ne marche pas chez moi, qqun pourrait verifier ?
PS: comment faire pour que les modifs soient reprises dans i18n? Isidor?

Il faut attendre que pm mette à jour le i18n, ce qu'il fait à intervalles irréguliers (environ tous les deux mois).

[Note d'EOL? :] Pour l'upload quick ref, j'ai changé le script upload.php en remplaçant Site.UploadQuickReference par PmWiki.UploadQuickReference. (PITS n°625.)
Le PITS 625 a été annulé par pm, ceci doit se faire dans la page XL Page.

Bonjour, elle est très bien et pratique votre traduction, néanmoins l'utilisation d'accents dans le nom des fichiers est vraiment une plaie pour installer sur certains serveurs. Visiblement c'est en utf8 ce que supporte mon système, mais en envoyant les fichiers sur un serveur chez free.fr cela a bloqué au niveau des fichiers avec un nom accentués. (exemple de fichier à problème : Pm Wiki Fr.Création Automatique De Vignettes? , cela serait bien que cela s'appelle Pm Wiki Fr.Creation Automatique De Vignettes? à la place). De plus, il y avait encore un fichier dont le nom était encodé en iso8859-1 : Pm Wiki Fr.Bac�able ~Farvardin?

J'ai enfin proposé une version en UTF-8 de ces fichiers de traduction : http://www.pmwiki.org/wiki/Cookbook/French ~Farvardin?, le 13/09/2010



Page originale sur PmWikiFr.PolitiqueDeTraduction - Référencé par

Dernières modifications:
PmWikiFr.PolitiqueDeTraduction: 13/09/2010 à 11:36


D'autres actions ou possibilités :

Imprimer la page - Créer le fichier PDF - Consulter les statistiques - Dernières modifications du site
Consulter la page - Editer cette page - Parcourir l'historique - Joindre un fichier - Se connecter/Déconnecter -

Stéphane FONTAINE - -