Qui fait quoi sur lfo <author> <name> M4_EMAIL_URL_SGML </name> </author> <date> $Revision: 1.17 $ $Date: 2004/04/17 13:34:29 $ </date> <abstract> Qui fait quoi, comment, sur linux-france.org </abstract> </titlepag> <toc> Version générée le M4_DATE(`fr')  <#if output="html"> <htmlurl url="../.." name="Index des documents"> </#if> Vous trouverez la dernière version du présent document à l'adresse: <newline> <tt><url url="M4_SOFTWARE_URL"></tt> <sect>Profils Plusieurs types de contributeurs: <itemize> <item>Les chefs de rubriques. <item>Les assistants avec compte Unix. <item>Les assistants sans compte Unix. <item>Les administrateurs. </itemize> Chaque contributeur peut appartenir à plusieurs catégories à la fois suivant le travail qu'il réalise. <sect>Les chefs de rubriques Les chefs de rubriques ont un compte Unix sur M4_SITE_NAME. Ils gérent une ou plusieurs zones publiques. Il connaissent le travail réalisé par les assistants de leur rubrique, et maintiennent son index. <sect>Les assistants Les assistants ont ou n'ont pas de compte Unix. Ils réalisent un travail dans une sous-rubrique. <sect>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. <sect>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. <sect>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. <sect>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 <tt>html/</tt> et <tt>ftp/</tt> de chaque compte. Tous ne seront pas recopiés. Les répertoires recopiés sont définis par le fichier <tt>authsync.conf</tt>. Le résultat de la dernière recopie est tracé dans les fichier <tt>authsync.log.html</tt>. La recopie est effectuée une fois par heure, à la 20ième minute. <sect>Les fichiers authsync.conf et authsync.log.html Le fichier M4_AUTHSYNC_CONF_URL_SGML définit la synchronisation des comptes avec l'espace publique. L'option <tt>":delete"</tt> 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 <tt>--delete</tt> 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 <htmlurl name="authsync_neuneu_diff.log.html" url="http://www.linux-france.org/maint/authsync_neuneu_diff.log.html"> Le fichier <htmlurl name="authsync.log.html" url="http://www.linux-france.org/maint/authsync.log.html"> trace le résultat de la synchronisation des zones avec l'espace publique. <sect>Comment bien vous organiser Cette section s'adresse aux assistants ayant un compte Unix sur lfo. <itemize> <item>Voici un point à bien comprendre. Il y a deux synchronisations. La première synchronise les fichiers de votre ordinateur vers votre compte sur lfo. C'est à vous de la déclancher à chaque fois que vous avez mis à jour votre arborescence et que vous voulez la publier sur lfo. La seconde synchronisation est automatique (après demande) et consiste à synchroniser ce qu'il y a dans votre compte lfo vers l'arborescence publique du site lfo. <item> Vous vous placez chez vous, sur votre babasse Unix, dans un compte banalisé. Vous n'êtes pas sur la machine linux-france. Vous vous placez dans votre répertoire de travail (<tt>$HOME</tt> ou <tt>~/</tt>). <item> Vous créer, par exemple, le répertoire <tt>~/public_html/www.linux-france.org/</tt>. 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 <tt>~/public_html/www.linux-france.org/</tt> par le répertoire que vous aurez choisi. <item> Vous allez dans ce répertoire et vous créez les répertoires <tt>html/</tt> et <tt>ftp/</tt>. Sous reserve d'une ou plusieurs synchronisations, ce qui est dans le répertoire <tt>html/</tt> ira publiquement sur <url url="http://www.linux-france.org/">. Ce qui est dans le répertoire <tt>ftp/</tt> ira sur <url url="ftp://ftp.linux-france.org/pub/">. <item> Par exemple, si vous voulez avoir votre documentation disponible à l'url http://www.linux-france.org/article/madoc/, il vous faut créer l'arborescence <tt>article/madoc/</tt> dans le répertoire <tt>html/</tt>. Si vous voulez avoir votre documentation disponible à l'url ftp://ftp.linux-france.org/pub/article/madoc/, il vous faut créer l'arborescence <tt>article/madoc/</tt> dans le répertoire <tt>ftp/</tt>. Au final, vous avez alors créé les arborescences<newline> <tt>~/public_html/www.linux-france.org/html/article/madoc/</tt><newline> <tt>~/public_html/www.linux-france.org/ftp/article/madoc/</tt> <item>Ensuite, il vous faut recopier récursivement les répertoires <tt>html/</tt> et <tt>ftp/</tt> sur lfo. Vous utilisez la commande rsync avec ssh donnée plus loin. <item>Pour finir, vous devez demandez sur la liste mlfo de synchroniser vos répertoires <tt>html/article/madoc/</tt> et <tt>ftp/article/madoc/</tt> sur la partie publique du site lfo. Il y aura une ligne de plus dans le fichier M4_AUTHSYNC_CONF_URL_SGML du type: <verb> COMPTE:article/madoc/ </verb> Le reste sera automatique. </itemize> Voici en résumé les commandes Unix à exécuter chez vous, sur votre ordinateur, pour être dans un bon environnement de travail. <verb> # 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/ </verb> Ensuite, vous travaillez dans les répertoires précédemment créés, dans une sous-arborescence du type <tt>html/article/madoc/</tt>. 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 : <verb> # 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/ </verb> Pour finir, si votre compte sur lfo s'appelle <tt>COMPTE</tt>, vous recopiez votre travail avec la commande suivante: <verb> rsync -e ssh -alptvz --delete --safe-links html ftp COMPTE@linux-france.org: </verb> Mettez ces commandes dans un script et tout sera parfaitement synchronisé après chaque modification. <sect>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 : <verb> ssh COMPTE@linux-france.org ~lf/bin/authsync_demand </verb> <sect>Liste des contributeurs Le document <url url="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 <tt>quefaisje.html</tt>. Il doit être placé dans le répertoire html/ mais ce peut être un simple lien symbolique sur un autre fichier. <verb> > "Tu pourrais donner un exemple ?" </verb> <url url="http://www.linux-france.org/~glamiral/quefaisje.html"> La liste des comptes ayant un répertoire html/ est <url url="http://www.linux-france.org/maint/hplist.html"> <verb> > Est-ce par rapport à Linux-France ou par rapport > aux documentations du site de chacun? </verb> 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 <url url="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. <sect>Nouvelle contribution, Mode d'emploi <verb> 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 </verb> </article>