Version générée le Samedi 17 avril 2004
Vous trouverez la dernière version du présent document à l'adresse:
http://www.linux-france.org/prj/lfoyer
Plusieurs types de contributeurs:
Chaque contributeur peut appartenir à plusieurs catégories à la fois suivant le travail qu'il réalise.
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.
Les assistants ont ou n'ont pas de compte Unix. Ils réalisent un travail dans une sous-rubrique.
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.
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.
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.
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.
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.
Cette section s'adresse aux assistants ayant un compte Unix sur lfo.
$HOME ou ~/).
~/public_html/www.linux-france.org/. Ce répertoire
contiendra tout ce qui devra être copié dans votre compte
sur lfo. Vous pouvez travailler dans un autre répertoire
mais dans ce cas il faudra adapter la lecture de la présente
documentation en remplaçant
~/public_html/www.linux-france.org/ par le
répertoire que vous aurez choisi.
html/ et ftp/. Sous reserve d'une ou plusieurs
synchronisations, ce qui est dans le répertoire html/ ira
publiquement sur
http://www.linux-france.org/. Ce qui est
dans le répertoire ftp/ ira sur
ftp://ftp.linux-france.org/pub/.
article/madoc/ dans le répertoire
html/.
Si vous voulez avoir votre documentation disponible
à l'url ftp://ftp.linux-france.org/pub/article/madoc/, il vous faut créer
l'arborescence article/madoc/ dans le répertoire
ftp/.
Au final, vous avez alors créé les arborescences~/public_html/www.linux-france.org/html/article/madoc/~/public_html/www.linux-france.org/ftp/article/madoc/
html/ et ftp/ sur lfo. Vous
utilisez la commande rsync avec ssh donnée plus loin.
html/article/madoc/ et
ftp/article/madoc/ sur la partie publique du site lfo. Il y
aura une ligne de plus dans le fichier
authsync.conf du
type:
COMPTE:article/madoc/Le reste sera automatique.
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.
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
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.
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