cvs: peardoc /fr/core ppm.xml /fr/core/pear/pear intro.xml /fr/guide/developers contributing.xml packagedef.xml
| From: | Yannick Torres | Date: | Sat, 17 Dec 2005 17:48:20 +0000 |
| Subject: | cvs: peardoc /fr/core ppm.xml /fr/core/pear/pear intro.xml /fr/guide/developers contributing.xml packagedef.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-7327@lists.php.net to get a copy of this message | ||
yannick Sat Dec 17 17:48:20 2005 EDT
Modified files:
/peardoc/fr/core/pear/pear intro.xml
/peardoc/fr/core ppm.xml
/peardoc/fr/guide/developers contributing.xml packagedef.xml
Log:
sync with EN & some WS
http://cvs.php.net/viewcvs.cgi/peardoc/fr/core/pear/pear/intro.xml?r1=1.8&r2=1.9&diff_format=u Index: peardoc/fr/core/pear/pear/intro.xml diff -u peardoc/fr/core/pear/pear/intro.xml:1.8 peardoc/fr/core/pear/pear/intro.xml:1.9 --- peardoc/fr/core/pear/pear/intro.xml:1.8 Sun Nov 7 11:50:07 2004 +++ peardoc/fr/core/pear/pear/intro.xml Sat Dec 17 17:48:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.7 Maintainer: thierry_bo Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.8 Maintainer: thierry_bo Status: ready --> + <refentry id="core.pear.pear.intro"> <refnamediv> <refname>Introduction</refname> @@ -404,4 +405,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/core/ppm.xml?r1=1.10&r2=1.11&diff_format=u Index: peardoc/fr/core/ppm.xml diff -u peardoc/fr/core/ppm.xml:1.10 peardoc/fr/core/ppm.xml:1.11 --- peardoc/fr/core/ppm.xml:1.10 Fri Nov 4 20:15:28 2005 +++ peardoc/fr/core/ppm.xml Sat Dec 17 17:48:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.12 Maintainer: moosh Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.13 Maintainer: moosh Status: ready --> + <chapter id="core.ppm"> <title>Les classes d'installation de PEAR</title> @@ -24,10 +25,10 @@ &core.ppm.pear-dependency2; &core.ppm.pear-dependencydb; &core.ppm.pear-frontend; - &core.ppm.pear-installer; + &core.ppm.pear-installer; &core.ppm.pear-packagefile; &core.ppm.pear-packager; - &core.ppm.pear-registry; + &core.ppm.pear-registry; &core.ppm.pear-remote; &core.ppm.pear-rest; &core.ppm.pear-runtest; http://cvs.php.net/viewcvs.cgi/peardoc/fr/guide/developers/contributing.xml?r1=1.5&r2=1.6&diff_format=u Index: peardoc/fr/guide/developers/contributing.xml diff -u peardoc/fr/guide/developers/contributing.xml:1.5 peardoc/fr/guide/developers/contributing.xml:1.6 --- peardoc/fr/guide/developers/contributing.xml:1.5 Sat Jul 9 23:07:52 2005 +++ peardoc/fr/guide/developers/contributing.xml Sat Dec 17 17:48:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.20 Maintainer: roms Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.22 Maintainer: roms Status: ready --> + <chapter id="developers.contributing"> <title>Intégrer votre code</title> <titleabbrev>Intégrer votre code</titleabbrev> @@ -42,13 +43,12 @@ <link linkend="standards">standards de développement</link>. De nombreuses discussions ont abordé l'intérêt de ce standard avant - et après sa mise en place. - + et après sa mise en place. Il en est ressorti que ce standard était indispensable donc obligatoire. </para> </listitem> - + <listitem> <simpara> Code Extensible et mises à jour. @@ -77,7 +77,7 @@ </para> </listitem> - + <listitem> <simpara> Formats de la documentation (texte brut, docbook) @@ -98,7 +98,7 @@ </simpara> </listitem> </itemizedlist> - + Si vous écrivez votre documentation en Docbook XML et que le formatage est valide, celle-ci peut être @@ -106,7 +106,7 @@ <ulink url="&url.pear.manual;">documentation officielle de PEAR</ulink> que vous êtes actuellement en train de lire. </para> - + <note> <para> Depuis aout 2003, <ulink url="&url.phpdocumentor;">phpDocumentor</ulink> @@ -138,31 +138,31 @@ <listitem> <simpara> - Test de régression .phpt ou format + Test de régression .phpt ou format <link linkend="package.php.phpunit">PHPUnit</link> </simpara> <para> Tous les développeurs ont déjà été confrontés à la frustration des bugs. - + Ils font parties de la vie d'un programmeur. - Heureusement il existe quelques systèmes - qui permettent de les trouver et de les supprimer. - - Les tests de régression doivent être inclus - dans chaque version stable d'un package - afin que les utilisateurs puissent les exécuter en cas de bug. - - Des exemples de tests de régression .phpt peuvent + Heureusement il existe quelques systèmes + qui permettent de les trouver et de les supprimer. + + Les tests de régression doivent être inclus + dans chaque version stable d'un package + afin que les utilisateurs puissent les exécuter en cas de bug. + + Des exemples de tests de régression .phpt peuvent être trouvés dans le package - <link linkend="package.database.db">DB</link>. - + <link linkend="package.database.db">DB</link>. + Pour trouver des exemples de tests PHPUnit, vous pouvez regarder dans le package <link linkend="package.authentication.auth">Auth</link>. </para> </listitem> - + <listitem> <simpara> Le contributeur (<quote>vous</quote>) doit avoir la volonté @@ -173,10 +173,10 @@ Si vous ne souhaitez pas offrir de support autour de votre package sur une longue période, votre package n'aura pas d'intérêt pour PEAR. - + PEAR est le fournisseur standard de packages pour PHP, et cela implique de lourdes responsabilités. - + Offrir du support ne signifie pas de juste répondre aux question dans les <ulink url="&url.pear.support;">mailing lists</ulink>: @@ -239,15 +239,16 @@ </para> <para> - Au delà de cette syntaxe générale, les package peuvent également prendre plusieurs + Au delà de cette syntaxe générale, les package peuvent également + prendre plusieurs noms de catégories. Par exemple, <literal>HTML_Template_PHPLIB</literal>: Les catégories multiples indiquent que le package <literal>PHPLIB</literal> fait partie de la catégorie <literal>Template</literal>, qui elle même fait partie de la catégorie <literal>HTML</literal>. Ce nommage est nécessaire car il peut exister des systèmes de templates dans PERA s'appliquant à d'autres technologies que le HTML. - - </para> + + </para> <para> Si vous rencontrez des difficultés pour nommer votre package, @@ -324,7 +325,10 @@ pour PEAR. Avec ce compte, vous avez accès à l'infrastructure permettant de proposer, uploader et mettre à jour de nouveaux packages via le site - <ulink url="&url.pear;">pear.php.net</ulink>.</para> + <ulink url="&url.pear;">pear.php.net</ulink>.Le PEAR Group + gère les comptes PEAR et les degrés de karma pearweb (i.e. : + karma pour utiliser le site web pourmaintenant les paquets). + </para> </listitem> <listitem> @@ -336,7 +340,13 @@ demander un compte CVS afin d'avoir accès au module <abbrev>CVS</abbrev> de PEAR sur <ulink url="&url.php.cvs;"> cvs.php.net</ulink>. Cela facilite la contribution d'autres - développeurs à votre code. + développeurs à votre code. Le PHP Group + (group@php.net) gère le serveur CVS PHP, qui est utilisé pour maintenir + les paqets PEAR. Si vous avez déjà un compte CVS PHP, vous devez demander + au PEAR Group le karma nécessaire pour un ou plusieurs paquets donnés. + Pour cela, envoyez un email à <ulink url="mailto:&email.pear.group;"> + &email.pear.group;</ulink> en spécifiant pour quels paquets vous + avez besoin d'avoir accès. </para> <para> http://cvs.php.net/viewcvs.cgi/peardoc/fr/guide/developers/packagedef.xml?r1=1.12&r2=1.13&diff_format=u Index: peardoc/fr/guide/developers/packagedef.xml diff -u peardoc/fr/guide/developers/packagedef.xml:1.12 peardoc/fr/guide/developers/packagedef.xml:1.13 --- peardoc/fr/guide/developers/packagedef.xml:1.12 Sun Jul 10 07:36:11 2005 +++ peardoc/fr/guide/developers/packagedef.xml Sat Dec 17 17:48:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.29 Maintainer: roms Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.33 Maintainer: roms Status: ready --> + <chapter id="developers.packagedef"> <title>Le fichier de définition de package <filename>package.xml</filename></title> <titleabbrev><filename>package.xml</filename></titleabbrev> @@ -138,6 +139,12 @@ </listitem> <listitem> <simpara> + <literal><license></literal>: La <link linkend="faq.licenses">license</link> + sous laquelle le code est disponible. + </simpara> + </listitem> + <listitem> + <simpara> <literal><notes></literal>: Notes </simpara> </listitem> @@ -147,15 +154,15 @@ <itemizedlist> <listitem> <simpara> - <literal><file role="xxx"></literal>: + <literal><literal><file name="xxx" role="xxx" /></literal></literal>: Nom du fichier </simpara> </listitem> <listitem> <simpara> - <literal><dir name="xxx" [role="xxx"]></literal>: + <literal><dir name="xxx" [role="xxx"]></literal>: Nom d'un sous répertoire. - Ce sous répertoire peut contenir des éléments + Ce sous répertoire peut contenir des éléments <literal><file role="xxx"></literal>. </simpara> </listitem> @@ -182,7 +189,7 @@ </listitem> <listitem> <para> - <literal><changelog></literal>: + <literal><changelog></literal>: Informations de changelog sur le package. <itemizedlist> <listitem> @@ -191,7 +198,7 @@ <itemizedlist> <listitem> <simpara> - <literal><version></literal>: + <literal><version></literal>: Numéro de version courante. </simpara> </listitem> @@ -228,29 +235,45 @@ </sect2> <sect2 id="developers.packagedef.characters"> - <title>Caractères autorisés</title> + <title>Caractères autorisés</title> <para> - Les lettres autorisés dans les éléments sont A-Z et a-z. - Les autres caractères, comme <literal>é</literal> - doivent être remplacés par leurs entités + Les lettres autorisés dans les éléments sont A-Z et a-z. + Les autres caractères, comme <literal>é</literal> + doivent être remplacés par leurs entités (dans ce cas : <literal>&eacute;</literal>). </para> <para> - Si vous créez votre fichier package.xml en utilisant le - PEAR_PackageFileManager, mettez à jour votre installation de PEAR - à la version 1.4.0a2 ou supérieure et vous n'aurez plus à vous souciez de + Si vous créez votre fichier package.xml en utilisant le + PEAR_PackageFileManager, mettez à jour votre installation de PEAR + à la version 1.4.0a2 ou supérieure et vous n'aurez plus à vous souciez de cela car le gestionnaire de fichier s'occupe de cela automatiquement. </para> <para> - Si vous écrivez vos fichiers package.xml manuellement, - vous devrez entrer les entités vous-même. - Une liste des entités les plus communes peut être trouvée sur : + Si vous écrivez vos fichiers package.xml manuellement, + vous devrez entrer les entités vous-même. + Une liste des entités les plus communes peut être trouvée sur : <ulink url="&url.xml.entities.common;"> &url.xml.entities.common;</ulink>. - Si le caractère dont vous avez besoin n'est pas dans cette liste, + Si le caractère dont vous avez besoin n'est pas dans cette liste, allez sur <ulink url="&url.xml.entities.all;"> &url.xml.entities.all;</ulink> - et cherchez sur les autres listes d'entités. + et cherchez sur les autres listes d'entités. + </para> + </sect2> + + <sect2 id="developers.packagedef.validating"> + <title>Validation</title> + <para> + Pour valider vos fichiers <filename>package.xml</filename>, vous pouvez utiliser + l'utilitaire <command>xmllint</command> fourni avec + <ulink url="&url.libxml;">libxml2</ulink>. + </para> + <para> + <command> + <userinput> + xmllint --dtdvalid http://pear.php.net/dtd/package-1.0 --noout package.xml + </userinput> + </command> </para> </sect2> @@ -301,9 +324,9 @@ <para> Ce fichier <filename>package.xml</filename> peut vous servir de modèle. - + Il contient tous les éléments nécessaires. - + Il vous suffit de changer les textes pour vous en servir avec votre package. </para> @@ -522,7 +545,7 @@ <entry>prog</entry> <entry>Programme</entry> <entry>dépendant d'un certain programme accessible via le - path du système. Ceci n'est pas supporté par l'installeur PEAR.</entry> + path du système. Ceci n'est pas supporté par l'installeur PEAR.</entry> <entry><quote>latex</quote></entry> </row> @@ -536,14 +559,14 @@ <row> <entry>sapi</entry> <entry>API du serveur</entry> - <entry>dépendant de l'API du serveur. Ceci n'est pas supporté par l'installeur PEAR.</entry> + <entry>dépendant de l'API du serveur. Ceci n'est pas supporté par l'installeur PEAR.</entry> <entry><quote>Apache</quote></entry> </row> <row> <entry>zend</entry> <entry>Zend</entry> - <entry>dépendant d'une version de l'API Zend. Ceci n'est pas supporté + <entry>dépendant d'une version de l'API Zend. Ceci n'est pas supporté par l'installeur PEAR.</entry> <entry><quote>2</quote></entry> </row> @@ -583,7 +606,7 @@ <entry>dispose</entry> <entry> les capacités existantes doivent en disposer - - l'attribut version est ignoré + - l'attribut version est ignoré </entry> <entry>pkg, ext, php, prog, os, sapi, zend</entry> </row> @@ -644,10 +667,10 @@ <row> <entry>not</entry> - <entry>conflit de dépendance</entry> + <entry>conflit de dépendance</entry> <entry> - Les conflits de dépendance avec le paquet, les deux ne peuvent cp-exister. - Version est ignoré. + Les conflits de dépendance avec le paquet, les deux ne peuvent cp-exister. + Version est ignoré. </entry> <entry>ext, php</entry> </row> @@ -657,7 +680,7 @@ </table> <para> <literal>Has</literal> sera utilisé comme valeur par défaut. - Notez que cela nécessite PEAR 1.4.0 et supérieure. + Notez que cela nécessite PEAR 1.4.0 et supérieure. </para> </sect3> <sect3> @@ -678,13 +701,13 @@ dépendance n'est pas indispensable mais que la présence du package donne accès à des fonctionnalités avancées. - + Les seules valeurs acceptées sont - "yes" et "no". - + "yes" et "no". + Si l'attribut optional n'est pas présent, la dépendance est indispensable. - + Lorsque <literal>optional="yes"</literal> est utilisé, les messages suivants apparaîtront à l'installation: </para> @@ -721,4 +744,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file
http://cvs.php.net/viewcvs.cgi/peardoc/fr/core/pear/pear/intro.xml?r1=1.8&r2=1.9&diff_format=u Index: peardoc/fr/core/pear/pear/intro.xml diff -u peardoc/fr/core/pear/pear/intro.xml:1.8 peardoc/fr/core/pear/pear/intro.xml:1.9 --- peardoc/fr/core/pear/pear/intro.xml:1.8 Sun Nov 7 11:50:07 2004 +++ peardoc/fr/core/pear/pear/intro.xml Sat Dec 17 17:48:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.7 Maintainer: thierry_bo Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.8 Maintainer: thierry_bo Status: ready --> + <refentry id="core.pear.pear.intro"> <refnamediv> <refname>Introduction</refname> @@ -404,4 +405,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewcvs.cgi/peardoc/fr/core/ppm.xml?r1=1.10&r2=1.11&diff_format=u Index: peardoc/fr/core/ppm.xml diff -u peardoc/fr/core/ppm.xml:1.10 peardoc/fr/core/ppm.xml:1.11 --- peardoc/fr/core/ppm.xml:1.10 Fri Nov 4 20:15:28 2005 +++ peardoc/fr/core/ppm.xml Sat Dec 17 17:48:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.12 Maintainer: moosh Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.13 Maintainer: moosh Status: ready --> + <chapter id="core.ppm"> <title>Les classes d'installation de PEAR</title> @@ -24,10 +25,10 @@ &core.ppm.pear-dependency2; &core.ppm.pear-dependencydb; &core.ppm.pear-frontend; - &core.ppm.pear-installer; + &core.ppm.pear-installer; &core.ppm.pear-packagefile; &core.ppm.pear-packager; - &core.ppm.pear-registry; + &core.ppm.pear-registry; &core.ppm.pear-remote; &core.ppm.pear-rest; &core.ppm.pear-runtest; http://cvs.php.net/viewcvs.cgi/peardoc/fr/guide/developers/contributing.xml?r1=1.5&r2=1.6&diff_format=u Index: peardoc/fr/guide/developers/contributing.xml diff -u peardoc/fr/guide/developers/contributing.xml:1.5 peardoc/fr/guide/developers/contributing.xml:1.6 --- peardoc/fr/guide/developers/contributing.xml:1.5 Sat Jul 9 23:07:52 2005 +++ peardoc/fr/guide/developers/contributing.xml Sat Dec 17 17:48:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.20 Maintainer: roms Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.22 Maintainer: roms Status: ready --> + <chapter id="developers.contributing"> <title>Intégrer votre code</title> <titleabbrev>Intégrer votre code</titleabbrev> @@ -42,13 +43,12 @@ <link linkend="standards">standards de développement</link>. De nombreuses discussions ont abordé l'intérêt de ce standard avant - et après sa mise en place. - + et après sa mise en place. Il en est ressorti que ce standard était indispensable donc obligatoire. </para> </listitem> - + <listitem> <simpara> Code Extensible et mises à jour. @@ -77,7 +77,7 @@ </para> </listitem> - + <listitem> <simpara> Formats de la documentation (texte brut, docbook) @@ -98,7 +98,7 @@ </simpara> </listitem> </itemizedlist> - + Si vous écrivez votre documentation en Docbook XML et que le formatage est valide, celle-ci peut être @@ -106,7 +106,7 @@ <ulink url="&url.pear.manual;">documentation officielle de PEAR</ulink> que vous êtes actuellement en train de lire. </para> - + <note> <para> Depuis aout 2003, <ulink url="&url.phpdocumentor;">phpDocumentor</ulink> @@ -138,31 +138,31 @@ <listitem> <simpara> - Test de régression .phpt ou format + Test de régression .phpt ou format <link linkend="package.php.phpunit">PHPUnit</link> </simpara> <para> Tous les développeurs ont déjà été confrontés à la frustration des bugs. - + Ils font parties de la vie d'un programmeur. - Heureusement il existe quelques systèmes - qui permettent de les trouver et de les supprimer. - - Les tests de régression doivent être inclus - dans chaque version stable d'un package - afin que les utilisateurs puissent les exécuter en cas de bug. - - Des exemples de tests de régression .phpt peuvent + Heureusement il existe quelques systèmes + qui permettent de les trouver et de les supprimer. + + Les tests de régression doivent être inclus + dans chaque version stable d'un package + afin que les utilisateurs puissent les exécuter en cas de bug. + + Des exemples de tests de régression .phpt peuvent être trouvés dans le package - <link linkend="package.database.db">DB</link>. - + <link linkend="package.database.db">DB</link>. + Pour trouver des exemples de tests PHPUnit, vous pouvez regarder dans le package <link linkend="package.authentication.auth">Auth</link>. </para> </listitem> - + <listitem> <simpara> Le contributeur (<quote>vous</quote>) doit avoir la volonté @@ -173,10 +173,10 @@ Si vous ne souhaitez pas offrir de support autour de votre package sur une longue période, votre package n'aura pas d'intérêt pour PEAR. - + PEAR est le fournisseur standard de packages pour PHP, et cela implique de lourdes responsabilités. - + Offrir du support ne signifie pas de juste répondre aux question dans les <ulink url="&url.pear.support;">mailing lists</ulink>: @@ -239,15 +239,16 @@ </para> <para> - Au delà de cette syntaxe générale, les package peuvent également prendre plusieurs + Au delà de cette syntaxe générale, les package peuvent également + prendre plusieurs noms de catégories. Par exemple, <literal>HTML_Template_PHPLIB</literal>: Les catégories multiples indiquent que le package <literal>PHPLIB</literal> fait partie de la catégorie <literal>Template</literal>, qui elle même fait partie de la catégorie <literal>HTML</literal>. Ce nommage est nécessaire car il peut exister des systèmes de templates dans PERA s'appliquant à d'autres technologies que le HTML. - - </para> + + </para> <para> Si vous rencontrez des difficultés pour nommer votre package, @@ -324,7 +325,10 @@ pour PEAR. Avec ce compte, vous avez accès à l'infrastructure permettant de proposer, uploader et mettre à jour de nouveaux packages via le site - <ulink url="&url.pear;">pear.php.net</ulink>.</para> + <ulink url="&url.pear;">pear.php.net</ulink>.Le PEAR Group + gère les comptes PEAR et les degrés de karma pearweb (i.e. : + karma pour utiliser le site web pourmaintenant les paquets). + </para> </listitem> <listitem> @@ -336,7 +340,13 @@ demander un compte CVS afin d'avoir accès au module <abbrev>CVS</abbrev> de PEAR sur <ulink url="&url.php.cvs;"> cvs.php.net</ulink>. Cela facilite la contribution d'autres - développeurs à votre code. + développeurs à votre code. Le PHP Group + (group@php.net) gère le serveur CVS PHP, qui est utilisé pour maintenir + les paqets PEAR. Si vous avez déjà un compte CVS PHP, vous devez demander + au PEAR Group le karma nécessaire pour un ou plusieurs paquets donnés. + Pour cela, envoyez un email à <ulink url="mailto:&email.pear.group;"> + &email.pear.group;</ulink> en spécifiant pour quels paquets vous + avez besoin d'avoir accès. </para> <para> http://cvs.php.net/viewcvs.cgi/peardoc/fr/guide/developers/packagedef.xml?r1=1.12&r2=1.13&diff_format=u Index: peardoc/fr/guide/developers/packagedef.xml diff -u peardoc/fr/guide/developers/packagedef.xml:1.12 peardoc/fr/guide/developers/packagedef.xml:1.13 --- peardoc/fr/guide/developers/packagedef.xml:1.12 Sun Jul 10 07:36:11 2005 +++ peardoc/fr/guide/developers/packagedef.xml Sat Dec 17 17:48:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.29 Maintainer: roms Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.33 Maintainer: roms Status: ready --> + <chapter id="developers.packagedef"> <title>Le fichier de définition de package <filename>package.xml</filename></title> <titleabbrev><filename>package.xml</filename></titleabbrev> @@ -138,6 +139,12 @@ </listitem> <listitem> <simpara> + <literal><license></literal>: La <link linkend="faq.licenses">license</link> + sous laquelle le code est disponible. + </simpara> + </listitem> + <listitem> + <simpara> <literal><notes></literal>: Notes </simpara> </listitem> @@ -147,15 +154,15 @@ <itemizedlist> <listitem> <simpara> - <literal><file role="xxx"></literal>: + <literal><literal><file name="xxx" role="xxx" /></literal></literal>: Nom du fichier </simpara> </listitem> <listitem> <simpara> - <literal><dir name="xxx" [role="xxx"]></literal>: + <literal><dir name="xxx" [role="xxx"]></literal>: Nom d'un sous répertoire. - Ce sous répertoire peut contenir des éléments + Ce sous répertoire peut contenir des éléments <literal><file role="xxx"></literal>. </simpara> </listitem> @@ -182,7 +189,7 @@ </listitem> <listitem> <para> - <literal><changelog></literal>: + <literal><changelog></literal>: Informations de changelog sur le package. <itemizedlist> <listitem> @@ -191,7 +198,7 @@ <itemizedlist> <listitem> <simpara> - <literal><version></literal>: + <literal><version></literal>: Numéro de version courante. </simpara> </listitem> @@ -228,29 +235,45 @@ </sect2> <sect2 id="developers.packagedef.characters"> - <title>Caractères autorisés</title> + <title>Caractères autorisés</title> <para> - Les lettres autorisés dans les éléments sont A-Z et a-z. - Les autres caractères, comme <literal>é</literal> - doivent être remplacés par leurs entités + Les lettres autorisés dans les éléments sont A-Z et a-z. + Les autres caractères, comme <literal>é</literal> + doivent être remplacés par leurs entités (dans ce cas : <literal>&eacute;</literal>). </para> <para> - Si vous créez votre fichier package.xml en utilisant le - PEAR_PackageFileManager, mettez à jour votre installation de PEAR - à la version 1.4.0a2 ou supérieure et vous n'aurez plus à vous souciez de + Si vous créez votre fichier package.xml en utilisant le + PEAR_PackageFileManager, mettez à jour votre installation de PEAR + à la version 1.4.0a2 ou supérieure et vous n'aurez plus à vous souciez de cela car le gestionnaire de fichier s'occupe de cela automatiquement. </para> <para> - Si vous écrivez vos fichiers package.xml manuellement, - vous devrez entrer les entités vous-même. - Une liste des entités les plus communes peut être trouvée sur : + Si vous écrivez vos fichiers package.xml manuellement, + vous devrez entrer les entités vous-même. + Une liste des entités les plus communes peut être trouvée sur : <ulink url="&url.xml.entities.common;"> &url.xml.entities.common;</ulink>. - Si le caractère dont vous avez besoin n'est pas dans cette liste, + Si le caractère dont vous avez besoin n'est pas dans cette liste, allez sur <ulink url="&url.xml.entities.all;"> &url.xml.entities.all;</ulink> - et cherchez sur les autres listes d'entités. + et cherchez sur les autres listes d'entités. + </para> + </sect2> + + <sect2 id="developers.packagedef.validating"> + <title>Validation</title> + <para> + Pour valider vos fichiers <filename>package.xml</filename>, vous pouvez utiliser + l'utilitaire <command>xmllint</command> fourni avec + <ulink url="&url.libxml;">libxml2</ulink>. + </para> + <para> + <command> + <userinput> + xmllint --dtdvalid http://pear.php.net/dtd/package-1.0 --noout package.xml + </userinput> + </command> </para> </sect2> @@ -301,9 +324,9 @@ <para> Ce fichier <filename>package.xml</filename> peut vous servir de modèle. - + Il contient tous les éléments nécessaires. - + Il vous suffit de changer les textes pour vous en servir avec votre package. </para> @@ -522,7 +545,7 @@ <entry>prog</entry> <entry>Programme</entry> <entry>dépendant d'un certain programme accessible via le - path du système. Ceci n'est pas supporté par l'installeur PEAR.</entry> + path du système. Ceci n'est pas supporté par l'installeur PEAR.</entry> <entry><quote>latex</quote></entry> </row> @@ -536,14 +559,14 @@ <row> <entry>sapi</entry> <entry>API du serveur</entry> - <entry>dépendant de l'API du serveur. Ceci n'est pas supporté par l'installeur PEAR.</entry> + <entry>dépendant de l'API du serveur. Ceci n'est pas supporté par l'installeur PEAR.</entry> <entry><quote>Apache</quote></entry> </row> <row> <entry>zend</entry> <entry>Zend</entry> - <entry>dépendant d'une version de l'API Zend. Ceci n'est pas supporté + <entry>dépendant d'une version de l'API Zend. Ceci n'est pas supporté par l'installeur PEAR.</entry> <entry><quote>2</quote></entry> </row> @@ -583,7 +606,7 @@ <entry>dispose</entry> <entry> les capacités existantes doivent en disposer - - l'attribut version est ignoré + - l'attribut version est ignoré </entry> <entry>pkg, ext, php, prog, os, sapi, zend</entry> </row> @@ -644,10 +667,10 @@ <row> <entry>not</entry> - <entry>conflit de dépendance</entry> + <entry>conflit de dépendance</entry> <entry> - Les conflits de dépendance avec le paquet, les deux ne peuvent cp-exister. - Version est ignoré. + Les conflits de dépendance avec le paquet, les deux ne peuvent cp-exister. + Version est ignoré. </entry> <entry>ext, php</entry> </row> @@ -657,7 +680,7 @@ </table> <para> <literal>Has</literal> sera utilisé comme valeur par défaut. - Notez que cela nécessite PEAR 1.4.0 et supérieure. + Notez que cela nécessite PEAR 1.4.0 et supérieure. </para> </sect3> <sect3> @@ -678,13 +701,13 @@ dépendance n'est pas indispensable mais que la présence du package donne accès à des fonctionnalités avancées. - + Les seules valeurs acceptées sont - "yes" et "no". - + "yes" et "no". + Si l'attribut optional n'est pas présent, la dépendance est indispensable. - + Lorsque <literal>optional="yes"</literal> est utilisé, les messages suivants apparaîtront à l'installation: </para> @@ -721,4 +744,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file