Participation à linux-france

Nat nat@linux-france.org.

1. Introduction

1.1 Présentation

Ce document, destiné aux gestionnaires d'arborescences (zones) abritées sur linux-france, expose comment exploiter les ressources mises à disposition. Il s'agit pour le moment d'un brouillon, assez incomplet.

Commentaires et suggestions seront les bienvenus.

1.2 Remerciements

Le serveur et la connexion à l'Internet nous sont très généreusement offerts par NFrance Conseil (merci Laurent !).

2. Mission du maint

• recruter de nouveaux participants (auteurs de documents ou logiciels souhaitant abriter leur 'page' officielle dans sa zone)
• faire mettre à jour ou bien détruire les documents obsolètes
• respecter et faire respecter les règles et conventions en vigueur

3. Pré-requis

Remplacé par http://www.linux-france.org/prj/lfoyer/doc/htm/qui_fait_quoi.fr.htm

4. Connexion à lfo

Redondant avec: http://www.linux-france.org/prj/lfoyer/doc/htm/ssh.fr.htm

5. Maintenance des zones HTTP et FTP

Redondant http://www.linux-france.org/prj/lfoyer/doc/htm/qui_fait_quoi.fr.htm

6. Mise à jour de lfo

Redondant avec: http://www.linux-france.org/prj/lfoyer/doc/htm/qui_fait_quoi.fr.htm

7. Messagerie : redirection (adresse email)

Futur document "ressources".

8. Statistiques d'accès

Futur document "ressources".

9. Ressources offertes par le serveur

Futur document "ressources".

10. Documents publiés

10.1 Règles et conventions

Merci de scrupuleusement respecter les règles et conventions dont la liste suit. Ne pas hésiter à m'expédier vos commentaires, elles ne sont pas gravées dans le marbre !

• La licence de diffusion « par défaut » des documents publiés se trouve dans le document d'introduction. Merci d'en prendre connaissance et de la reproduire au début de ton document, en la modifiant si nécessaire.
• Ne pas mettre en péril le serveur, tenter de le pirater, y laisser fonctionner de façon permanente un programme exigeant, utiliser cron. Me faire signe si nécessaire, afin que j'obtienne l'aval des administrateurs.
• Ne publier que tes propres oeuvres, ou obtenir au préalable l'autorisation adéquate,
• Contacter l'auteur d'un document avant d'entreprendre une adaptation en français afin de lui demander l'autorisation de publier la VF,
• Ne traiter que de logiciel libre (pertinence !),
• S'assurer que le document n'est pas déjà disponible en ligne (en ce cas un lien suffit, sauf rares exceptions),
• Éviter de publier inutilement : rédiger un document traitant d'un aspect déjà exposé par une autre source d'information n'est acceptable que si ton approche est très nouvelle (autre audience, ton, approche ...). Tirer en ce cas un lien vers l'autre document, en précisant ses spécificités. Cette remarque vaut aussi pour les zones : ne pas hésiter à tirer, dans un index.html, un lien vers un document placé dans un autre répertoire mais traitant d'un sujet appartenant au thème de la zone.
• Lier chaque terme technique dont le lectorat ne connaît vraisemblablement pas la définition correcte à son article dans le JargonF (et, si nécessaire, proposer de le modifier)
• Éviter la « retape » (de nature commerciale, politique, religieuse ...), surtout non étayée
• Indiquer au début de chaque doc l'URL complète de votre version en-ligne sur lfo afin que tout lecteur sache où trouver la version à jour
• Lire les autres documents publiés et contacter les autres maints poursuivant les mêmes objectifs que les tiens afin de convenir de ce que chacun entreprend (afin d'éviter les doublons), voire (l'idéal) de rédiger un document ensemble. Ne pas hésiter à placer dans le préambule une liste de pointeurs vers des documents dont la lecture préalable est explicitement recommandée, et procéder de même dans la conclusion (« pour aller plus loin ...»)
• Publier des documents conformes aux normes et conventions en vigueur (par exemple : du HTML correct ! le vérifier avec weblint ou, mieux, avec HTML Tidy. Dater si possible au format ISO 601 (ANNÉE-MOIS-JOUR) ou approchant.
• Si tu gères une zone placer, dans ses principaux 'index.html', le code HTML suivant :

  <a href="http://www.nfrance.com"><img
  src="http://www.linux-france.org/image/nfrance.gif"></a><br>
  

10.2 Web (wlfo)

Le document principal de ta zone Web doit s'appeler index.html

N'employer que des noms de fichiers sans caractères d'espacement, accentués, ou spéciaux.

Tu peux publier sous n'importe quel format et encodage dont les spécifications sont publiques, mais sans enfreindre les normes de l'Internet. Mieux vaut publier un fichier texte au contenu digne d'intérêt qu'un inutile fichier recelant du beau FlashBiduleTrucmuche mais ne véhiculant aucune information.

Ne pas négliger d'associer aux documents des mots-clés pertinents grâce à la forme HTML <META name="keywords" content="motclé1, motclé2, ...">, et d'y préciser le nom de l'auteur.

Mieux vaut édiger les documents en SGML ou XML (dtd Linuxdoc ou DocBook) grâce à Emacs (mode psgml) ou LyX (c'est le cas avec la 1.1.5).

Sous Debian (slink) : installer Jade, puis tous les paquetages nommés dans /usr/doc/jade/README.Debian, puis :

 cd /etc
 ln -s ../../usr/lib/sgml
       

Liens

Éviter de publier des liens vers des ressources sans rapport avec le thème traité.

Types de liens

Un document publié sur wlfo ne peut contenir que les types d'URL suivants :

• lien vers l'extérieur : absolu, donc avec nom complet du protocole, de l'hôte ... Les vérifier de temps à autres
• lien vers une zone statique (sans document non dynamiquement engendré, par exemple par un script CGI) de wlfo : toujours relatifs. Le nom de serveur ne doit pas figurer danbs l'URL, et le premier caractère de son nom de répertoire ne doit pas être un '/'. Exemple : (si ton document se trouve dans un répertoire fils d'/article/) et que tu souhaites tirer un lien vers http://linux-france.org/article/toto/ il faudra utiliser l'URL "../article/toto/" et non "/article/toto/", car ce dernier sera inadéquat sur la plupart des miroirs (sur lesquels wlfo n'est pas déployé à partir de la racine).
• lien vers une zone dynamique (CGI ou autre) : utiliser l'URL complète. Exemple : le logiciel Drumpatterns ne fonctionne pas sur la plupart des miroirs car repose sur des scripts de CGI. Il faut donc le référencer de sorte que les visiteurs des miroirs soient ramenés sur le serveur principal lorsqu'ils tentent d'y accéder.
• lien vers un fichier proposé (téléchargé) : placer le fichier dans ta zone FTP et exprimer son chemin par une URL absolue de la forme ftp://ftp.linux-france.org/pub/TA-ZONE/NomFichier

Vérification des liens

Voici ma procédure de test des liens relatifs :

wget -km -np -nh --force-html -o wlfo-wgetcheck.out URL

Puis chercher les 404 dans le fichier wlfo-wgetcheck.out ainsi engendré, les corriger, et tester encore.

Projet de format unifié

Je souhaite XMLiser wlfo, probablement grâce à une ou plusieurs DTD spécifiques dérivées de DocBook (rédaction de docs destinées aux auteurs). Qui veut m'aider ?.

Adaptations (traductions)

Si tu décides d'adapter (traduire) un document il te faut, avant de publier sur lfo, obtenir l'autorisation explicite de son auteur. Mieux vaut l'obtenir avant d'entreprendre l'adaptation, ne serait-ce qu'afin d'éviter de travailler inutilement (une VF existe peut-être déjà, ou est en gestation).

Préciser explicitement, dans la VF et dans le lien principal y menant (index.html pointant vers lui), qu'il s'agit d'une adaptation.

Placer au début du document le titre de la VO ainsi que le nom de son auteur et un lien vers la version officielle.

Demander à l'auteur de la VO de pointer vers ta VF.

10.3 FTP (flfo)

Placer les archives à télécharger dans la zone ftp, et les références (« pointer dessus ») dans la zone web.

Une référence vers un fichier placé sur la zone FTP est une URL qui, pour un fichier ~/ftp/FICHIER, doit être composée ainsi : ftp://ftp.linux-france.org/pub/FICHIER. Exemple : tout fichier que tu placeras en ~/ftp/TA-ZONE/NomFichier sera déployé en ftp://ftp.linux-france.org/pub/TA-ZONE/NomFichier.

Seul inconvénient de FTP : pas de stats de l'activité. Pondération : même les stats de l'activité sur le Web ne correspondent pas à la réalité car ne tiennent pas compte de l'activité des miroirs.

10.4 Annonces

Lors de la mise en place de la zone, à l'occasion d'une importante révision ou après de nombreuses modifications tu attireras, si tu le juges bon, l'attention de lecteurs potentiels.

Cas des maints de zones personnelles : commencer par attirer l'attention des autres maints gérant une zone où votre document pourrait être publié, afin qu'ils référencent votre doc dans leurs index.html.

Vérifier que tout visiteur peut trouver votre document grâce aux index.html (donc en navigant normalement sur le site) et, dans le cas des articles, aux cartes ( /article/carte_classee.html, où il doit apparaître au plus tard 25 heures après publication).

Puis publier une annonce :

• sur la page de garde de linux-france, dans le cartouche « Quoi d'neuf ? » : m'expédier ce que je dois y insérer (HTML avec texte (court !), s'inspirer de l'existant).
• dans les forums Usenet adéquats
• sur les sites spécialisés ( linux-center, http://linuxfr.org, LinuxApps, freshmeat, slashdot ... merci de m'expédier des URL de sites valables !). Publier avec discernement, en fonction de la langue et de l'importance de l'annonce !

Mieux vaut ne pas pratiquer d'autopromotion sauvage ou forcenée. Placer l'URL du document à promouvoir et quelques mots d'explications dans ta signature (mail, news et articles publiés) suffit, avec un rien de patience, et ne lassera les lecteurs.

Ne négligez pas de me faire signe si vos efforts ou ceux d'un auteur dont vous avez intégré l'oeuvre dans votre zone ne sont pas salués dans la liste des contributeurs.

10.5 Suivi

À vérifier :

• l'index.html de la zone pointe vers votre document,
• les versions publiées sur les sites miroirs sont conformes et à jour

11. Publicité

je souhaite améliorer lfo.

Ikarios, jusqu'à présent, payait. lfo profitait aussidu très notable et utile concours de NFRANCE (qui offre l'hébergement).

la vaste campagne d'améliorations envisagée comprend (commentaires et suggestions bienvenus) :

• 'recrutement' et 'encouragement' d'auteurs et de gestionnaires de zones,
• XMLisation (DocBook) des sources (dans un premier temps les versions publiées sur le Web demeureraient encodées en HTML),
• facilitation de la navigation,
• enrichissement graphique,
• relectures (mercenaires payés à l'erreur trouvée, avec budget pris sur la part de l'auteur),
• gestion des outils (lidies (mailing lists), CVS ...)
• outil grâce auquel les lecteurs isoleront facilement les modifications effectuées dans un document (semblable au ediff d'Emacs. par cookies (? lourd !) ou saisie de la date de la dernière consultation (?) ...
• Amélioration de l' interface vers les moteurs de recherche
• des news (et des rédacteurs ...) ?
• bannières publicitaires offertes aux projets Open Source
• autonomie financière de linux-france,

avantages de l'XMLisation

• XSL (engendrement auto de mises en pages différentes)
• multitudes de formats des avatars engendrables automatiquement (PS, HTML, txt ... n'importe quoi, en fait, avec un peu de boulot)
• avatars corrects (certification lexicale et syntaxique des éléments de structuration + engendreur plus 'carré' qu'un humain)
• ds l'air du temps, dc nombre croissant d'outils (éditeurs, backends, bibliothèques d'analyse ...)
• balisage (dc indexation) sémantique possible (un robot de recherche adapté peut dès lors cas chercher un mot donné employé ds un contexte précis (ligne de commande, nom de fichier ...))
• browsers grokant du XML : pour bientôt

linux-france abritera donc des bannières de publicité pertinentes (doivent concerner le logiciel libre ou Open Source) et acceptées par les auteurs des documents où elles apparaîtront.

notes :

• cela me fait suer, ms je ne vois pas d'autre moyen car mes divers appels à volontaires demeurèrent presque vains
• n'en tirererai pas de quelconque profit

l'approche proposée :

• NUL NE SERA CONTRAINT DE PUBLIER DE LA PUB DANS SES DOCUMENTS
• chaque bannière sera au préalable validée par l'auteur du doc où elle paraîtra. il se chargera lui-même des manipulations nécessaires
• les comptes seront publiés de sorte que les intéressés (auteurs) constatent que nul n'abuse
• 15% des profits seront versés dans une caisse destinée à payer des intervenants qui amélioreront le site, 1% sera utilisé pour la gestion de l'ensemble et le reste sera versé aux auteurs sous forme de droits d'auteur
• un gestionnaire de zone est considéré comme l'auteur de son 'index.html' (note : le profit découlant des pubs placées dans les index.html de zones gérées par Nat sera intégralement reversé à la caisse d'amélioration)
• les 'chantiers' d'amélioration du site seront spécifiés et recettés par le collège des gestionnaires de zones et feront l'objet d'appels d'offres
• les autres détails sont spécifiés ci-après (ds la 'proposition aux annonceurs')

il va de soi que vs ne pourrez mener vos propres campagnes de pub (accepter directement les bannières d'un annonceur) ms que les annonceurs que vs trouverez pourront contracter.

un annonceur peut fort bien se contenter de publier un document rédigé par lui, et ne devra ansi payer 16% du coût théorique nominal ... mais 'maintiendra' son oeuvre.

vs demeurez bien entendu libres de laisser vos oeuvres sur linux-france, de les retirer (merci de m'en informer), d'ignorer cette campagne ou d'y participer, de me traiter d'abruti ... pas de pb !

si vs ne souhaitez pas publier de bannière merci de me l'indiquer (préciser votre nom, prénom, et l'URL de vos zone et des documents dt vous êtes l'auteur) afin que je ne vous expédie pas de proposition.

la gestion de l'affichage proprement dit des bannières sera assurée par l'auteur concerné (il suffira d'insérer le fichier graphique durant la période de publication 'acquise' par l'annonceur)

un conseil, composé des gestionnaires de zones volontaires et fédéré par une lidie, décidera de tt cela. je resterai à la barre, sur le plan théorique, afin de gérer les urgences (et rendrai en ce cas compte au conseil) et (surtout) de prévenir tt délire (engueulade suivie de 'on casse tout !'), si nécessaire en franchissant le Rubicon. ce conseil spécifiera les actions à entreprendre, rédigera les appels d'offres correspondants, et désignera prestataires et fournisseurs.

vos commentaires seront les bienvenus

documentation destinée aux annonceurs potentiels

12. Miroirs

Tout un chacun peut librement et sans formalité installer un miroir du contenu de wlfo grâce à la commande suivante :

rsync -azH --delete rsync.linux-france.org::wlfc NomRépertoireLocal

Merci de ne pas utiliser d'autre méthode de synchronisation du miroir.

Les entrées d'index.html menant à des CGI renvoient vers le serveur principal car la plupart des miroirs ne tolèrent pas les CGI sans examen préalable.

DEVNAT FIXME zone ftp aussi !

Je préfère que les visiteurs y accèdent via une URL l'origine des informations publiées (par exemple en http://www.TonNomDeDomaine/miroir/linux-france/... mais ce n'est pas obligatoire.

Si tu souhaites le rendre public ne pas hésiter à me contacter afin que je l'insère dans la liste des miroirs.

Si tu peux rendre les statistiques d'accès à ton miroir disponibles (pas obligatoirement publiques) merci de m'expédier l'URL ou la procédure de récupération. Je les emploierai afin de déterminer ce qui intéresse les visiteurs.