cvs: peardoc /fr/core ppm.xml /fr/core/pear/pear intro.xml /fr/guide/developers contributing.xml packagedef.xml

From: 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&eacute;grer votre code</title> <titleabbrev>Int&eacute;grer votre code</titleabbrev> @@ -42,13 +43,12 @@ <link linkend="standards">standards de d&eacute;veloppement</link>. De nombreuses discussions ont abord&eacute; l'int&eacute;r&ecirc;t de ce standard avant - et apr&egrave;s sa mise en place. - + et apr&egrave;s sa mise en place. Il en est ressorti que ce standard &eacute;tait indispensable donc obligatoire. </para> </listitem> - + <listitem> <simpara> Code Extensible et mises &agrave; 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 &eacute;crivez votre documentation en Docbook XML et que le formatage est valide, celle-ci peut &ecirc;tre @@ -106,7 +106,7 @@ <ulink url="&url.pear.manual;">documentation officielle de PEAR</ulink> que vous &ecirc;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&eacute;gression .phpt ou format + Test de r&eacute;gression .phpt ou format <link linkend="package.php.phpunit">PHPUnit</link> </simpara> <para> Tous les d&eacute;veloppeurs ont d&eacute;j&agrave; &eacute;t&eacute; confront&eacute;s &agrave; la frustration des bugs. - + Ils font parties de la vie d'un programmeur. - Heureusement il existe quelques syst&egrave;mes - qui permettent de les trouver et de les supprimer. - - Les tests de r&eacute;gression doivent &ecirc;tre inclus - dans chaque version stable d'un package - afin que les utilisateurs puissent les ex&eacute;cuter en cas de bug. - - Des exemples de tests de r&eacute;gression .phpt peuvent + Heureusement il existe quelques syst&egrave;mes + qui permettent de les trouver et de les supprimer. + + Les tests de r&eacute;gression doivent &ecirc;tre inclus + dans chaque version stable d'un package + afin que les utilisateurs puissent les ex&eacute;cuter en cas de bug. + + Des exemples de tests de r&eacute;gression .phpt peuvent &ecirc;tre trouv&eacute;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&eacute; @@ -173,10 +173,10 @@ Si vous ne souhaitez pas offrir de support autour de votre package sur une longue p&eacute;riode, votre package n'aura pas d'int&eacute;r&ecirc;t pour PEAR. - + PEAR est le fournisseur standard de packages pour PHP, et cela implique de lourdes responsabilit&eacute;s. - + Offrir du support ne signifie pas de juste r&eacute;pondre aux question dans les <ulink url="&url.pear.support;">mailing lists</ulink>: @@ -239,15 +239,16 @@ </para> <para> - Au del&agrave; de cette syntaxe g&eacute;n&eacute;rale, les package peuvent &eacute;galement prendre plusieurs + Au del&agrave; de cette syntaxe g&eacute;n&eacute;rale, les package peuvent &eacute;galement + prendre plusieurs noms de cat&eacute;gories. Par exemple, <literal>HTML_Template_PHPLIB</literal>: Les cat&eacute;gories multiples indiquent que le package <literal>PHPLIB</literal> fait partie de la cat&eacute;gorie <literal>Template</literal>, qui elle m&ecirc;me fait partie de la cat&eacute;gorie <literal>HTML</literal>. Ce nommage est n&eacute;cessaire car il peut exister des syst&egrave;mes de templates dans PERA s'appliquant &agrave; d'autres technologies que le HTML. - - </para> + + </para> <para> Si vous rencontrez des difficult&eacute;s pour nommer votre package, @@ -324,7 +325,10 @@ pour PEAR. Avec ce compte, vous avez acc&egrave;s &agrave; l'infrastructure permettant de proposer, uploader et mettre &agrave; 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&egrave;re les comptes PEAR et les degr&eacute;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&egrave;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&eacute;veloppeurs &agrave; votre code. + d&eacute;veloppeurs &agrave; votre code. Le PHP Group + (group@php.net) g&egrave;re le serveur CVS PHP, qui est utilis&eacute; pour maintenir + les paqets PEAR. Si vous avez d&eacute;j&agrave; un compte CVS PHP, vous devez demander + au PEAR Group le karma n&eacute;cessaire pour un ou plusieurs paquets donn&eacute;s. + Pour cela, envoyez un email &agrave; <ulink url="mailto:&email.pear.group;"> + &email.pear.group;</ulink> en sp&eacute;cifiant pour quels paquets vous + avez besoin d'avoir acc&egrave;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&eacute;finition de package <filename>package.xml</filename></title> <titleabbrev><filename>package.xml</filename></titleabbrev> @@ -138,6 +139,12 @@ </listitem> <listitem> <simpara> + <literal>&lt;license&gt;</literal>: La <link linkend="faq.licenses">license</link> + sous laquelle le code est disponible. + </simpara> + </listitem> + <listitem> + <simpara> <literal>&lt;notes&gt;</literal>: Notes </simpara> </listitem> @@ -147,15 +154,15 @@ <itemizedlist> <listitem> <simpara> - <literal>&lt;file role="xxx"&gt;</literal>: + <literal><literal>&lt;file name="xxx" role="xxx" /&gt;</literal></literal>: Nom du fichier </simpara> </listitem> <listitem> <simpara> - <literal>&lt;dir name="xxx" [role="xxx"]&gt;</literal>: + <literal>&lt;dir name="xxx" [role="xxx"]&gt;</literal>: Nom d'un sous r&eacute;pertoire. - Ce sous r&eacute;pertoire peut contenir des éléments + Ce sous r&eacute;pertoire peut contenir des &eacute;l&eacute;ments <literal>&lt;file role="xxx"&gt;</literal>. </simpara> </listitem> @@ -182,7 +189,7 @@ </listitem> <listitem> <para> - <literal>&lt;changelog&gt;</literal>: + <literal>&lt;changelog&gt;</literal>: Informations de changelog sur le package. <itemizedlist> <listitem> @@ -191,7 +198,7 @@ <itemizedlist> <listitem> <simpara> - <literal>&lt;version&gt;</literal>: + <literal>&lt;version&gt;</literal>: Num&eacute;ro de version courante. </simpara> </listitem> @@ -228,29 +235,45 @@ </sect2> <sect2 id="developers.packagedef.characters"> - <title>Caractères autorisés</title> + <title>Caract&egrave;res autoris&eacute;s</title> <para> - Les lettres autorisés dans les éléments sont A-Z et a-z. - Les autres caractères, comme <literal>&eacute;</literal> - doivent être remplacés par leurs entités + Les lettres autoris&eacute;s dans les &eacute;l&eacute;ments sont A-Z et a-z. + Les autres caract&egrave;res, comme <literal>&eacute;</literal> + doivent &ecirc;tre remplac&eacute;s par leurs entit&eacute;s (dans ce cas : <literal>&amp;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&eacute;ez votre fichier package.xml en utilisant le + PEAR_PackageFileManager, mettez &agrave; jour votre installation de PEAR + &agrave; la version 1.4.0a2 ou sup&eacute;rieure et vous n'aurez plus &agrave; 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 &eacute;crivez vos fichiers package.xml manuellement, + vous devrez entrer les entit&eacute;s vous-m&ecirc;me. + Une liste des entit&eacute;s les plus communes peut &ecirc;tre trouv&eacute;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&egrave;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&eacute;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&egrave;le. - + Il contient tous les &eacute;l&eacute;ments n&eacute;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&eacute;pendant d'un certain programme accessible via le - path du syst&egrave;me. Ceci n'est pas supporté par l'installeur PEAR.</entry> + path du syst&egrave;me. Ceci n'est pas support&eacute; 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&eacute;pendant de l'API du serveur. Ceci n'est pas supporté par l'installeur PEAR.</entry> + <entry>d&eacute;pendant de l'API du serveur. Ceci n'est pas support&eacute; par l'installeur PEAR.</entry> <entry><quote>Apache</quote></entry> </row> <row> <entry>zend</entry> <entry>Zend</entry> - <entry>d&eacute;pendant d'une version de l'API Zend. Ceci n'est pas supporté + <entry>d&eacute;pendant d'une version de l'API Zend. Ceci n'est pas support&eacute; par l'installeur PEAR.</entry> <entry><quote>2</quote></entry> </row> @@ -583,7 +606,7 @@ <entry>dispose</entry> <entry> les capacit&eacute;s existantes doivent en disposer - - l'attribut version est ignoré + - l'attribut version est ignor&eacute; </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&eacute;pendance</entry> <entry> - Les conflits de dépendance avec le paquet, les deux ne peuvent cp-exister. - Version est ignoré. + Les conflits de d&eacute;pendance avec le paquet, les deux ne peuvent cp-exister. + Version est ignor&eacute;. </entry> <entry>ext, php</entry> </row> @@ -657,7 +680,7 @@ </table> <para> <literal>Has</literal> sera utilis&eacute; comme valeur par d&eacute;faut. - Notez que cela nécessite PEAR 1.4.0 et supérieure. + Notez que cela n&eacute;cessite PEAR 1.4.0 et sup&eacute;rieure. </para> </sect3> <sect3> @@ -678,13 +701,13 @@ d&eacute;pendance n'est pas indispensable mais que la pr&eacute;sence du package donne acc&egrave;s &agrave; des fonctionnalit&eacute;s avanc&eacute;es. - + Les seules valeurs accept&eacute;es sont - &quot;yes&quot; et &quot;no&quot;. - + &quot;yes&quot; et &quot;no&quot;. + Si l'attribut optional n'est pas pr&eacute;sent, la d&eacute;pendance est indispensable. - + Lorsque <literal>optional=&quot;yes&quot;</literal> est utilis&eacute;, les messages suivants appara&icirc;tront &agrave; 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
« previous php.pear.doc (#7327) next »