cvs: peardoc /fr/chapters intro.xml

From: Date: Mon, 11 Jul 2005 07:08:41 +0000
Subject: cvs: peardoc /fr/chapters intro.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-6499@lists.php.net to get a copy of this message
moosh Mon Jul 11 03:08:41 2005 EDT Modified files: /peardoc/fr/chapters intro.xml Log: -sync to EN1.13 *1.11 Synced the information about the PFC with the reality. * 1.12 added chapter titles * 1.13 reverting duplicate <title> tags -- sorry

http://cvs.php.net/diff.php/peardoc/fr/chapters/intro.xml?r1=1.9&r2=1.10&ty=u Index: peardoc/fr/chapters/intro.xml diff -u peardoc/fr/chapters/intro.xml:1.9 peardoc/fr/chapters/intro.xml:1.10 --- peardoc/fr/chapters/intro.xml:1.9 Sun Jun 12 02:24:57 2005 +++ peardoc/fr/chapters/intro.xml Mon Jul 11 03:08:40 2005 @@ -1,306 +1,238 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.10 Maintainer: moosh Status: ready --> - <chapter id="introduction"> - <chapterinfo> - <author> - <firstname>Stig</firstname> - <surname>Bakken</surname> - </author> - <date>2002-02-10</date> - </chapterinfo> - <title>Introduction</title> - <subtitle>The PEAR Manifest</subtitle> - <simpara> - PEAR est d&eacute;di&eacute; &agrave; Malin Bakken, - n&eacute; le 21 Novembre 1999. - </simpara> - - <sect1 id="about.pear"> - <title>Qu'est-ce que PEAR ?</title> - +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.13 Maintainer: moosh Status: ready --> +<chapter id="introduction"> + <chapterinfo> + <author> + <firstname>Stig</firstname> + <surname>Bakken</surname> + </author> + <date>2002-02-10</date> + </chapterinfo> + <title>Introduction</title> + <subtitle>The PEAR Manifest</subtitle> + <simpara> + PEAR est d&eacute;di&eacute; &agrave; Malin Bakken, + n&eacute; le 21 Novembre 1999. + </simpara> + + <sect1 id="about.pear"> + <title>Qu'est-ce que PEAR ?</title> + + <para> + PEAR est l'abbr&eacute;viation de + <quote> + PHP Extension and Application Repository + </quote> + et se prononce 'p&egrave;re' + (NDT : pear veut dire poire en Anglais). + + La mission de PEAR est de fournir : + <itemizedlist> + <listitem> + <simpara> + Une librairie structur&eacute;e de code source libre + pour les utilisateurs de PHP + </simpara> + </listitem> + <listitem> + <simpara> + Un syst&egrave;me de distribution du code source et de maintenance des + packages (modules) + </simpara> + </listitem> + <listitem> + <simpara> + Un style de codage pour les programmes &eacute;crit en PHP, + sp&eacute;cifi&eacute; <link linkend="standards">l&agrave;</link> + </simpara> + </listitem> + <listitem> + <simpara> + Une biblioth&egrave;que d'extensions de PHP + (PECL - PHP Extension Code Library), + <link linkend="about-pecl">voir d&eacute;tails ci-dessous</link> + </simpara> + </listitem> + <listitem> + <simpara> + Un site Web, des listes de diffusion et des sites mirroirs pour + supporter la communaut&eacute; PHP/PEAR + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + PEAR est un projet comunautaire conduit par le + <ulink url="&url.pear.group;">Groupe PEAR</ulink>. + Le projet a &eacute;t&eacute; cr&eacute;&eacute; + par Stig S. Bakken en 1999 et + <ulink url="&url.pear.account;">beaucoup de + personnes</ulink> l'ont rejoint depuis. + </para> + <sect2 id="about-pear-stlib"> + <title>Biblioth&egrave;que structur&eacute;e de code PHP</title> + <para> + Dans PEAR, le code est s&eacute;par&eacute; en + <quote>packages</quote> (ou modules). + + Chaque package est un projet s&eacute;par&eacute;, + avec sa propre &eacute;quipe de d&eacute;veloppement, + son num&eacute;ro de version, son cycle de publication, + sa documentation et une relation bien d&eacute;finie + avec les autres packages + (incluant les d&eacute;pendances vis-&agrave;-vis d'autres packages). + + Les packages sont distribu&eacute;s sous la forme d'une archive tar + compress&eacute;e (gzip), + comprenant un fichier de description du package, + et sont install&eacute;s + sur votre syst&egrave;me local &agrave; + l'aide du script d'installation de PEAR. + </para> <para> - PEAR est l'abbr&eacute;viation de - <quote> - PHP Extension and Application Repository - </quote> - et se prononce 'p&egrave;re' - (NDT : pear veut dire poire en Anglais). + Il existe deux types de packages : les <quote>source packages</quote>, + qui ne contiennent que des fichiers de code source, et les + <quote>binary packages</quote>, + qui contiennent des fichiers binaires, d&eacute;pendant du type + de syst&egrave;me utilis&eacute;, + et eventuellement les fichiers de code source. - La mission de PEAR est de fournir : + Installer un <quote>source package</quote> contenant du code C, + demande evidemment un environnement de compilation. + </para> + <para> + PEAR definit les packages comme une arborescence, o&ugrave; chaque + <quote>noeud</quote> + de l'arborescence est repr&eacute;sent&eacute; + par une partie du nom du package. + + Les noeuds sont organis&eacute;s par sujets + &eacute;l&eacute;mentaires, et chaque partie + est s&eacute;par&eacute;e par un <quote>underscore</quote>. + + Exemples de noms de packages : + <quote>MP3_Id</quote>, + <quote>Archive_Tar</quote> + et <quote>HTTP_Post</quote>. + </para> + <para> + Les packages peuvent &ecirc;tre li&eacute;s entre eux par + des d&eacute;pendances explicites, + mais il n'y a pas de relation automatique par exemple + entre un package et son parent dans l'arborescence + (par exemple, + <quote>HTTP_Post</quote> et par d&eacute;faut ind&eacute;pendant de + <quote>HTTP</quote>). + </para> + <para> + Quelques noeuds primaires dans l'arborescence, appel&eacute;s + <quote>sous-repositaires</quote>, ont des fonctions particuli&egrave;res. + + Il s'agit actuellement de + <link linkend="about-pecl">PECL</link>, + et <link linkend="about-gtk">Gtk</link>. + + Pour chacun d'eux des r&egrave;gles diff&eacute;rentes s'appliquent, + elles sont expliqu&eacute;es dans leur description ci-dessous. + </para> + <para> + Un guide de style de codage, la 'Convention de Codage PEAR' + (<link linkend="standards">PEAR Coding Standards</link>, PCS en + abr&eacute;g&eacute;), existe pour aider la collaboration + entre les d&eacute;veloppeurs de PEAR, + pour apporter de la qualit&eacute; + et de la portabilit&eacute;, + et pour aider les contributeurs + &agrave; PEAR &agrave; fournir des API coh&eacute;rentes. + </para> + </sect2> + <sect2 id="about-pear-distpkg"> + <title>Distribution du Code et Gestion des Packages</title> + <para> + Tous les packages PEAR sont enregistr&eacute;s + et charg&eacute;s dans une base + de donn&eacute;es centrale se trouvant sur pear.php.net. Des packages + d'autres origines, mais de sources libre, peuvent aussi &ecirc;tre + enregistr&eacute;s et charg&eacute;s. + + Les packages dont le source n'est pas + libre peuvent &ecirc;tre install&eacute;s par le script d'installation de PEAR, + mais la base de donn&eacute;es de PEAR est r&eacute;serv&eacute;e au code libre. + </para> + <para> + Pear.php.net fournira aussi bien une interface conviviale pour + les personnes (HTML), qu'une interface pour les machines + (actuellement XML-RPC) + pour acc&egrave;der &agrave; la base de donn&eacute;es de PEAR. + + Le t&eacute;l&eacute;chargement des packages est effectu&eacute; par HTTP. + Les autres fonctions qui seront fournies par pear.php.net sont : <itemizedlist> <listitem> <simpara> - Une librairie structur&eacute;e de code source libre - pour les utilisateurs de PHP - </simpara> - </listitem> - <listitem> - <simpara> - Un syst&egrave;me de distribution du code source et de maintenance des - packages (modules) + Gestion des comptes utilisateurs + (int&eacute;gr&eacute;e avec le serveur CVS) </simpara> </listitem> <listitem> - <simpara> - Un style de codage pour les programmes &eacute;crit en PHP, - sp&eacute;cifi&eacute; <link linkend="standards">l&agrave;</link> - </simpara> - </listitem> - <listitem> - <simpara> - Des Classes PHP Fondamentales (PFC - PHP Foundation Classes), - <link linkend="about-pfc">voir d&eacute;tails ci-dessous</link> - </simpara> - </listitem> - <listitem> - <simpara> - Une biblioth&egrave;que d'extensions de PHP - (PECL - PHP Extension Code Library), - <link linkend="about-pecl">voir d&eacute;tails ci-dessous</link> - </simpara> + <simpara>Gestion des packages</simpara> </listitem> <listitem> - <simpara> - Un site Web, des listes de diffusion et des sites mirroirs pour - supporter la communaut&eacute; PHP/PEAR - </simpara> + <simpara>Gestion des releases</simpara> </listitem> </itemizedlist> </para> - <para> - PEAR est un projet comunautaire conduit par le - <ulink url="&url.pear.group;">Groupe PEAR</ulink>. - Le projet a &eacute;t&eacute; cr&eacute;&eacute; - par Stig S. Bakken en 1999 et - <ulink url="&url.pear.account;">beaucoup de - personnes</ulink> l'ont rejoint depuis. + Les packages sont distribu&eacute;s sous la forme d'une archive tar + compress&eacute;e (gzip) contenant un fichier XML de description. + Ce fichier contient les informations sur le package, la liste des + fichiers et leurs r&ocirc;les, ainsi que les d&eacute;pendances. </para> - - <sect2 id="about-pear-stlib"> - <title>Biblioth&egrave;que structur&eacute;e de code PHP</title> - <para> - Dans PEAR, le code est s&eacute;par&eacute; en - <quote>packages</quote> (ou modules). - - Chaque package est un projet s&eacute;par&eacute;, - avec sa propre &eacute;quipe de d&eacute;veloppement, - son num&eacute;ro de version, son cycle de publication, - sa documentation et une relation bien d&eacute;finie - avec les autres packages - (incluant les d&eacute;pendances vis-&agrave;-vis d'autres packages). - - Les packages sont distribu&eacute;s sous la forme d'une archive tar - compress&eacute;e (gzip), - comprenant un fichier de description du package, et sont install&eacute;s - sur votre syst&egrave;me local &agrave; - l'aide du script d'installation de PEAR. - </para> - <para> - Il existe deux types de packages : les <quote>source packages</quote>, - qui ne contiennent que des fichiers de code source, et les - <quote>binary packages</quote>, - qui contiennent des fichiers binaires, d&eacute;pendant du type - de syst&egrave;me utilis&eacute;, - et eventuellement les fichiers de code source. - - Installer un <quote>source package</quote> contenant du code C, demande evidemment - un environnement de compilation. - </para> - <para> - PEAR definit les packages comme une arborescence, o&ugrave; chaque - <quote>noeud</quote> - de l'arborescence est repr&eacute;sent&eacute; - par une partie du nom du package. - - Les noeud sont organis&eacute;s par sujets - &eacute;l&eacute;mentaires, et chaque partie - est s&eacute;par&eacute;e par un <quote>underscore</quote>. - - Exemples de noms de packages : - <quote>MP3_Id</quote>, <quote>Archive_Tar</quote> et <quote>HTTP_Post</quote>. - </para> - <para> - Les packages peuvent &ecirc;tre li&eacute;s entre eux par - des d&eacute;pendances explicites, - mais il n'y a pas de relation automatique par exemple - entre un package et son parent dans l'arborescence - (par exemple, - <quote>HTTP_Post</quote> et par d&eacute;faut ind&eacute;pendant de - <quote>HTTP</quote>). - </para> - <para> - Quelques noeuds primaires dans l'arborescence, appel&eacute;s - <quote>sous-repositaires</quote>, ont des fonctions particuli&egrave;res. - - Il s'agit actuellement de - <link linkend="about-pecl">PECL</link>, - <link linkend="about-gtk">Gtk</link> - et <link linkend="about-app">App</link>. - - Pour chacun d'eux des r&egrave;gles diff&eacute;rentes s'appliquent, - elles sont expliqu&eacute;es dans leur description ci-dessous. - </para> - <para> - Un guide de style de codage, la 'Convention de Codage PEAR' - (<link linkend="standards">PEAR Coding Standards</link>, PCS en - abr&eacute;g&eacute;), existe pour aider la collaboration entre les d&eacute;veloppeurs - de PEAR, pour apporter de la qualit&eacute; et de la portabilit&eacute;, et pour - aider les contributeurs &agrave; PEAR &agrave; fournir des API coh&eacute;rentes. Pour - les packages se trouvant dans <link linkend="about-pfc">PFC</link>, - cette r&egrave;gle s'applique de fa&ccedil;on stricte, pour les packages en dehors - de PFC, elle s'applique de fa&ccedil;on plus souple. - </para> - </sect2> - - <sect2 id="about-pear-distpkg"> - <title>Distribution du Code et Gestion des Packages</title> - <para> - Tous les packages PEAR sont enregistr&eacute;s et charg&eacute;s dans une base - de donn&eacute;es centrale se trouvant sur pear.php.net. Des packages - d'autres origines, mais de sources libre, peuvent aussi &ecirc;tre - enregistr&eacute;s et charg&eacute;s. Les packages dont le source n'est pas - libre peuvent &ecirc;tre install&eacute;s par le script d'installation de PEAR, - mais la base de donn&eacute;es de PEAR est r&eacute;serv&eacute;e au code libre. - </para> - <para> - Pear.php.net fournira aussi bien une interface conviviale pour - les personnes (HTML), qu'une interface pour les machines - (actuellement XML-RPC) - pour acc&egrave;der &agrave; la base de donn&eacute;es de PEAR. - Le t&eacute;l&eacute;chargement des packages est effectu&eacute; par HTTP. - Les autres fonctions qui seront fournies par pear.php.net sont : - <itemizedlist> - <listitem> - <simpara> - Gestion des comptes utilisateurs (int&eacute;gr&eacute;e avec le serveur CVS) - </simpara> - </listitem> - <listitem> - <simpara>Gestion des packages</simpara> - </listitem> - <listitem> - <simpara>Gestion des releases</simpara> - </listitem> - </itemizedlist> - </para> - <para> - Les packages sont distribu&eacute;s sous la forme d'une archive tar - compress&eacute;e (gzip) contenant un fichier XML de description. - Ce fichier contient les informations sur le package, la liste des - fichiers et leurs r&ocirc;les, ainsi que les d&eacute;pendances. - </para> - </sect2> - - <sect2 id="about-pfc"> - <title>Les Classes PHP Fondamentales</title> - <titleabbrev>PFC</titleabbrev> - <para> - Les Classes PHP Fondamentales (PFC - PHP Foundation Classes) sont - un sous-ensemble de PEAR qui insistent sur la qualit&eacute;, - le c&ocirc;t&eacute; g&eacute;n&eacute;rique, - l'interop&eacute;rabilit&eacute; et la compatibilit&eacute;. - Si PHP continue &agrave; distribuer les packages PEAR - dans son propre installer, ce seront les classes PFC. - </para> - <para> - Insister sur la qualit&eacute; veut dire qu'aucun package ou release de - qualit&eacute; moins que "stable" n'est accept&eacute; dans les PFC. - </para> - <para> - G&eacute;n&eacute;rique veut dire que les packages doivent &ecirc;tre - le moins sp&eacute;cifiques possible &agrave; - un certain type d'environement (comme une sortie en HTML, - un syst&egrave;me d'exploitation, un serveur Web, etc ...). - </para> - <para> - Les packages interop&eacute;rables fonctionnent sans soucis avec les - autres packages, ont des API stables et standards. - Ils pr&eacute;f&egrave;rent - les composants bien connus (et &eacute;galement interop&eacute;rables) qui - fonctionnent bien dans diff&eacute;rents environnements (Version PHP, - SAPI, syst&egrave;me d'exploitation, ...). - </para> - <para> - La compatibilit&eacute; ne consiste pas simplement &agrave; supporter la - m&ecirc;me s&eacute;mantique et - syntaxe que les versions pr&eacute;c&eacute;dentes, mais aussi - &agrave; penser aux futures &eacute;volutions - lorsque le code est &eacute;crit. - - Architecturer le code de telle sorte qu'il soit facile, - ou au moins possible, d'ajouter des fonctions - que l'on attend naturellement, donne un - package qui a aussi une compatibillt&eacute; ascendante. - </para> - </sect2> - + </sect2> <sect2 id="about-pecl"> - <title>La biblioth&egrave;que d'extensions de PHP (PECL)</title> - <subtitle>PECL</subtitle> - <para> - PECL (prononcer <quote>piqueule</quote>) est un sous-ensemble de PEAR pour - les extensions de PHP &eacute;crite en C, semblables &agrave; celles distribu&eacute;es - avec PHP4. - De fait, avoir un lieu o&ugrave; d&eacute;placer les extensions - actuelles de PHP a &eacute;t&eacute; l'une des motivations lors de la cr&eacute;ation - de PECL. Les extensions dans PECL suivent la convention de codage - PHP plut&ocirc;t que celle de PEAR, mais elles sont distribu&eacute;es et - install&eacute;es comme des package PEAR. - </para> - <para> - Le processus de d&eacute;placement d'une extension de PHP vers PECL est appell&eacute;e - "pickling". - </para> - <para> - En Octobre 2003, PECL est devenu un projet ind&eacute;pendant, - qui n'appartient plus du tout &agrave; - PEAR (&agrave; l'exception de l'infrastructure, - que PECL a emprunt&eacute; &agrave; PEAR). - Plus d'informations et tous les paquetages PECL - peuvent &ecirc;tre trouv&eacute;s sur la - <ulink url="&url.pecl;">page d'accueil de PECL</ulink>. - Durant le d&eacute;placement de PECL, - le projet a &eacute;galement &eacute;t&eacute; renomm&eacute; de - <quote>PHP Extension Code Library</quote> en - <quote>PHP Extension Community Library</quote>. - </para> - </sect2> - + <title>La biblioth&egrave;que d'extensions de PHP (PECL)</title> + <subtitle>PECL</subtitle> + <para> + PECL (prononcer <quote>piqueule</quote>) est un sous-ensemble de PEAR pour + les extensions de PHP &eacute;crite en C, semblables &agrave; celles distribu&eacute;es + avec PHP4. + De fait, avoir un lieu o&ugrave; d&eacute;placer les extensions + actuelles de PHP a &eacute;t&eacute; l'une des motivations lors de la cr&eacute;ation + de PECL. Les extensions dans PECL suivent la convention de codage + PHP plut&ocirc;t que celle de PEAR, mais elles sont distribu&eacute;es et + install&eacute;es comme des package PEAR. + </para> + <para> + Le processus de d&eacute;placement d'une extension de PHP vers PECL est appell&eacute;e + "pickling". + </para> + <para> + En Octobre 2003, PECL est devenu un projet ind&eacute;pendant, + qui n'appartient plus du tout &agrave; + PEAR (&agrave; l'exception de l'infrastructure, + que PECL a emprunt&eacute; &agrave; PEAR). + Plus d'informations et tous les paquetages PECL + peuvent &ecirc;tre trouv&eacute;s sur la + <ulink url="&url.pecl;">page d'accueil de PECL</ulink>. + Durant le d&eacute;placement de PECL, + le projet a &eacute;galement &eacute;t&eacute; renomm&eacute; de + <quote>PHP Extension Code Library</quote> en + <quote>PHP Extension Community Library</quote>. + </para> + </sect2> <sect2 id="about-gtk"> - <title>Packages Gtk</title> - <subtitle>Gtk</subtitle> - <para> - Les packages GTK mettent &agrave; disposition des applications qui utilisent - la technologie du projet <ulink url="&url.php.gtk;">PHP-GTK</ulink>. - Le code de ce sous-repositaire suit la - <link linkend="standards">convention de codage</link> de PEAR. - </para> - <para> - Pour l'instant, il n'y a pas de plan d&eacute;finitif - quant &agrave; la fa&ccedil;on dont ils - seront int&eacute;gr&eacute;s &agrave; PEAR. - </para> - </sect2> - - <sect2 id="about-app"> - <title>Les Packages applicatifs</title> - <subtitle>App</subtitle> - <para> - A FAIRE - <!-- - Ideas: - * files may also be installed in the web server's document root - * installer knows how to configure one or more web servers to - set up a virtual host or subdirectory for the application - --> - </para> - </sect2> - - </sect1> - - </chapter> + <title>Packages Gtk</title> + <subtitle>Gtk</subtitle> + <para> + Les packages GTK mettent &agrave; disposition des applications qui utilisent + la technologie du projet <ulink url="&url.php.gtk;">PHP-GTK</ulink>. + Le code de ce sous-repositaire suit la + <link linkend="standards">convention de codage</link> de PEAR. + </para> + </sect2> + </sect1> +</chapter> <!-- Keep this comment at the end of the file Local variables:
« previous php.pear.doc (#6499) next »