Participez au projet

Il n'existe à ce jour pas de version anglaise stable.

Comment faire ?

La première chose à faire est d'informer l'équipe du projet, dont vous trouverez les coordonnées dans la rubrique liste de diffusion. Cela lui permettra de vous indiquer si d'autres personnes ont commencé, comment diviser les tâches... L'objectif de cettte étape est d'éviter que plusieurs personnes ne traduisent ou relisent la même chose, ce qui serait dommage. Une seconde chose à vérifier est la présence sur votre système d'un client svn. Ce paquet n'est pas indispensable mais, si vous souhaitez faire une relecture, il s'avère très utile pour envoyer ensuite les corrections.
Une troisième chose à installer est le paquet subversion (svn) qui vous permettra de récupérer les sources anglaises du livre dans sa version de développement.

Traduire

Récupérez tout d'abord le source xml anglais. Pour cela:

svn co svn://svn.linuxfromscratch.org/HLFS/trunk/book/

Vous pouvez aussi consulter la version anglaise directement en ligne au format html ici.
Vous pouvez alors traduire librement les fichiers xml (les modifier en direct en écrasant le texte anglais). Vous pouvez, si vous le souhaitez, traduire les commentaires des scripts, à savoir ce qui se trouve après les #.

Vous pouvez, pour un grand nombre de fichiers, vous inspirer de ce qui a été traduit dans HLFS en html (pour les descriptions).


Vous pouvez utiliser n'importe quel éditeur de texte pour ouvrir les fichiers. l'usage d'un traitement de texte est aussi possible en faisant bien attention d'enregistrer le fichier au format texte. Parmi les éditeurs du monde Unix, vous trouverez notamment vim, emacs mais aussi des éditeurs plus simples comme kate, gedit, kedit. Dans le monde Windows, vous pouvez utiliser du plus simple éditeur, tel que notepad, au plus complexe, comme Morphon XML.

Lorsque vous avez fini de traduire un répertoire, faites, depuis son répertoire parent:

tar cvzpf lfs.tar.gz le_repertoire

ou:

tar cvjpf lfs.tar.bz2 le_repertoire

Vous n'avez enfin qu'à envoyer ce fichier (soit celui de svn diff soit l'archive) à l'équipe qui répercutera vos corrections dans l'ouvrage. N'hésitez pas à signaler si vous souhaitez ou non voir que votre pseudo ou nom apparaisse dans ceux figurant parmi les membres de l'équipe LFS sur le site.

Relecture

Téléchargez d'abord la version SVN du livre contenant les fichiers txt. En même temps, récupérez la version anglaise. Pour ce faire, faites:

svn co svn://svn.linuxfromscratch.org/hlfs/trunk/book

Vous pouvez aussi consulter la version anglaise directement en ligne au format txt ici.
Une fois les deux livres téléchargés (ou le txt français sous les yeux en parallèle au livre anglais en ligne), vous pourrez facilement comparer la version traduite et originale.


Vous pouvez alors faire toutes les corrections souhaitées.
La relecture nécessite de relire le texte anglais et le texte français, notamment pour vérifier que des passages n'ont pas été oubliés mais aussi pour vérifier qu'aucun contresens n'a lieu. Les corrections nécessaires seront apportées au fichier.

Vous pouvez utiliser n'importe quel éditeur de texte pour ouvrir les fichiers. l'usage d'un traitement de texte est aussi possible en faisant bien attention d'enregistrer le fichier au format texte. Parmi les éditeurs du monde Unix, vous trouverez notamment vim, emacs mais aussi des éditeurs plus simples comme kate, gedit, kedit. Dans le monde Windows, vous pouvez utiliser du plus simple éditeur, tel que notepad, au plus complexe, comme Morphon XML.

Ce travail est assez personnel. Mais vous n'êtes pas seul. Vous pouvez aussi compter sur une aide humaine. Voir la rubrique Support du site. En tout état de cause, n'hésitez pas à demander de l'aide.

À chaque début de travail si vous le faites en plusieurs jours, faites depuis la racine du répertoire du livre (où se trouve general.ent):

svn update

Cela vous tiendra informé des éventuelles modifications intervenues sur le livre et qui vous concernent de près ou de loin.

Au terme de ce travail, lancez à partir de la racine du répertoire du livre (là où se trouve general.ent) la commande:

svn diff >>fichier

Cette commande permet de lister les différences existant entre votre copie locale du livre et celle que vous aviez téléchargée. Le >>fichier redirige le résultat de cette analyse dans "fichier". Vous pouvez le nommer à votre guise.


Si vous n'avez pas svn et que vous ne souhaitez pas l'installer, vous pouvez faire les modifications et, au lieu de svn diff, mettre tous les fichiers auxquels vous avez touchés dans une archive (par exemple en les rassemblant dans un dossier vide puis, depui´s le répertoire parent de ce dossier, en tapant:

tar cvzpf lfs.tar.gz nom_du_repertoire_qui_contient_les_fichiers

ou:

tar cvjpf lfs.tar.bz2 nom_du_repertoire_qui_contient_les_fichiers

Vous n'avez enfin qu'à envoyer ce fichier (soit celui de svn diff soit l'archive) à l'équipe qui répercutera vos corrections dans l'ouvrage. N'hésitez pas à signaler si vous souhaitez ou non voir que votre pseudo ou nom apparaisse dans ceux figurant parmi les membres de l'équipe LFS sur le site.

D'avance merci de nous aider, et peut-être l'expérience vous motivera-t-elle à en faire d'autres, où le travail de relecture et de traduction est bien plus massif.