cvs: peardoc /fr/guide/developers/package2 uri.xml usesrole.xml usestask.xml version.xml

From: Date: Mon, 25 Sep 2006 19:12:38 +0000
Subject: cvs: peardoc /fr/guide/developers/package2 uri.xml usesrole.xml usestask.xml version.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-8524@lists.php.net to get a copy of this message
yannick Mon Sep 25 19:12:38 2006 UTC Added files: /peardoc/fr/guide/developers/package2 uri.xml usesrole.xml usestask.xml version.xml Log: initial translation

http://cvs.php.net/viewvc.cgi/peardoc/fr/guide/developers/package2/uri.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/uri.xml +++ peardoc/fr/guide/developers/package2/uri.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.uri"> <refnamediv> <refname>&lt;uri&gt;</refname> <refpurpose>Quand dois-je utiliser la balise &lt;uri&gt; ?</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.uri.intro"> <title>Quand dois-je utiliser la balise &lt;uri&gt; plutôt que la balise &lt;channel&gt; ?</title> <para> Si vous n'avez pas de serveur de canaux et que vous voulez servir vos paquets qui peuvent dépendre d'autres, utilisez la balise &lt;uri&gt;. Cette balise devra contenir une URI statique qui indiquera une seule version de paquet downloadable.tgz. </para> <para> Si vous n'avez pas besoin de dépendances distantes, alors utilisez simplement le canal pear.php.net comme canal de votre paquet. </para> <para> Pour le moment, si vous voulez servir un paquet Foo version 1.1.0 depuis www.example.com, utilisez l'URI suivante : &quot;http://www.example.com/Foo-1.1.0&quot;. Notez que l'URI doit contenir le chemin complet, SAUF l'extension. </para> <refsect2> <title>Voir aussi :</title> <para> <link linkend="guide.developers.package2.channel">&lt;channel&gt;</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/usesrole.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/usesrole.xml +++ peardoc/fr/guide/developers/package2/usesrole.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.usesrole"> <refnamediv> <refname>&lt;usesrole&gt;</refname> <refpurpose>Documente les fichiers de rôles personnalisés utilisés dans la balise &lt;contents&gt;</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.usesrole.purpose"> <title>Documenter les fichiers de rôles personnalisés</title> <para> Les fichiers de rôles standards, fournis par défaut avec PEAR, sont : </para> <para> <itemizedlist> <listitem> <para> php </para> </listitem> <listitem> <para> data </para> </listitem> <listitem> <para> doc </para> </listitem> <listitem> <para> test </para> </listitem> <listitem> <para> script </para> </listitem> <listitem> <para> src </para> </listitem> <listitem> <para> ext </para> </listitem> </itemizedlist> </para> <para> Si votre paquet choisit d'utiliser un rôle fourni par une troisième partie qui implémente un gestionnaire de fichiers d'installations avancés, tout ce dont vous avez à faire est de spécifier le rôle dans le xml, dans la balise &lt;file&gt;, comme ceci : </para> <para> <programlisting role="xml"> <![CDATA[ <file role="foo"/> ]]> </programlisting> </para> <para> Dependant, si un utilisateur n'a pas installé le paquet qui fournit le rôle personnalisé &quot;foo&quot;, alors, le message d'erreur lors de l'installation affichera simplement : &quot;unknown role 'foo'&quot;, ce qui n'est pas très parlant. </para> <para> La balise &lt;usesrole&gt; informe l'installeur d'informer l'utilisateur en ces termes : &quot;this package uses the custom role 'foo', install package pear.example.com/Foo to use&quot; </para> <para> <programlisting role="xml"> <![CDATA[ <usesrole> <role>foo</role> <package>Foo</package> <channel>pear.example.com</channel> </usesrole> ]]> </programlisting> </para> <para> Notez que les paquets URI statiques (paquets supportant les canaux) sont également supportés : </para> <para> <programlisting role="xml"> <![CDATA[ <usesrole> <role>foo</role> <uri>http://pear.example.com/Foo-1.2.0</uri> </usesrole> ]]> </programlisting> </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/usestask.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/usestask.xml +++ peardoc/fr/guide/developers/package2/usestask.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.usestask"> <refnamediv> <refname>&lt;usestask&gt;</refname> <refpurpose>Documente une tâche personnalisée dans la balise &lt;contents&gt;</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.usestask.purpose"> <title>Documenter un fichier de tâches personnalisées</title> <para> Les fichiers de tâches standards, fournis par défaut avec PEAR, sont documentés <link linkend="guide.developers.package2.tasks">ici</link>. </para> <para> Si votre paquet choisit d'utiliser une tâche fournie par une troisième partie, tout ce dont vous avez besoin de faire est de spécifier la tâche en tant que partie du xml pour la balise &lt;file&gt; qui se présente comme ceci : </para> <para> <programlisting role="xml"> <![CDATA[ <file role="php"> <tasks:foo/> </file> ]]> </programlisting> </para> <para> Cependant, si un utilisateur n'a pas installé le paquet qui fournit la tâche personnalisée &quot;foo&quot;, alors, le message d'erreur lors de l'installation indiquera simplement &quot;unknown task 'foo'&quot;, qui n'est pas très utile. </para> <para> La balise &lt;usestask&gt; indique à l'installeur de demander à l'utilisateur ceci : &quot;this package uses the custom task 'foo', install package pear.example.com/Foo to use&quot; </para> <para> <programlisting role="xml"> <![CDATA[ <usestask> <task>foo</task> <package>Foo</package> <channel>pear.example.com</channel> </usestask> ]]> </programlisting> </para> <para> Notez que les paquets URI statiques (paquets supportant les canaux) sont également supportés : </para> <para> <programlisting role="xml"> <![CDATA[ <usestask> <task>foo</task> <uri>http://pear.example.com/Foo-1.2.0</uri> </usesrole> ]]> </programlisting> </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/version.xml?view=markup&rev=1.1 Index: peardoc/fr/guide/developers/package2/version.xml +++ peardoc/fr/guide/developers/package2/version.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.version"> <refnamediv> <refname>&lt;version&gt;</refname> <refpurpose>Les version en package.xml 2.0</refpurpose> </refnamediv> <refsect1 id="guide.developers.package2.version.purpose"> <title>Documenter les versions et l'API de la version</title> <para> En package.xml 1.0, la version était tout simplement la... version. En package.xml 2.0, la version est séparée en deux composants, la version et l'API. </para> <para> La version représente la même chose qu'en package.xml 1.0. La version est validée de façon très prudente par le développeur. </para> <para> La version de l'API est uniquement une information - l'installeur ne l'utilise pas. Il peut être utilisé pour un remplacement de l'heure du paquet par l'installeur. Ceci peut être utile lors de l'implémentation d'une méthode réflective comme <function>getApiVersion</function>. De plus, la version de l'API est validée rapidement et ne nécessite qu'un numéro de version compatible version_compare(). </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 -->
« previous php.pear.doc (#8524) next »