Informations pour les webmestres

Introduction

Les technologies employées pour la maintenance des pages web de la FSFE apparaîtront sans doute familières à beaucoup de développeurs ou auteurs, et leur description intéressera plus particulièrement ceux qui ne les connaissent pas encore bien.

Les traducteurs et bénévoles occasionnels ne seront probablement en relation qu'avec les parties suivantes :

• Savannah -- pour les accès CVS (voir ci-dessous) et la gestion des droits d'accès
• XHTML -- depuis lequel les pages statiques sont générées toutes les 5 minutes environ
• Concurrent Version System (CVS) -- pour la coordination et la synchronisation

Les bénévoles qui souhaitent s'engager plus sérieusement dans la maintenance du site devraient également se familiariser avec :

• Perl -- pour la maintenance et les scripts de création des pages
• Apache -- le serveur web

Comprendre le mécanisme de construction des pages web

Les pages web de www.fsfeurope.org sont maintenues comme un ensemble de fichiers XML. Le serveur web génère automatiquement les pages HTML à partir de ces fichiers XML, toutes les cinq minutes. Ainsi, toute l'édition des pages se fait dans les fichiers XML, et le HTML n'est jamais directement modifié.

Chaque page sur www.fsfeurope.org est nommée "nomdelapage.langue.html" (langue étant le code à deux lettres iso-639 de la langue, comme "en" pour l'anglais ou "fr" pour le français). Les fichiers source sont nommés "nomdelapage.langue.xhtml".
Certaines pages ont un contenu dynamique : hormis les textes fixes tirés du fichier .xhtml, elles contiennent des informations provenant d'un ou plusieurs fichiers .xml. Lorsqu'une telle page est construite, le système prend les fichiers .xml où ils sont disponibles, et prend la version anglaise de ces fichiers lorsqu'ils n'ont pas encore étés traduits. De telles pages peuvent donc afficher certaines parties traduites alors que d'autres seront encore en anglais. La page d'accueil, la page des nouvelles, et la page des événements par exemple, sont construites ainsi.

S'enregistrer sur Savannah

Les fichiers source des pages web sont stockés sur Savannah, un serveur hébergé par la Free Software Foundation, notre organisation sœur en Amérique du Nord. Pour obtenir un accès en écriture sur ces fichiers, vous pouvez créer un compte sur ce serveur.

Créer un nouveau compte

Suivez ce lien pour créer un nouveau compte. Choisissez un identifiant et un mot de passe, renseignez votre nom et votre adresse électronique, cliquez enfin sur le bouton "Submit" (soumettre le formulaire).

Vous allez alors recevoir un courrier électronique de Savannah. Pour finaliser votre enregistrement, visitez l'URL qui y sera mentionnée. Les comptes qui ne sont pas confirmés dans les deux jours sont supprimés de leur base de données.

Après avoir confirmé votre compte, connectez-vous sur https://savannah.gnu.org avec votre identifiant et votre mot de passe.

Générer une clef SSH

Bien que vous puissiez utiliser votre mot de passe pour vous connecter sur le portail web de Savannah, vous devez y enregistrer une clef publique SSH pour obtenir un accès à CVS. Ceci devra être fait depuis chaque machine avec laquelle vous souhaitez accéder au dépôt CVS.

Pour générer et enregistrer une clef SSH, suivez les instructions données dans la FAQ de Savannah.

Rejoindre le projet FSFE

Il y a de nombreux projets hébergés par Savannah, et l'accès CVS est accordé par projet. Pour obtenir un accès aux fichiers source du site de la FSFE, vous devez donc devenir membre du projet FSFE.

Choisissez "Group Membership" (ou "Groupes" si vous utilisez l'interface en français) dans les onglets du haut. Vous pouvez maintenant entrer "FSFE" dans le champ de recherche "Request for Inclusion" ("Requête D'Inclusion"), cliquer sur "Search" ("Rechercher") puis cocher la case FSF Europe et entrer un commentaire.

Les administrateurs du projet FSFE recevront alors un mail avec votre requête accompagnée du commentaire que vous avez donné, et pourront approuver votre adhésion au groupe du projet. Ensuite vous devriez voir "FSF Europe" dans les "Groups I'm Contributor of" ("Groupes dont je suis contributeur") après vous être identifié sur Savannah.

Vérifier et récupérer le dépôt la première fois

Tout d'abord, vous devez vous assurer que votre fichier ~/.bashrc contient une ligne indiquant
export CVS_RSH=ssh
créez ensuite un répertoire pour le dépôt et exécutez
$ cvs -z3 -d identifiant@cvs.savannah.gnu.org:/web/fsfe co .
depuis ce répertoire. L'on vous demande maintenant votre phrase codée SSH. Entrez-la et confirmez. Si tout se passe bien, le site web va maintenant être récupéré.

Travailler avec le dépôt

Après avoir récupéré le dépôt une première fois, vous n'aurez qu'à exécuter
$ cvs update -d
depuis le répertoire fsfe chaque fois, juste avant de vous mettre à travailler sur un fichier donné.

Lorsque vous souhaitez ajouter de nouveaux fichiers au dépôt, vous aurez à exécuter
$ cvs add nomdufichier

Pour envoyer vos changements au serveur, qu'il s'agisse d'un nouveau fichier ou de la modification d'un fichier existant, exécutez
$ cvs commit nomdufichier
et un éditeur s'ouvrira, vous permettant d'indiquer une courte description des changements apportés.

Vous pouvez télécharger un manuel détaillé de CVS sur la page d'accueil de CVS.

Si vous souhaitez conserver une trace de toutes les modifications apportées aux sources des pages web, souscrivez à la liste de diffusion des notifications de CVS, vous recevrez ainsi un mail à chaque changement posté à l'arbre du source.

Les responsabilités incombant à l'accès en écriture

Si vous avez un accès en écriture aux pages web, inscrivez-vous à la liste de diffusion des webmestres.

Gardez à l'esprit que toutes vos modifications seront effectives et visibles automatiquement, sans autre action de la part de quiconque. En conséquence, il y a un certain nombre de choses que nous vous demandons de faire lorsque vous postez des changements ou des nouveaux fichiers :

• La FSFE est responsable du contenu des pages web. S'il vous plaît, ne postez pas de modifications qui changent le sens du texte sans l'approbation préalable d'un membre de l'équipe de la FSFE. (Ceci n'est pas nécessaire lors de la traduction d'un contenu existant)

• Lorsque vous postez des traductions, et qu'il y a une chance que d'autres puissent la relire, utilisez cette opportunité. Vous pouvez utiliser la liste de diffusion des traducteurs pour demander une relecture. Que vous traduisiez des pages ou les relisiez, nous vous encourageons à vérifier l'orthographe de vos fichiers à l'aide d'outils automatisés, comme GNU aspell, ispell ou encore votre correcteur orthographique préféré. Pour utiliser GNU aspell par exemple sur un système Debian GNU/Linux, il vous suffit d'installer les paquetages aspell et aspell-XX (où "XX" est votre code de langue), et de lancer ensuite la commande

  aspell -H -d langue -c file.xhtml

  (où "langue" est le nom du dictionnaire pour votre langue ; l'option -d peut être omise si votre locale UNIX est la même que celle du dictionnaire à utiliser).

• Assurez-vous que tous les fichiers sont des XML bien formés. Il existe un script nommé tools/validate.pl qui vous aidera à trouver les erreurs dans les balises. Le XML mal formé bloque le processus de création automatique des pages et empêche la mise à jour de la totalité du site web de la FSFE. Si vous pensez que le processus de construction des pages est bloqué, vous pouvez consulter le l'historique de la dernière construction ici.

  Le script validate.pl repose sur le module Perl XML::LibXML ; si celui-ci n'est pas installé sur votre système, vous pouvez utiliser votre validateur XML favori. Vous pouvez par exemple utiliser l'utilitaire en ligne de commande xmllint du projet libxml2 (si vous utilisez une distribution Debian GNU/Linux, installez le paquetage libxml2-utils) ; lancez la commande

  xmllint --noout file.xhtml

  et lisez les éventuels messages d'erreur.

• Assurez-vous que l'encodage du fichier soit consistant avec le contenu de l'attribut "encoding" déclaré sur la première ligne du fichier. Par exemple, si votre fichier est codé en "iso-8859-1" (également connu sous le nom de "latin-1"), la première ligne du fichier devrait être

  <?xml version="1.0" encoding="iso-8859-1" ?>

  Un autre encodage valide est l'unicode, ou "utf-8". Si vous souhaitez modifier l'encodage d'un fichier, vous pouvez utiliser l'utilitaire standard iconv, comme dans l'exemple suivant (qui convertit un fichier de l'encodage "latin1" vers l'"utf-8") ;

  iconv -f LATIN1 -t UTF8 inputfile > outputfile

Coordonnez-vous avec les autres personnes qui ont également un accès CVS afin de vous assurer que les traductions et modifications apportées par les contributeurs qui n'ont pas d'accès en écriture sont expédiées correctement après avoir été relues. Bien sûr, vérifiez ces fichiers avant de les envoyer comme vous vérifiez vos propres fichiers.

Informations complémentaires

Étant donné que les pages web de la FSFE ont un niveau européen/global et des niveaux locaux choisis par l'utilisateur, qui le complètent en apportant les informations spécifiques à chaque pays, la structure possède une certaine complexité qui est totalement cachée à l'utilisateur du site.

À moins que vous ne souhaitiez vous contenter de traduire des pages web (voir ci-dessous), prenez le temps de lire la page de référence sur la structure du site.

Un fichier de documentation Texinfo est également disponible "Webmastering FSF Europe" de Jonas Öberg, le développeur du système de construction des pages. Lisez-le afin de mieux comprendre le fonctionnement des pages web.

To top