Qui fait quoi sur lfo

Gilles LAMIRAL

$Revision: 1.17 $ $Date: 2004/04/17 13:34:29 $
Qui fait quoi, comment, sur linux-france.org

Version générée le Samedi 17 avril 2004

Index des documents

Vous trouverez la dernière version du présent document à l'adresse:
http://www.linux-france.org/prj/lfoyer

1. Profils

2. Les chefs de rubriques

3. Les assistants

4. Les assistants sans compte Unix

5. Les assistants avec compte Unix

6. Les administrateurs.

7. Synchronisation des comptes

8. Les fichiers authsync.conf et authsync.log.html

9. Comment bien vous organiser

10. La synchro sans attendre

11. Liste des contributeurs

12. Nouvelle contribution, Mode d'emploi


1. Profils

Plusieurs types de contributeurs:

Chaque contributeur peut appartenir à plusieurs catégories à la fois suivant le travail qu'il réalise.

2. Les chefs de rubriques

Les chefs de rubriques ont un compte Unix sur www.linux-france.org. Ils gérent une ou plusieurs zones publiques. Il connaissent le travail réalisé par les assistants de leur rubrique, et maintiennent son index.

3. Les assistants

Les assistants ont ou n'ont pas de compte Unix. Ils réalisent un travail dans une sous-rubrique.

4. Les assistants sans compte Unix

Ceux qui n'ont pas de compte Unix envoient leur travail au chef de rubrique par courriel ou tout autre moyen qui arrange les deux parties. Ils utilisent la liste de diffusion (même sans être inscrit) pour poser des questions de tout ordre.

5. Les assistants avec compte Unix

Les assistants ayant un compte Unix l'utilisent, demandent à un administrateur de synchroniser leur compte avec la sous-rubrique publique concernée et informent le chef de la rubrique des nouvelles modifications afin qu'il mette à jour l'index.

6. Les administrateurs.

Les administrateurs gèrent techniquement l'ensemble du site. Ils peuvent créer un compte Unix, ajouter de nouvelles fonctionnalités. Ils sont à l'écoute de l'ensemble des contributeurs et des utilisateurs.

7. Synchronisation des comptes

La partie publique du site est réalisée par une recopie de certains répertoires des comptes Unix. Les répertoires recopiés sont des sous-répertoires des répertoires html/ et ftp/ de chaque compte. Tous ne seront pas recopiés. Les répertoires recopiés sont définis par le fichier authsync.conf. Le résultat de la dernière recopie est tracé dans les fichier authsync.log.html. La recopie est effectuée une fois par heure, à la 20ième minute.

8. Les fichiers authsync.conf et authsync.log.html

Le fichier authsync.conf définit la synchronisation des comptes avec l'espace publique. L'option ":delete" en fin de ligne signale qu'il faut éliminer les fichiers de l'espace publique qui ne figurent pas dans la zone privée. Ceci correspond à l'utilisation de l'option --delete de rsync. C'est utile pour désengorger la zone publique lorsque la rubrique est synchronisée depuis un seul compte.

Si vous êtes l'unique responsable d'une sous-arborescence alors je vous demande de me le signaler afin que j'ajoute l'option delete à la synchronisation. La simulation de l'usage de cette option "delete" est tracée dans le fichier authsync_neuneu_diff.log.html

Le fichier authsync.log.html trace le résultat de la synchronisation des zones avec l'espace publique.

9. Comment bien vous organiser

Cette section s'adresse aux assistants ayant un compte Unix sur lfo.

Voici en résumé les commandes Unix à exécuter chez vous, sur votre ordinateur, pour être dans un bon environnement de travail.

# vous vous placez dans votre $HOME
# chez vous, sur votre ordinateur, pas sur lfo.
cd

# création de votre enfer
mkdir -p public_html/www.linux-france.org/  

# allez y
cd       public_html/www.linux-france.org/  

# création des répertoires "publiques"
mkdir -p html/ ftp/
mkdir -p html/ ftp/

Ensuite, vous travaillez dans les répertoires précédemment créés, dans une sous-arborescence du type html/article/madoc/. Vous y êtes complètement libre. Faites en sorte que tous les fichiers et répertoires soient accessibles à tous, sinon il y aura des problèmes de recopie. Voici de bonnes commandes pour assurer les bonnes permissions :

# vous êtes chez vous, sur votre ordinateur, pas sur lfo,
# dans le répertoire public_html/www.linux-france.org/
find html -type d -print0 | xargs -0 chmod a+r+x # droits des rep sous html/
find ftp  -type d -print0 | xargs -0 chmod a+r+x # droits des rep sous ftp/
find html -type f -print0 | xargs -0 chmod a+r # droits des fich sous html/
find ftp  -type f -print0 | xargs -0 chmod a+r # droits des fich sous ftp/

Pour finir, si votre compte sur lfo s'appelle COMPTE, vous recopiez votre travail avec la commande suivante:


rsync -e ssh -alptvz --delete --safe-links html ftp COMPTE@linux-france.org:

Mettez ces commandes dans un script et tout sera parfaitement synchronisé après chaque modification.

10. La synchro sans attendre

Préssé de lancer la synchro des comptes sur le site public ? Si votre nom de compte sur lfo est COMPTE, remplacez COMPTE par le nom du votre compte :

ssh COMPTE@linux-france.org ~lf/bin/authsync_demand

11. Liste des contributeurs

Le document http://www.linux-france.org/article/contributeur/ liste le travail réalisé par les contributeurs. Une mise à jour par les contributeurs eux-mêmes serait appréciable, ce document deviendrait l'index général trié par auteur.

Je vais le passer sous cvs mais comme très peu de contributeurs utilisent cvs, nous préférons la solution suivante:

Chacun édite un fichier HTML décrivant ces activités sur lfo et le nomme quefaisje.html. Il doit être placé dans le répertoire html/ mais ce peut être un simple lien symbolique sur un autre fichier.

> "Tu pourrais donner un exemple ?"
http://www.linux-france.org/~glamiral/quefaisje.html

La liste des comptes ayant un répertoire html/ est http://www.linux-france.org/maint/hplist.html

> Est-ce par rapport à Linux-France ou par rapport 
> aux documentations du site de chacun?

Comme vous voulez. Ce peut être juste un lien sur un document existant répondant aux questions. Simple et utile. C'est juste une aide pour tous afin de mieux gérer le projet lfo. C'est aussi un moyen de concrétiser l'index par auteur.

Je suis prêt à amméliorer la présentation de l'index http://www.linux-france.org/maint/hplist.html mais s'il n'y a rien derrière, cela n'en vaut pas la peine.

Si quelqu'un a une meilleure solution, nous sommes preneur.

12. Nouvelle contribution, Mode d'emploi


Que faire lorsqu'un volontaire désire relire/traduire/écrire des docs?
Nous aimerions éviter  que toutes les mises  à jour passent par Nat ou
Gilles. Algorithme:

Ce volontaire a-t'il une zone sur lfo?

Si oui => il l'utilise et nous avertit des changements par la mlfo
       => relecture par qui veut bien
       => news sur page d'acceuil

Si non => Dans qu'elle zone mettre la doc ou le projet ?
       => Discussion rapide sur mlfo
       => Prise en charge par le responsable de la zone
          (reception par mail avec l'auteur)
          Création de zone au besoin

Si le responsable d'une zone n'est pas là
       => zone temporaire pour relecteurs et lecteurs potentiels
Quand il revient
       => il se synchronise avec lfo, rsync à l'envers ou autre,
          il se débrouille en posant des questions sur la mlfo

Que faire quand un contributeur ne donnes plus signe de vie ?
D'abord nous essayons de le contacter et de comprendre
pourquoi il n'est pas là. Ensuite nous appliquons ceci:
 
 1) S'il ne répond plus à l'adresse email
 2) S'il ne se logue plus sur lfo
 3) Si nous n'avons plus de nouvelles de nulle part
 4) Si son retour n'est pas prévu (il peut partir à l'armée 
    ou à babeloued et nous demander d'attendre)

 5) Si 1)+2)+3)+4) pendant, disons, 8 mois 
    alors il "perd" sa zone publique (pas sa zone privée)
 6) Discussion sur la mlfo et attribution à un nouveau responsable