cvs: peardoc /fr/guide/developers/package2 channel.xml compatible.xml contents.xml
| From: | Yannick Torres | Date: | Sat, 23 Sep 2006 17:26:10 +0000 |
| Subject: | cvs: peardoc /fr/guide/developers/package2 channel.xml compatible.xml contents.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-8507@lists.php.net to get a copy of this message | ||
yannick Sat Sep 23 17:26:10 2006 UTC
Added files:
/peardoc/fr/guide/developers/package2 channel.xml compatible.xml
contents.xml
Log:
initial translation
http://cvs.php.net/viewvc.cgi/peardoc/fr/guide/developers/package2/channel.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/channel.xml +++ peardoc/fr/guide/developers/package2/channel.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <refentry id="guide.developers.package2.channel"> <refnamediv> <refname><channel></refname> <refpurpose>Qu'est-ce qu'un canal ?</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.channel.intro"> <title>Introduction rapide sur les canaux</title> <para> Les canaux sont nouveaux depuis PEAR 1.4.0. Les canaux sont une façon optimisé de différencier plusieurs sources de téléchargement. Une source possible est pear.php.net, une autre, pecl.php.net, et il en existe d'autres sur le web. </para> <para> La balise <channel> doit contenir le nom complet du canal, et non un alias (n'utilisez pas, par exemple, "pear", mais plutôt "pear.php.net"). </para> <para> Une bonne façon de déterminer le nom du canal est de se poser la question suivante : "Où puis-je télécharger ma version ?". Si la réponse est pear.php.net, c'est votre canal pour votre paquet. Si la réponse est pecl.php.net, ce sera alors votre canal. </para> <para> Si vous n'exécutez pas de serveur de canaux et que vous voulez servir votre paquet de la même façon que les autres paquets, le paquet de distribution basé sur l'URI est le meilleur choix, lisez la documentation sur la balise <uri> dont le lien est fourni ci-dessous. </para> <refsect2> <title>Voir aussi :</title> <para> <link linkend="guide.developers.package2.uri"><uri></link> </para> </refsect2> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/peardoc/fr/guide/developers/package2/compatible.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/compatible.xml +++ peardoc/fr/guide/developers/package2/compatible.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <refentry id="guide.developers.package2.compatible"> <refnamediv> <refname><compatible></refname> <refpurpose>Éviter d'imposer une version stricte avec la balise <compatible></refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.compatible.intro"> <title>Travailler ave les versions de dépendance <recommended> et <compatible></title> <para> La balise <compatible> est prévu pour être utilisé avec une dépendance <package> qui contient une balise <recommended> dpuis pear.example.com/Bar version 1.3.0, comme ceci : </para> <para> <programlisting role="xml"> <![CDATA[ <package> <name>Foo</name> <channel>pear.example.com</channel> <min>1.0.0</min> <recommended>1.5.2</recommended> </package> ]]> </programlisting> </para> <para> La dépendance ci-dessus peut être traduite comme ceci : "Utilisez le paquet pear.example.com/Foo, mais uniquement la version 1.0.0 ou plus récente. Si pear.example.com/Foo n'est pas installé, installez la version 1.5.2. Si pear.example.com/Foo est installé et que ce n'est pas la version 1.5.2, ne rien faire tant que --force n'est pas spécifié, ou pear.example.com/Foo est compatible avec moi" </para> <para> Le dernier cas " ou pear.example.com/Foo est compatible avec moi." est contrôlé par la blise <compatible>. Si le fichier package.xml du paquet Foo version 1.5.3 a une balise <compatible> come ceci : </para> <para> <programlisting role="xml"> <![CDATA[ <compatible> <name>Bar</name> <channel>pear.example.com</channel> <min>1.2.0</min> <max>1.3.0</max> <exclude>1.2.9</exclude> </compatible> ]]> </programlisting> </para> <para> Ceci dira à l'installeur que pear.example.com/Foo version 1.5.3 est compatible avec pear.example.com/Bar versions 1.2.0 à 1.3.0 inclus, mais n'est pas compatible avec la version 1.2.9. </para> <para> Il est très important de noter que seuls les versions <emphasis>existantes</emphasis> qui ont été testées avec le paquet doivent être mentionnées dans la balise <compatible>. Les prochaines versions de pear.example.com/Bar doivent simplement mettre à jour la balise <recommended>. </para> <para> <compatible> peut contenir 3 sortes de balises. Les balises <min> et <max> (requises) sont utilisées pour définir un intervalle de versions testées et compatibles, <exclude> est utilisé pour excluse n'importe quelle version de l'intervalle. Dans l'exemple ci-dessus, les versions 1.3.0 et 1.2.0 représentent les versions supérieures et inférieures ainsi que la version a exclure. Il peut y avoir un nombre infini de balises <compatible> dans un fichier package.xml. </para> <refsect2> <title>Voir aussi :</title> <para> <link linkend="guide.developers.package2.dependencies.package">dépendances <package></link> </para> </refsect2> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/peardoc/fr/guide/developers/package2/contents.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/contents.xml +++ peardoc/fr/guide/developers/package2/contents.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <refentry id="guide.developers.package2.contents"> <refnamediv> <refname><contents></refname> <refpurpose>Spécifie le contenu d'une version</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.contents.purpose"> <title>Documentation du contenu d'une version</title> <para> Dans un fichier package.xml 1.0, la balise de contenu était <filelist>. La fonctionnement de cette balise a changé radicalement dans le fichier package 2.0 et a changé de nom. Maintenant, <filelist> peut être trouvé dans la section <link linkend="guide.developers.package2.release">release</link> du fichier package.xml. </para> <para> <contents> est utilisé pour décrire le contenu d'un fichier compressé. Rien de plus. Tous les fichiers présents dans la balise de contenu seront placés dans le fichier compressé et seront installés par l'installeur PEAR. Ceci permet de faire un fichier compressé qui fonctionnera directement en le décompressant, tout comme il fonctionnera avec l'installeur PEAR. </para> <para> Pour la plupart des types de versions, le contenu contient une simple balise <dir> qui elle-même peut contenir des balises <dir> et/ou <file>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewvc.cgi/peardoc/fr/guide/developers/package2/channel.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/channel.xml +++ peardoc/fr/guide/developers/package2/channel.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <refentry id="guide.developers.package2.channel"> <refnamediv> <refname><channel></refname> <refpurpose>Qu'est-ce qu'un canal ?</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.channel.intro"> <title>Introduction rapide sur les canaux</title> <para> Les canaux sont nouveaux depuis PEAR 1.4.0. Les canaux sont une façon optimisé de différencier plusieurs sources de téléchargement. Une source possible est pear.php.net, une autre, pecl.php.net, et il en existe d'autres sur le web. </para> <para> La balise <channel> doit contenir le nom complet du canal, et non un alias (n'utilisez pas, par exemple, "pear", mais plutôt "pear.php.net"). </para> <para> Une bonne façon de déterminer le nom du canal est de se poser la question suivante : "Où puis-je télécharger ma version ?". Si la réponse est pear.php.net, c'est votre canal pour votre paquet. Si la réponse est pecl.php.net, ce sera alors votre canal. </para> <para> Si vous n'exécutez pas de serveur de canaux et que vous voulez servir votre paquet de la même façon que les autres paquets, le paquet de distribution basé sur l'URI est le meilleur choix, lisez la documentation sur la balise <uri> dont le lien est fourni ci-dessous. </para> <refsect2> <title>Voir aussi :</title> <para> <link linkend="guide.developers.package2.uri"><uri></link> </para> </refsect2> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/peardoc/fr/guide/developers/package2/compatible.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/compatible.xml +++ peardoc/fr/guide/developers/package2/compatible.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <refentry id="guide.developers.package2.compatible"> <refnamediv> <refname><compatible></refname> <refpurpose>Éviter d'imposer une version stricte avec la balise <compatible></refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.compatible.intro"> <title>Travailler ave les versions de dépendance <recommended> et <compatible></title> <para> La balise <compatible> est prévu pour être utilisé avec une dépendance <package> qui contient une balise <recommended> dpuis pear.example.com/Bar version 1.3.0, comme ceci : </para> <para> <programlisting role="xml"> <![CDATA[ <package> <name>Foo</name> <channel>pear.example.com</channel> <min>1.0.0</min> <recommended>1.5.2</recommended> </package> ]]> </programlisting> </para> <para> La dépendance ci-dessus peut être traduite comme ceci : "Utilisez le paquet pear.example.com/Foo, mais uniquement la version 1.0.0 ou plus récente. Si pear.example.com/Foo n'est pas installé, installez la version 1.5.2. Si pear.example.com/Foo est installé et que ce n'est pas la version 1.5.2, ne rien faire tant que --force n'est pas spécifié, ou pear.example.com/Foo est compatible avec moi" </para> <para> Le dernier cas " ou pear.example.com/Foo est compatible avec moi." est contrôlé par la blise <compatible>. Si le fichier package.xml du paquet Foo version 1.5.3 a une balise <compatible> come ceci : </para> <para> <programlisting role="xml"> <![CDATA[ <compatible> <name>Bar</name> <channel>pear.example.com</channel> <min>1.2.0</min> <max>1.3.0</max> <exclude>1.2.9</exclude> </compatible> ]]> </programlisting> </para> <para> Ceci dira à l'installeur que pear.example.com/Foo version 1.5.3 est compatible avec pear.example.com/Bar versions 1.2.0 à 1.3.0 inclus, mais n'est pas compatible avec la version 1.2.9. </para> <para> Il est très important de noter que seuls les versions <emphasis>existantes</emphasis> qui ont été testées avec le paquet doivent être mentionnées dans la balise <compatible>. Les prochaines versions de pear.example.com/Bar doivent simplement mettre à jour la balise <recommended>. </para> <para> <compatible> peut contenir 3 sortes de balises. Les balises <min> et <max> (requises) sont utilisées pour définir un intervalle de versions testées et compatibles, <exclude> est utilisé pour excluse n'importe quelle version de l'intervalle. Dans l'exemple ci-dessus, les versions 1.3.0 et 1.2.0 représentent les versions supérieures et inférieures ainsi que la version a exclure. Il peut y avoir un nombre infini de balises <compatible> dans un fichier package.xml. </para> <refsect2> <title>Voir aussi :</title> <para> <link linkend="guide.developers.package2.dependencies.package">dépendances <package></link> </para> </refsect2> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/peardoc/fr/guide/developers/package2/contents.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/contents.xml +++ peardoc/fr/guide/developers/package2/contents.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <refentry id="guide.developers.package2.contents"> <refnamediv> <refname><contents></refname> <refpurpose>Spécifie le contenu d'une version</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.contents.purpose"> <title>Documentation du contenu d'une version</title> <para> Dans un fichier package.xml 1.0, la balise de contenu était <filelist>. La fonctionnement de cette balise a changé radicalement dans le fichier package 2.0 et a changé de nom. Maintenant, <filelist> peut être trouvé dans la section <link linkend="guide.developers.package2.release">release</link> du fichier package.xml. </para> <para> <contents> est utilisé pour décrire le contenu d'un fichier compressé. Rien de plus. Tous les fichiers présents dans la balise de contenu seront placés dans le fichier compressé et seront installés par l'installeur PEAR. Ceci permet de faire un fichier compressé qui fonctionnera directement en le décompressant, tout comme il fonctionnera avec l'installeur PEAR. </para> <para> Pour la plupart des types de versions, le contenu contient une simple balise <dir> qui elle-même peut contenir des balises <dir> et/ou <file>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->