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. Les conventions d’appelation utilisées lors de la traduction (via le fichier XLPage et le fichier local/config.php doivent être répercutées dans la documentation, c’est à dire que les paramètres spécifiques français doivent-être mise à la place des paramètres originaux. Ceci permet d’avoir une documentation efficace pour l’utilisateur novice car étant le reflet exacte de la francisation du sytème et de parvenir à une traduction plus rapide et plus efficace car les éléments variables en français ayant une référence commune. L’idée est d’obtenir un fichier XL Page et un fichier local/config.php parfaitement synchronisé.
Une trop grande différence induit beaucoup d’étapes inutiles à la compréhension entre l’original et la traduction et nuit à l’effort collectif de traduction. La nature dynamique même du wiki génère déjà des différences avec le temps; autant ne pas rajouter d’étapes inutiles au nouveau venu, même si certains estiment que l’organisation ou les conventions utilisées dans la version originale sont perfectibles ou pas idéales. Toute personne désirant modifier ou influencer le développement de PmWiki peuvent le faire soit en collaboration (ce qui est par ailleur encouragé) directe avec le mainteneur principal, Patrick Michaud, et les gens qui gravitent autour, soit pour leur utilisation personnelle. Si certaines de ces bonnes idées se voyaient devenir partie intégrante alors il serait toujours temps de les traduire. De plus PmWiki est très modulaire et peut s’adapter à un nombre d’utilisation dont seule votre imagination est la limite. D’autres part plus le système mis en place sera simple et facile, plus il aura de chance d’être adopté par le plus grand nombre et plus la traduction sera à jour. Il ne faut pas oublier le rôle principal du groupe PmWiki Fr sur ce site : ce sont les pages destinées aux francophones livrées avec la distribution standard de PmWiki (dans l’archive i18n.tgz).
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:)
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.
Pour les traducteurs et pour les raisons expliquées ci-dessus 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:
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 PmWiki Fr.XL Page
----------------------------------------
Bonsoir, j’ai crée la page PmWiki Fr.Search et modifié la page PmWiki Fr.Edit Quick Reference pour qu’elles soient le reflet de la version anglaise, j’ai modifié PmWiki Fr.XL Page pour que les versions francaises soient utilisées.
J’ai aussi fait PmWiki Fr/Recherche, qui décide si c’est Search ou Recherche que l’on officialise ?
Par contre j’ai un problème avec PmWiki 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.