Contribuer

Webmestres

L'équipe Web maintient et développe les sites de la FSFE — allant de fsfe.org aux sites de projet ou de campagne. Les webmestres sont des bénévoles qui améliorent l'image que l'organisation donne au monde et apportent des solutions techniques à nos efforts sur le Web.

Apprenez à nous connaître, apprenez à connaître le site

Si vous voulez avoir une idée de ce à quoi correspond travailler sur le site de la FSFE, le meilleur point de départ est de venir discuter avec nous. Certains des webmesters sont régulièrement sur le canal freenode #fsfe, où nous serons ravi de vous rencontrer et de répondre à vos questions  ! Pour connaitre ceux qui travaillent sur le site, et avec la FSFE en général, visitez la page sur notre équipe.

Votre coordinateur web est Paul Hänsch.

Introduction

Les technologies employées pour la maintenance des pages web de la FSFE seront sans doute familières à beaucoup de développeurs ou auteurs, et leurs descriptions pourraient intéresser ceux qui ne les ont pas encore découvertes.

Les traducteurs et bénévoles occasionnels auront probablement principalement à intéragir avec  :

Les volontaires qui souhaitent plus s'engager dans la maintenance du site devront également être familiers de :

Comprendre le mécanisme de construction des pages web

Les pages web de fsfe.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 dix minutes. Ainsi, toute l'édition des pages se fait dans les fichiers XML, on ne travaille jamais directement sur les fichiers HTML.

Chaque page de fsfe.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 traduits s'ils sont disponibles, et prend la version anglaise de ces fichiers sinon. De telles pages peuvent donc afficher certaines parties traduites alors que d'autres resteront encore en anglais. Par exemple, la page d'accueil, la page des nouvelles, et la page des évènements, sont construites ainsi.

Accéder aux pages Web

Les fichiers sources sont stockés sur le dépôt subversion fsfe-web, lui-même hébergé sur le serveur subversion de la FSFE. D'autres services sont disponibles sur l'instance Trac.

Pour avoir accès à ces outils, suivez les instructions suivantes :

Pour obtenir un accès en écriture au dépôt subversion, au wiki du Trac et au système de tickets, envoyez votre demande à system-hackers@fsfeurope.org.

Rapatrier une version de travail depuis Subversion

Le dépôt subversion est constitué de deux éléments majeurs pour le site de la FSFE : le SVN trunk (tronc SVN) qui est utilisé pour construire les pages du site public http://fsfe.org et la branche «test» qui est utilisée pour générer le site de test http://test.fsfe.org.

Pour le travail de tous les jours, comme ajouter des nouvelles, traduire des pages ou introduire de petites corrections, vous devrez récupérer le tronc :

svn --username VOTRE_NOM_DE_FELLOW co https://svn.fsfe.org/fsfe-web/trunk

Pour travailler sur des changements plus profonds, comme déboguer de nouvelles fonctionnalités qui pourraient casser le site, vous êtes invités à utiliser la branche de test du dépôt SVN :

svn --username VOTRE_NOM_DE_FELLOW co https://svn.fsfe.org/fsfe-web/branches/test

À noter qu'une version complète du dépôt requiert environ 800 Mo. Aussi, si vous pensez travailler uniquement sur certaines parties, vous pouvez rapatrier uniquement celles-ci. Vous pouvez parcourir la branche SVN en ligne pour trouver ce qui vous intéresse.

Pour rapatrier le SVN du "Document Freedom Day", utilisez:

svn --username VOTRE_NOM_DE_FELLOW co https://svn.fsfe.org/df-web/trunk

Travailler avec le dépôt

Dans subversion, la substitution de mot-clé doit être activée volontairement sur chaque fichier. Comme nous utilisons quelques mot-clés sur les fichiers .xml et .xhtml (par exemple le mot-clé $Author$ en pied de page), vous devriez activer les mot-clés automatiques en ajoutant dans votre fichier local ~/.subversion/config :

  enable-auto-props = yes

  [auto-props]
  *.xml = svn:keywords=Date Author Id Revision;svn:mime-type=text/xml;svn:eol-style=native
  *.xhtml = svn:keywords=Date Author Id Revision;svn:mime-type=text/xhtml;svn:eol-style=native
      

Après avoir récupéré le dépôt une première fois, vous n'aurez qu'à exécuter chaque fois

svn update

juste avant de vous mettre à travailler sur un fichier donné.

Si vous souhaitez ajouter de nouveaux fichiers au dépôt, exécutez

svn add nomdufichier

Pour permettre la substitution de mots-clés pour un nouveau fichier, exécutez

svn propset svn:keywords "Date Author Id Revision" nomdufichier

Pour envoyer vos changements sur le serveur, qu'il s'agisse d'un nouveau fichier ou de la modification d'un fichier existant, exécutez

svn commit nomdufichier

et votre éditeur par défaut s'ouvrira, vous permettant de donner une courte description des changements apportés.

Si vous êtes habitué à travailler avec CVS, vous vous adapterez facilement à SVN. Comme vous l'avez constaté, les commandes de base sont très ressemblantes. Pour en savoir plus, vous pouvez consulter un aperçu des différences entre CVS et SVN sur Subversion for CVS Users ainsi qu'un aperçu des différences entre commandes sur CVS to SVN Crossover Guide.

Vous pouvez télécharger Subversion book, un manuel détaillé de SVN (nous utilisons la version 1.5 de SVN).

Outils de coordination

Les travaux sur les pages du site Web sont coordonnés sur la liste de diffusion des webmestres (en anglais).

L'instance Trac fsfe-web fournit d'autres outils liés à la coordination comme un navigateur de dépôt SVN en ligne, un traqueur de bogues et un wiki.

Vous pourrez trouver plus d'informations sur l'utilisation du Trac sur la page TracGuide du wiki.

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

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 lorsque vous postez des changements ou des nouveaux fichiers  :

Coordonnez-vous avec les autres personnes qui ont également un accès SVN 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.

License du code source

Lorsque vous introduisez du code serveur (ex : PHP, Perl) ou du code java script au site web, veuillez respecter notre politique de licences. Plus spécifiquement, cela signifie :

Utiliser des licences personnalisées

Si vous utilisez des images ou tout autre media qui a été mis sous une Creative Commons license ou tout autre licence, vous pouvez vous assurer que les bonnes informations soient affichées en les ajoutant à la fin du document avant </html>. Voici trois exemples :


  <legal type="cc-license">

  <license>https://creativecommons.org/licenses/by-sa/3.0/</license>

    <notice>This work is published under the Creative Commons BY-SA
  3.0 Unported license by John Doe</notice>
  </legal>


  <legal>
    <license>http://www.gnu.org/licenses/fdl-1.3.txt</license>
    <notice>This page is published under the GNU Free Documentation
  License 1.3 or later</notice>
  </legal>

  <legal>
    <notice>This work is published undere the CC-BY-SA 3.0 Unported
  license or the <a href="http://artlibre.org/">Licence Art Libre
  1.3</a> at your option, etc.</notice>
  </legal>


      

Autres sites de la FSFE

En dehors du site principal fsfe.org, les bénévoles sont encouragés à contribuer aux autres sites FSFE et Fellowship  vous pourrez trouver plus d'information sur ces sites sur le wiki FSFE.

webmaster $Date: 2016-11-09 16:11:34 +0100 (Wed, 09 Nov 2016) $ $Author: jonas $ Michel Roche (Vercors - France), Jil Larner (Mont Blanc, France), Cryptie, roidelapluie, Stéphane et MDDN