= Trac en version Française = == Description == This hack is a french translation of the Trac engine, which should disappear once Trac becomes multilingual. Ce projet est une traduction en langue française du moteur Trac, qui devrait disparaître dès que Trac deviendra multilingue. Cela sera le cas à partir de la version 0.12 de Trac. Une version de test basée sur Trac [t:milestone:0.11 0.11] et utilisant [http://genshi.edgewall.org/ Genshi] et [http://babel.edgewall.org/ Babel] est disponible sur le site offciel de Trac, dans la branche [t:browser:sandbox/i18n i18n]. == Défauts/Demande de fonctionnalités == Les rapports de défauts et les demandes de nouvelles fonctionnalités pour TracFrenchTranslation sont disponibles [report:9?COMPONENT=TracFrenchTranslation ici]. Si vous rencontrez un problème, créez un [http://trac-hacks.org/newticket?component=TracFrenchTranslation&owner=eblot nouveau ticket]. == Auteurs/Contributeurs == '''Auteur:''' [wiki:eblot] [[BR]] '''Contributeurs:''' [wiki:lastnico] == Historique == Les pages ont été traduites de l'anglais vers le français pour les besoins propres du site http://anciens.enib.fr. [[BR]] Plusieurs personnes ayant manifesté un intéret pour la version francisée de Trac, les modifications spécifiques à ce site avaient été mises à disposition de tous. Néanmoins la traduction n'avait été réalisée que partiellement, et comportait un certain nombre de problèmes. De plus, la disposition des fichiers avait été modifiée par rapport à la version originale de Trac. Une nouvelle phase de traduction a donc été décidée, de manière à suivre au plus près les versions officielles de Trac. Les modifications principales de cette nouvelle version sont: * organisation des fichiers identiques à la version originale (Trac 0.9) * traduction complète des ''templates'' [http://www.clearsilver.net ClearSilver] * traduction complète des éléments dynamiques, gérés par les modules [http://www.python.org Python], configurables (fichier `trac.ini`) * utilisation du vouvoiement * le contenu de la base de données reste compatible avec la version originale. Aucun élément francisé n'est stocké dans la base de données, de manière à ce que l'administrateur puisse choisir une interface dans la langue de son choix, sans altérer la base et la rendre dépendante du langage retenu. ''Note:''[[BR]] Les éléments dynamiques sont les messages qui ne sont pas prédéfinis au sein des ''templates'', mais générés par l'éxécution du code Python du moteur Trac. La traduction comporte certainement encore quelques erreurs.[[BR]] Merci de [wiki:eblot me] contacter pour signaler tout problème ou apporter des suggestions. == Téléchargement == La version courante de Trac en langue française est basée sur la version de développement [trac:milestone:0.10.3 0.10.3] de Trac [trac:changeset:4446 trunk:4446]. * Le code source est disponible en ligne via le [source:/tracfrenchtranslation navigateur] * Vous pouvez télécharger ce code source à partir de n'importe quel client [http://subversion.tigris.org Subversion], à partir cette URL: http://trac-hacks.org/svn/tracfrenchtranslation Une archive ZIP automatiquement générée est également disponible [download:tracfrenchtranslation ici]. === Dépôt Debian / Ubuntu === Vous pouvez également retrouver la dernière version de Trac en français sur le [http://ubuntu.forum-software.org dépôt] de [http://www.forum-software.org Forum-Software.org]. Ajoutez les lignes suivantes dans le fichier /etc/apt/sources.list de votre distribution : {{{ deb http://ubuntu.forum-software.org/ edgy universe deb-src http://ubuntu.forum-software.org/ edgy universe }}} Puis, faites simplement un {{{ apt-get update apt-get install trac-french }}} Ce paquet est basé sur le paquet Trac original d'Ubuntu, vous retrouverez donc une configuration identique. == Installation == === Nouvelle installation === La procédure d'installation et l'administration de la version francisée reste identique à la version originale. Merci de vous conformer à la [http://projects.edgewall.com/trac/wiki/TracInstall documentation d'origine] pour installer ce logiciel. === Mise à jour d'une version existante === Les termes dynamiquement traduits étant définis dans `trac.ini`, il n'est pas possible de faire une mise à jour simple d'un projet existant: la commande 'update' de `trac-admin` ne met pas à jour les fichiers de configuration des projets existants.[[BR]] Il est probablement possible, néanmoins, de procéder comme suit: 1. Installer Trac version française: `python setup.py install`... 1. Créer un nouveau projet: `trac-admin temp initenv`... 1. Mettre à jour le project existant: `trac-admin project upgrade`... 1. Copier les nouveaux élements de la section `[translation]` depuis le nouveau fichier de config `trac.ini` vers le fichier de config `trac.ini` du projet existant Attention, cette procédure est sans garantie aucune... Pensez à toujours faire une sauvegarde de vos projets existants avant de faire une mise à jour ! === Utilisation avec mod_python === Si vous utilisez un système entèrement UTF-8 il est nécessaire dans la configuration d'Apache d'ajouter le paramètre : {{{ PythonOption TracLocale "fr_FR.utf-8" }}} au niveau du projet (hôte virtuel ou autre). La plupart des sites recommanderont un "fr_FR.UTF-8" en majuscule, mais ceci est une erreur. == Modifications principales == * La plupart des modules Python sont désormais au format UTF-8 -sans BOM-, et non ISO-8859-1 * Le fichier de configuration de chaque projet (`trac.ini`) contient les termes traduits dynamiquement, et peut donc être modifié simplement. == Licence == Le code source suit la même license ''BSD modifiée'' que la version originale de Trac.[[BR]] L'utilisation se fait aux risques et périls de l'utilisateur, aucune garantie n'est apportée quant à l'intégrité des données ou au fonctionnement de ce logiciel. Il est simplement mis à disposition du public à titre gracieux. == Notes importantes == A terme, ce projet est voué à disparaître, puisque les futurs versions de Trac fourniront l'internationalisation simple du projet (ce qui évitera une copie complète de l'ensemble). Pour le moment cependant, il est toujours nécessaire d'appliquer les patchs progressivement à la traduction française. Ce travail risque forcément d'occasionner d'autres bogues, veuillez nous les reporter également. == Reste à faire == Beaucoup de choses ;-)[[BR]] En particulier, les pages Wiki n'ont malheureusement pas encore été traduites par manque de temps - toute aide est la bienvenue ! Néanmoins, les composants suivant n'ont volontairement pas été traduits: * Les outils d'administration (`trac-admin`, `tracd`, etc.) * Les messages de diagnostic (''logs'') * Les fichiers du répertoire `contrib` == Questions == Contacts: `nicolas_ternisien@gmail_com` ou `manu_blot@gmail_com` (antispam: remplacer les soulignés par des points) ou via la [http://projects.edgewall.com/trac/wiki/MailingList mailing list] officielle de Trac. [[TagIt(translation,eblot,lastnico,0.10)]]