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.
Le but de ce document est de tenter d'établir un guide de traduction pour parvenir à :
La francisation du système PmWiki englobe principalement deux aspects :
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.
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.
Utiliser les noms de page en anglais a un aspect très pratique:
* page (nom): [[documentation guidelines]] * page (titre): [[documentation guidelines|+]] |
|
(:searchresults:) par :
[[#recherche]]
(:if ! equal {=$Group} {<$Group}:)
:[[{=$Group}]] /:
(:if:)
: :[[{=$FullName}|+]]
[[#recherche]]
(:searchresults fmt=PmWikiFr.Recherche#recherche:)
Pas complètement jdd? - la liste des pages du groupe PmWikiFr actuellement dans le fichier i18n est bizarre :-) - 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 PmWikiFr avec le nom en anglais.
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.
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.
Un seul fichier d'index (DocumentationIndex) 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:
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
-------- En cours, à faire -------------
Dans local/config.php:
$DefaultGroup) :
$DefaultName):
Dans PmWikiFr.XLPage
----------------------------------------
Bonsoir, j'ai crée la page PmWikiFr.Search et modifié la page PmWikiFr.EditQuickReference pour qu'elles soient le reflet de la version anglaise, j'ai modifié PmWikiFr.XLPage pour que les versions francaises soient utilisées.
J'ai aussi fait PmWikiFr/Recherche, qui décide si c'est Search ou Recherche que l'on officialise ?
Par contre j'ai un problème avec PmWikiFr.UploadQuickReference à 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 XLPage.
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 : PmWikiFr.CréationAutomatiqueDeVignettes , cela serait bien que cela s'appelle PmWikiFr.CreationAutomatiqueDeVignettes à la place). De plus, il y avait encore un fichier dont le nom était encodé en iso8859-1 : PmWikiFr.Bac�able ~Farvardin?