Go to:
Gentoo Home
Documentation
Forums
Lists
Bugs
Planet
Store
Wiki
Get Gentoo!
Gentoo's Bugzilla – Attachment 28455 Details for
Bug 46371
[fr] Update for the French version of doc-tipsntricks.xml (0.8 - CVS 1.3) - Trucs et astuces pour le développement de la documentation
Home
|
New
–
[Ex]
|
Browse
|
Search
|
Privacy Policy
|
[?]
|
Reports
|
Requests
|
Help
|
New Account
|
Log In
[x]
|
Forgot Password
Login:
[x]
doc-tipsntricks.xml - French translation of version 0.8 (CVS 1.3)
doc-tipsntricks.xml (text/plain), 11.72 KB, created by
Olivier Fisette (RETIRED)
on 2004-03-31 09:44:01 UTC
(
hide
)
Description:
doc-tipsntricks.xml - French translation of version 0.8 (CVS 1.3)
Filename:
MIME Type:
Creator:
Olivier Fisette (RETIRED)
Created:
2004-03-31 09:44:01 UTC
Size:
11.72 KB
patch
obsolete
><?xml version='1.0' encoding="UTF-8"?> ><!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> ><!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/fr/doc-tipsntricks.xml,v 1.2 2004/03/13 01:18:02 neysx Exp $ --> > ><guide link="/doc/fr/doc-tipsntricks.xml" lang="fr"> ><title>Trucs et astuces pour le développement de la documentation</title> ><author title="Auteur"> > <mail link="swift@gentoo.org">Sven Vermeulen</mail> ></author> ><author title="Correcteur"> >   <mail link="neysx@gentoo.org">Xavier Neys</mail> ></author> ><author title="Traducteur"> > <mail link="olivier.fisette@sympatico.ca">Olivier Fisette</mail> ></author> > ><abstract> >Quelques trucs et astuces qui faciliteront le travail des développeurs Gentoo >(ou qui le rendront impossible :) ></abstract> > ><license/> > ><version>0.8</version> ><date>30 mars 2004</date> > ><chapter> ><title>Paramétrer votre environnement local</title> ><section> ><title>Environnement local pour les contributeurs</title> ><body> > ><p> >Créez un répertoire dédié au développement de la documentation. à titre >d'exemple, nous utiliserons <path>~/work/gentoo/doc</path>. Dans ce répertoire, >créez un sous-répertoire dans lequel vous conserverez la documentation (à jour) >en anglais (par exemple, <path>en/</path>). ></p> > ><p> >Téléchargez l'archive tar la plus récente de la documentation anglaise : ></p> > ><pre caption="Télécharger la documentation anglaise"> ># <i>wget http://www.gentoo.org/dyn/doc-snapshots/docs-latest-en.tar.bz2</i> ></pre> > ><p> >Désarchivez la documentation dans le répertoire <path>en/</path>. Vous >disposez maintenant d'un instantané à jour de la documentation anglaise. >Chaque fois que vous souhaiterez mettre à jour votre instantané, vous pourrez >télécharger l'archive à nouveau, ou alors naviguer dans la documentation et >ajouter <path>?passthru=1</path> à l'URL. Par exemple : ></p> > ><pre caption="Mettre à jour un document en anglais"> ># <i>wget http://www.gentoo.org/doc/en/alsa-guide.xml?passthru=1 -O alsa-guide.xml</i> ></pre> > ><p> >Si vous voulez participer à la traduction de la documentation, créez un >répertoire pour votre langue dans lequel vous garderez les traductions >courantes : ></p> > ><pre caption="Télécharger un instantané pour votre langue"> ># <i>mkdir </i><comment>${LANG}</comment> ># <i>cd </i><comment>${LANG}</comment> ># <i>wget http://www.gentoo.org/dyn/doc-snapshots/docs-latest-</i><comment>${LANG}</comment><i>.tar.bz2</i> ># <i>tar xvjf docs-latest-*.tar.bz2</i> ></pre> > ><p> >Lorsque vous mettez un document à jour, copiez-le toujours à partir de ><path>${LANG}/</path> vers le répertoire racine >(<path>~/work/gentoo/doc</path>). Ensuite, modifiez cette copie. Vous devez >conserver l'original afin de créer un correctif (« patch ») : ></p> > ><pre caption="Créer un correctif pour une mise à jour"> ># <i>diff -uNt </i><comment>${LANG}</comment><i>/alsa-guide.xml alsa-guide.xml</i> > alsa-guide.diff ></pre> > ></body> ></section> ><section> ><title>Dépôt CVS en ligne</title> ><body> > ><p> >Vous pouvez utiliser notre <uri link="/cgi-bin/viewcvs.cgi">dépôt CVS en >ligne</uri> pour déterminer les différences entre des versions d'un même >document. Le dépôt principal pour les documents en anglais est <uri >link="/cgi-bin/viewcvs.cgi/gentoo/xml/htdocs/doc/en/?sortby=date">intégralement >disponible</uri>. Notez que le dépôt CVS en ligne est mis à jour toutes les >heures. ></p> > ></body> ></section> ><section> ><title>Dépôt local pour les développeurs</title> ><body> > ><p> >Créez un répertoire dédié à Gentoo, par exemple ><path>~/work/gentoo/doc</path>. Ensuite, créez un sous-répertoire nommé ><path>cvs/</path> dans lequel vous conserverez un instantané du CVS : ></p> > ><pre caption="Obtenir un instantané du CVS"> ># <i>mkdir cvs; cd cvs/</i> ># <i>export CVSROOT=</i><comment><votre nom d'utilisateur></comment><i>@cvs.gentoo.org:/home/cvsroot</i> ># <i>cvs co doc</i> ></pre> > ><p> >Pour mettre à jour l'instantané du CVS, exécutez <c>cvs update -dP</c> dans >le répertoire <path>cvs/doc</path>. ></p> > ></body> ></section> ></chapter> ><chapter> ><title>Tester GuideXML</title> ><section> ><title>Environnement de test</title> ><body> > ><p> >D'abord, créez un répertoire <path>test/</path> dans lequel vous conserverez ><path>guide.dtd</path>, <path>main.css</path> ainsi que quelques images : ></p> > ><pre caption="Créer l'environnement de test"> ># <i>mkdir test</i> ># <i>cd test</i> ># <i>mkdir dtd css images</i> ># <i>wget -P dtd/ http://www.gentoo.org/dtd/guide.dtd</i> ># <i>wget -P dtd/ http://www.gentoo.org/dtd/book.dtd</i> ># <i>wget -P css/ http://www.gentoo.org/css/main.css</i> ># <i>wget -P images/ http://www.gentoo.org/images/gbot-s.gif \ > http://www.gentoo.org/images/gridtest.gif \ > http://www.gentoo.org/images/gtop-s.jpg \ > http://www.gentoo.org/images/line.gif \ > http://www.gentoo.org/images/netraverse-gentoo.gif</i> ></pre> > ><p> >Téléchargez une version spéciale de <path>guide.xsl</path> disponible sur <uri >link="http://dev.gentoo.org/~swift/local/guide.xsl">l'espace Web de >SwifT</uri>. Cette version est adaptée pour la transformation locale de >GuideXML en HTML. ></p> > ><pre caption="Télécharger guide.xsl"> ># <i>wget http://dev.gentoo.org/~swift/local/guide.xsl</i> ></pre> > ><p> >Terminez en éditant <path>/etc/xml/catalog</path> pour y ajouter la ligne >suivante : ></p> > ><pre caption="Addenda à /etc/xml/catalog"> ><rewriteURI uriStartString="/dtd" rewritePrefix="<i>/chemin/vers/répertoire-dtd</i>"/> ></pre> > ><p> >Bien sûr, changez <c>/chemin/vers/répertoire-dtd</c> par le chemin du répertoire >où vous avez téléchargé les fichiers <path>guide.dtd</path> et ><path>book.dtd</path>. ></p> > ></body> ></section> ><section> ><title>Tester un guide Gentoo</title> ><body> > ><p> >Pour tester un guide Gentoo, vérifiez d'abord si sa syntaxe XML est >valide : ></p> > ><pre caption="Utiliser xmllint pour vérifier les guides"> ># <i>xmllint --valid --noout alsa-guide.xml</i> ></pre> > ><p> >Si <c>xmllint</c> se termine sans afficher quoi que ce soit, cela indique que >le fichier est exempt d'erreurs (du moins en ce qui concerne les balises XML). >La prochaine étape est la conversion du fichier en HTML. L'outil idoine est ><c>xsltproc</c> : ></p> > ><pre caption="Conversion en HTML"> ># <i>xsltproc --novalid test/guide.xsl alsa-guide.xml > test/alsa-guide.html</i> ></pre> > ><p> >Si aucune erreur n'est affichée, vous devriez pouvoir pointer votre >navigateur vers ><uri>file:///home/user/work/gentoo/doc/test/alsa-guide.html</uri> pour >consulter le document résultant de la conversion. Dans tous les autres cas, >vous devrez corriger votre guide jusqu'à ce qu'il fonctionne convenablement. ></p> > ></body> ></section> ><section> ><title>Tester le Manuel Gentoo</title> ><body> > ><p> >Le manuel Gentoo est divisé en chapitres. Pour traiter un chapitre, vous >devez utiliser à la fois le fichier <path>handbook.xml</path> et le fichier ><path>hb-</path> (tel que <path>hb-install-about.xml</path>). Vous devez >également fournir à <c>xsltproc</c> des paramètres identiques à ceux qui sont >utilisés pour la navigation en ligne du Manuel, soit <c>part</c> et ><c>chap</c>. Par exemple, pour valider ><path>hb-install-about.xml</path> : ></p> > ><pre caption="Valider hb-install-about.xml"> ># <i>xmllint --valid --noout handbook.xml</i> ># <i>xmllint --valid --noout hb-install-about.xml</i> ># <i>xsltproc --stringparam part 1 --stringparam chap 1 test/guide.xsl handbook.xml > test/hb-install-about.html</i> ></pre> > ></body> ></section> ></chapter> > ><chapter> ><title>Utiliser une configuration axkit</title> ><section> ><body> > ><p> >Certains documentalistes préfèrent utiliser une configuration axkit similaire à >celle utilisée sur <uri>http://www.gentoo.org</uri>. Voici quelques pointeurs >pour vous aider à obtenir une configuration similaire. ></p> > ><warn> >Il semble que axkit soit très sensible aux versions des paquets qu'il utilise, >particulièrement libxml2. La configuration décrite ci-dessous est fonctionnelle. >Toute autre combinaison de paquets pourrait ne pas l'être. ></warn> > ><p> >D'abord, installez les paquets requis : ></p> > ><pre caption="Utiliser emerge pour installer des versions spécifiques des >paquets requis"> ><comment>(Vérifiez si les paquets sont disponibles dans Portage)</comment> ># <i>emerge -vp =libxml2-2.5.8 =libxslt-1.0.33 =AxKit-1.6.1 =XML-XPath-1.13 \ > =XML-LibXML-1.54-r1 =XML-LibXSLT-1.53 =XML-Parser-2.31-r1 =apache-1.3.29-r1</i> > >These are the packages that I would merge, in order: > >Calculating dependencies ...done! >[ebuild R ] dev-libs/libxml2-2.5.8 -ipv6 +python +readline 0 kB >[ebuild R ] dev-libs/libxslt-1.0.33 +python 0 kB >[ebuild R ] dev-perl/AxKit-1.6.1 +gnome 0 kB >[ebuild R ] dev-perl/XML-XPath-1.13 0 kB >[ebuild R ] dev-perl/XML-LibXML-1.54-r1 0 kB >[ebuild R ] dev-perl/XML-LibXSLT-1.53 0 kB >[ebuild R ] dev-perl/XML-Parser-2.31-r1 0 kB >[ebuild R ] net-www/apache-1.3.29-r1 +pam 0 kB > ><comment>(Installez les paquets)</comment> ># <i>emerge -v =libxml2-2.5.8 =libxslt-1.0.33 =AxKit-1.6.1 =XML-XPath-1.13 \ > =XML-LibXML-1.54-r1 =XML-LibXSLT-1.53 =XML-Parser-2.31-r1 =apache-1.3.29-r1</i> ></pre> > ><p> >Ensuite, éditez les fichiers de configuration suivants : ></p> > ><pre caption="/etc/apache/conf/commonapache.conf"> ><comment>(Dans)</comment> ><IfModule mod_dir.c> > <comment>(Ajoutez index.xml à la liste)</comment> > DirectoryIndex index.xml index.html index.php index.php3 index.shtml index.cgi index.pl index.htm Default.htm default.htm ></IfModule> > ><comment>(Ajoutez les lignes suivantes)</comment> ><IfDefine PERL> > LoadModule perl_module extramodules/libperl.so ># AddModule mod_perl.c > PerlModule AxKit > SetHandler perl-script > PerlHandler Apache::AxKit::StyleChooser::PathInfo AxKit > AddHandler axkit .xml .xsp > AxAddPlugin Apache::AxKit::StyleChooser::QueryString > AxAddXSPTaglib AxKit::XSP::Util > AxAddXSPTaglib AxKit::XSP::IfParam > AxAddXSPTaglib AxKit::XSP::Param > AxAddStyleMap application/x-xsp Apache::AxKit::Language::XSP > AxAddStyleMap text/xsl Apache::AxKit::Language::LibXSLT > <AxStyleName "#default"> > AxAddProcessor text/xsl /xsl/guide.xsl > </AxStyleName> > <AxStyleName printable> > AxAddProcessor text/xsl /xsl/guide-print.xsl > </AxStyleName> ></IfDefine> > ><comment>(Dans)</comment> ><IfModule mod_alias.c> > Alias /icons/ /var/www/localhost/icons/ ><comment>(Commentez la ligne suivante)</comment> > #Alias /doc /usr/share/doc ></pre> > ><pre caption="/etc/conf.d/apache"> ><comment>(Ajoutez -D PERL à la liste des options)</comment> >APACHE_OPTS="-D PERL" ></pre> > ><p> >Puis, copiez les fichiers de la documentation dans ><path>/var/www/localhost/htdocs/</path>, incluant les DTD et les feuilles de >style. Vous aurez besoin des répertoires <path>css/</path>, <path>doc/</path>, ><path>dtd/</path>, <path>images/</path> et <path>xsl/</path>. Les développeurs >Gentoo peuvent copier à partir de leur copie locale du CVS, ou lier >symboliquement cette copie locale. ></p> > ><p> >Il ne reste plus qu'à démarrer votre serveur apache avec : ></p> > ><pre caption="Démarrer apache"> ># <i>/etc/init.d/apache start</i> ># <comment>(Ajoutez-le à un niveau d'exécution si vous souhaitez le démarrer automatiquement lors de l'amorçage.)</comment> ># <i>rc-update add apache default</i> ></pre> > ><p> >Pointez votre navigateur vers <uri>http://your_server/doc/en/</uri>, ou >simplement <uri>http://localhost/doc/en/</uri> si vous avez installé axkit sur >votre station de travail. Vous pouvez consulter le journal des accès dans ><path>/var/log/apache/access_log</path>, et le journal des erreurs dans ><path>/var/log/apache/error_log</path>. ></p> > ><note> >Les utilisateurs de Mozilla devront peut-être régler <c>keyword.enabled</c> à ><c>false</c> dans leur page <uri>about:config</uri> lorsqu'ils utilisent >« localhost ». ></note> > ></body> ></section> > ></chapter> > ></guide>
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Raw
Actions:
View
Attachments on
bug 46371
: 28455