RE: [sympa-fr] [SYMPA] Personnalisation de l'aide

["BELLENGIER Sylvain" <adresse@cachée>]

Bonjour,

 

Merci pour ce retour très précis.

Je vais dérouler les étapes décrites dans votre mail sur notre environnement de développement SYMPA et vous tiens au courant de la mise en œuvre de cette personnalisation.

 

Cordialement

 

Sylvain BELLENGIER   Responsable du secteur outils et architectures transverses (OAT) (  01 57 53 25 47 *  adresse@cachée   Secrétariat général Service de l’environnement professionnel Sous direction informatique des services centraux Bureau applications et projets informatiques   Ministères économiques et financiers

Pensez à l'environnement, n'imprimez ce message que si c'est nécessaire

 

 

De : adresse@cachée [mailto:adresse@cachée] De la part de Philippe Aepli
Envoyé : lundi 5 mai 2014 11:40
À : adresse@cachée; adresse@cachée
Objet : RE: [sympa-fr] [SYMPA] Personnalisation de l'aide

 

Bonjour,

 

Désolé pour le double post, veuillez ne pas tenir compte de mon précédent message. Une petite erreur de manipulation a envoyé le message avant que je l'aie terminé … :/

 

Que ce soit la personnalisation d'un page web de Sympa où l'aide, c'est le même processus.

Remarque, si vous ne faites pas de localisation (loc, helploc), alors vous n'avez pas à vous préoccuper des fichiers .po.

 

Voici les trois étapes pour modifier un page web de Sympa:

 

Première étape, déterminer le modèle (.tt2) à modifier:

Il suffit de consulter le code de la page source et de rechercher un texte spécifique, puis de remonter (ou descendre) pour trouver un commentaire spécifiant le nom du fichier concerné. Au passage un grand merci au devs. pour cette astuces ^^

 

Pour l'exemple, nous allons modifier la page d'introduction de l'aide.

·         Ouvrez la page en question en cliquant sur l'onglet Aide dans l'interface de Sympa et suivez le lien "introduction générale". Puis, affichez le code source de la page.

·         Recherchez, par exemple, le terme "Introduction générale", si la langue choisie est le français. Dans le cas contraire, recherchez simplement le titre de la page affichée.

·         En remontant de quelques lignes, vous devriez trouver un commentaire html ressemblant à ceci:
<!-- $Id: help_introduction.tt2 7490 2012-07-19 10:07:15Z sikeda $ -->

·         help_introduction.tt2 est le nom du fichier qui nous intéresse.

 

Deuxième étape, personnaliser le modèle (.tt2):

Les modèles de base ne doivent pas être modifiés, mais nous pouvons le copier dans l'environnement de notre choix (général, robot, famille, etc.) pour l'adapter à nos besoins. Remarque, j'ai installé Sympa depuis les sources et non avec un paquet. Les chemins sont légèrement différents dans le cas d'une installation avec un paquet, il vous faudra adapter mon explication à votre installation. Mais l'idée reste la même.

 

Pour l'exemple, nous allons légèrement modifier le titre de la page et copier le fichier dans la configuration générale de Sympa. Si vous voulez modifier la page d'un robot, ou d'une famille, il faudra adapter le chemin (consultez la doc de sympa sur le site officiel).

·         Créez, le cas échéant, le dossier /home/sympa/etc/web_tt2.

·         Copiez le fichier, trouvé précédemment: /home/sympa/default/web_tt2/help_introduction.tt2 vers /home/sympa/etc/web_tt2.

·         Modifiez le modèle à l'aide de l'éditeur de votre choix et remplacez la ligne suivante:
<h2 class="block">[%|helploc%]Mailing lists - General introduction[%END%]</h2>
par :
<h2 class="block">[%|helploc%]General introduction[%END%]</h2>

·         Si vous consultez à nouveau la page web, vous verrez que le titre reste en anglais (General introduction) quel que soit la langue que vous choisissez. Il faut localiser votre modification (-> étape 3).

 

Troisième étape, localisation des modifications (.po):

Les fichiers nécessaire à la localisation se trouvent dans les dossiers po et po-wwsympa des sources. Si vous n'avez pas ces sources, je vous encourage à les télécharger depuis le site officiel.

 

·         Créez les répertoires de travail /home/sympa/tmp/po-sympa et /home/sympa/tmp/po-wwsympa.

·         Copiez depuis les sources les langues qui vous intéressent dans ces dossiers. Par exemple, dans le cas où vous avez décompressé l'archive dans le dossier de Sympa et que les langues française, allemande et italienne vous intéresse, procédez comme suit:

o   cd /home/sympa

o   cp sympa-6.1.17/po/fr* tmp/po-sympa/

o   cp sympa-6.1.17/po/de* tmp/po-sympa/

o   cp sympa-6.1.17/po/it* tmp/po-sympa/

o   cp sympa-6.1.17/po-wwsympa/fr* tmp/po-wwsympa/

o   cp sympa-6.1.17/po-wwsympa/de* tmp/po-wwsympa/

o   cp sympa-6.1.17/po-wwsympa/it* tmp/po-wwsympa/

·         Modifiez les fichiers .po que vous avez copié en ajoutant vos nouvelles localisation:
pour le fichier /home/sympa/tmp/po-wwsympa/fr.po ajoutez les lignes suivantes à la fin du fichier après en avoir fait une copie:

# Personal translation
# <home_sympa>/etc web_tt2/help_introduction.tt2:3

msgid "General introduction"

msgstr "Introduction générale"

Remarques: les deux première lignes sont des commentaires, elles vous aiderons à vous retrouver dans vos localisations.

·         Pour générer les fichier qui seront utilisé par Sympa pour la localisation, il faut utiliser la commande msgfmt qui fait partie du paquet gettext. Installez ce paquet si ce n'est pas déjà fait.

·         Utilisez la commande suivante pour générer le fichier de localisation français:

o   msgfmt -c -o tmp/po-wwsympa/fr.mo tmp/po-wwsympa/fr.po

·         Remplacez le fichier de Sympa pour la langue française par votre nouvelle version. N'oubliez pas de faire une copie de l'ancienne version:

o   mv /home/sympa/locale/fr/LC_MESSAGES/web_help.mo{,.`date +"20%y%m%d"`}

o   cp -i /home/sympa/tmp/po-wwsympa/fr.mo /home/sympa/locale/fr/LC_MESSAGES/web_help.mo

Remarque: pour cette étape et suivant votre installation, il faudra probablement exécuter ces commandes en tant qu'utilisateur privilégié (root).

·         Faites de même pour les autres langues, s'il y lieu.

·         Redémarrez le service apache pour que vos modifications soient prises en compte. De préférence, arrêter puis démarrez apache, ainsi le cgi est mieux réinitialisé.

·         Maintenant si vous reconsultez votre page web, vous verrez que le titre a changé.

 

Remarque: Ici nous avons modifié l'aide de Sympa, pour les autres interfaces c'est similaire. Par contre, il faudra modifier les fichiers .po du dossier po-sympa et plus du dossier po-wwsympa. Et, il faudra remplacer le fichier sympa.mo et plus web_help.mo.

 

J'espère que malgré ma bévue, que mon explication vous aidera.

 

Salutations.

 

 

Philippe AEPLI              Email: adresse@cachée

Université de Genève        Tél: +41 22 379 72 86

Division STIC               Mob: +41 79 280 20 24

Rue du Général-Dufour, 24   Fax: +41 22 379 79 86

1204 Genève

 

De : adresse@cachée [mailto:adresse@cachée] De la part de Philippe Aepli
Envoyé : lundi 5 mai 2014 10:39
À : adresse@cachée; adresse@cachée
Objet : RE: [sympa-fr] [SYMPA] Personnalisation de l'aide

 

Bonjour,

 

Que ce soit la personnalisation d'un page web de Sympa où l'aide, c'est le même processus.

Remarque, si vous ne faites pas de localisation (loc, helploc), alors vous n'avez pas à vous préoccuper des fichiers .po.

 

Voici les trois étapes pour modifier un page web de Sympa:

 

Première étape, déterminer le modèle (.tt2) à modifier:

Il suffit de consulter le code de la page source et de rechercher un texte spécifique, puis de remonter (ou descendre) pour trouver un commentaire spécifiant le nom du fichier concerné. Au passage un grand merci au devs. pour cette astuces ^^

 

Pour l'exemple, nous allons modifier la page d'introduction de l'aide.

·         Ouvrez la page en question en cliquant sur l'onglet Aide dans l'interface de Sympa et suivez le lien "introduction générale". Puis, affichez le code source de la page.

·         Recherchez, par exemple, le terme "Introduction générale", si la langue choisie est le français. Dans le cas contraire, recherchez simplement le titre de la page affichée.

·         En remontant de quelques lignes, vous devriez trouver un commentaire html ressemblant à ceci:
<!-- $Id: help_introduction.tt2 7490 2012-07-19 10:07:15Z sikeda $ -->

·         help_introduction.tt2 est le nom du fichier qui nous intéresse.

 

Deuxième étape, personnaliser le modèle (.tt2):

Les modèles de base ne doivent pas être modifiés, mais nous pouvons le copier dans l'environnement de notre choix (général, robot, famille, etc.) pour l'adapter à nos besoins. Remarque, j'ai installé Sympa depuis les sources et non avec un paquet Debian. Les chemins sont légèrement différents dans le cas d'une installation avec un paquet, il vous faudra adapter mon explication à votre installation. Mais l'idée reste la même.

 

Pour l'exemple, nous allons légèrement modifier le titre de la page et copier le fichier dans la configuration générale de Sympa. Si vous voulez modifier la page d'un robot, ou d'une famille, il faudra adapter le chemin (consultez la doc de sympa sur le site officiel).

·         Créez, le cas échéant, le dossier /home/sympa/etc/web_tt2.

·         Copiez le fichier, trouvé précédemment, /home/sympa/default/web_tt2/help_introduction.tt2 vers /home/sympa/etc/web_tt2.

·         Modifiez le modèle à l'aide de l'éditeur de votre choix.

 

 

 

 

 

 

Philippe AEPLI              Email: adresse@cachée

Université de Genève        Tél: +41 22 379 72 86

Division STIC               Mob: +41 79 280 20 24

Rue du Général-Dufour, 24   Fax: +41 22 379 79 86

1204 Genève

 

> -----Message d'origine-----

> De : adresse@cachée [mailto:sympa-fr-

> adresse@cachée] De la part de adresse@cachée

> Envoyé : dimanche 4 mai 2014 17:59

> À : adresse@cachée

> Objet : [sympa-fr] [SYMPA] Personnalisation de l'aide

>

> Bonjour,

>

> Je souhaite personnaliser "trés légérement" l'aide utilisateur (langue

> française) fournie dans l'interface web SYMPA v6.1.17 pour prendre en

> compte

> les remarques de nos utilisateurs internes.

> En regardant la documentation sur le site web, il est fait référence au

> fichier web_help_fr.po qui contient à la fois le texte en anglais et en

> français de l'aide utilisateur.

> Faut -il modifier ce fichier pour personnaliser l'aide utilisateur ?

> Dans l'affirmative, pouvez-vous également me préciser si dans quel

> répertoire

> doit se retrouver ce fichier afin qu'il puisse être pris en compte par

> SYMPA ?

> En effet, c'est un fichier que je n'ai pas retrouvé une fois

> l'application

> SYMPA installée.

>

> Sinon, quelle est la procédure à suivre pour effectuer cette opération

> ?

>

> Merci pour vos retours.

>

> Sylvain bellengier

>