cvs: peardoc /fr/package/datetime/calendar intro-overview.xml
| From: | romainBourdon | Date: | Wed, 31 Mar 2004 18:53:22 +0000 |
| Subject: | cvs: peardoc /fr/package/datetime/calendar intro-overview.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-3165@lists.php.net to get a copy of this message | ||
romain Wed Mar 31 13:53:22 2004 EDT
Modified files:
/peardoc/fr/package/datetime/calendar intro-overview.xml
Log:
First translation
http://cvs.php.net/diff.php/peardoc/fr/package/datetime/calendar/intro-overview.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/fr/package/datetime/calendar/intro-overview.xml diff -u peardoc/fr/package/datetime/calendar/intro-overview.xml:1.1 peardoc/fr/package/datetime/calendar/intro-overview.xml:1.2 --- peardoc/fr/package/datetime/calendar/intro-overview.xml:1.1 Wed Mar 24 09:55:22 2004 +++ peardoc/fr/package/datetime/calendar/intro-overview.xml Wed Mar 31 13:53:22 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" ?> -<!-- $Id: intro-overview.xml,v 1.1 2004/03/24 14:55:22 didou Exp $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: partial --> +<!-- $Id: intro-overview.xml,v 1.2 2004/03/31 18:53:22 romain Exp $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: partial --> <refentry id="package.datetime.calendar.intro-overview"> <refnamediv> <refname>Tour d'horizon du package</refname> @@ -24,120 +24,114 @@ <para> <itemizedlist> <listitem> - <para><classname>Calendar_Year</classname> - represents a year and can build <classname>Calendar_Month</classname>, <classname>Calendar_Month_Weekdays</classname> and <classname>Calendar_Month_Weeks</classname> objects. + <para><classname>Calendar_Year</classname> - représente une année et peut contruire des objets <classname>Calendar_Month</classname>, <classname>Calendar_Month_Weekdays</classname> et <classname>Calendar_Month_Weeks</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Year.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Year.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Month</classname> - represents a month and can build <classname>Calendar_Day</classname> objects. + <para><classname>Calendar_Month</classname> - représente un mois et peut construire des objets <classname>Calendar_Day</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Month.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Month.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Day</classname> - represents a day and can build <classname>Calendar_Hour</classname> objects. + <para><classname>Calendar_Day</classname> - représente un jour et peut contstruire des objets <classname>Calendar_Hour</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Day.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Day.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Hour</classname> - represents a hour and can build <classname>Calendar_Minute</classname> objects. + <para><classname>Calendar_Hour</classname> - représente une heure et peut construire des objets <classname>Calendar_Minute</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Hour.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Hour.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Minute</classname> - represents a minute and can build <classname>Calendar_Second</classname> objects. + <para><classname>Calendar_Minute</classname> - représente une minute et peut construire des objets <classname>Calendar_Second</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Minute.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Minute.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Second</classname> - represents a second but cannot build anything. + <para><classname>Calendar_Second</classname> - représente une seconde et ne peut construire aucun objet. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Second.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Second.php'; ]]></programlisting>.</para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.datetime.calendar.intro-overview.tabular"> - <title>Tabular Date Classes</title> - <para>Designed for building calendars in tabular format. All are subclasses of <classname>Calendar</classname> so provide the methods defined there.</para> + <title>Classes de Dates Tabulaires </title> + <para>Permet de construire des calendriers au format tabulaire. Ce sont toutes des sous classes de <classname>Calendar</classname>, elles disposent donc des mêmes méthodes.</para> <para> <itemizedlist> <listitem> - <para><classname>Calendar_Month_Weekdays</classname> - builds <classname>Calendar_Day</classname> objects setting the <function>isFirst</function>, <function>isLast</function> and <function>isEmpty</function> states, to display a month in tabular form. + <para><classname>Calendar_Month_Weekdays</classname> - construit des objets <classname>Calendar_Day</classname> en réglant les états <function>isFirst</function>, <function>isLast</function> et <function>isEmpty</function> afin d'afficher un mois sous forme tabulaire. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Month/Weekdays.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Month/Weekdays.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Month_Weeks</classname> - builds <classname>Calendar_Week</classname> objects, representing a month in terms of the tabular weeks in contains (see FAQ for what a week represents). + <para><classname>Calendar_Month_Weeks</classname> - construit des objets <classname>Calendar_Week</classname> en représentant un mois en fonction des semaines tabulaires qu'il contient (consultez la FAQ pour la représentation des semaines). </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Month/Weeks.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Month/Weeks.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Week</classname> - builds <classname>Calendar_Day</classname> objects, setting the <function>isEmpty</function> state if necessary and representing a tabular week in a month (i.e. you get 7 days from it). + <para><classname>Calendar_Week</classname> - construit des objets <classname>Calendar_Day</classname> en réglant l' état <function>isEmpty</function> si nécessaire et en représentant une semaine tabulaire dans un mois (elle renvoie 7 jours). </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Week.php'; ]]></programlisting>.</para> - </listitem> - <listitem> - <para><classname>Calendar_Week</classname> - builds <classname>Calendar_Day</classname> objects, setting the <function>isEmpty</function> state if necessary and representing a tabular week in a month (i.e. you get 7 days from it). - </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Week.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Week.php'; ]]></programlisting>.</para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.datetime.calendar.intro-overview.validation"> - <title>Validation Classes</title> - <para>Used to validate dates. <classname>Calendar</classname> provides the methods - <function>isValid</function> to perform a simple check on any date and - <function>getValidator</function> to return an instance of - <classname>Calendar_Validator</classname> for fine grained validation.</para> + <title>Classes de Validation</title> + <para>Permet de valider des dates. <classname>Calendar</classname> fournit les méthodes + <function>isValid</function> afin de faire une vérification simple sur n'importe quelle date + et <function>getValidator</function> qui renvoie une instance de + <classname>Calendar_Validator</classname> pour une validation plus fine.</para> <para> <itemizedlist> <listitem> - <para><classname>Calendar_Validator</classname> - is not instantiated by your code directly - (you need need specifically include / create it) but instead returned from the - <classname>Calendar</classname>::<function>getValidator</function> method you can call on - any subclass of <classname>Calendar</classname>. It is used to provide fine grained - validation of a date to find out exactly what's wrong with it (for simple validation just - call <function>isValid</function> on any Date object or Tabular Date object, to know if it - was created with valid values. + <para><classname>Calendar_Validator</classname> - n'est pas instancié automatiquement dans + votre code (vous devez inclure / le créer). Pour le créer utilisez la méthode + <classname>Calendar</classname>::<function>getValidator</function> que vous pouvez utiliser + sur n'importe quelle sous classe de <classname>Calendar</classname>. Cette méthode permet + d'avoir des informations de validité détaillées et ainsi de trouver la source de l'erreur + pour des objets de Date ou de Date Tabulaire. </para> </listitem> <listitem> - <para><classname>Calendar_Validation_Error</classname> - represents a validation error, - providing methods to determine what went wrong. Available methods are - <function>getUnit</function> (e.g. returns Year or Month), <function>getValue</function> - (the value it failed with), <function>getMessage</function> (the validation error message) - and <function>toString</function> which returns a combination of all the three preceding - methods. The default validation error messages are in English but stored in the constants - <constant>CALENDAR_VALUE_TOOSMALL</constant> and - <constant>CALENDAR_VALUE_TOOLARGE</constant> which you can redefine in your code. + <para><classname>Calendar_Validation_Error</classname> - représente une erreur de validation, + fournit des méthodes pour détermnier la source de l'erreur. Les méthodes disponibles sont + <function>getUnit</function> (renvoie Year ou Month), <function>getValue</function> + (la valeur de l'erreur), <function>getMessage</function> (le message d'erreur de validation) + et <function>toString</function> qui renvoie une combinaison des trois méthodes précédentes. + Les messages d'erreur de validation sont en Anglais par défaut. Il sont définis par les constantes + <constant>CALENDAR_VALUE_TOOSMALL</constant> et + <constant>CALENDAR_VALUE_TOOLARGE</constant> qui peuvent être redéfinies dans votre code. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.datetime.calendar.intro-overview.decorators"> - <title>Decorators</title> - <para>Provide a mechanism to add functionality to the main calendar objects (the subclasses of - <classname>Calendar</classname>) without needing to directly extend them (and risk overwriting - fields accidentally). When you create a decorator, you pass it's constructor an instance of an - existing calendar object. You can then make calls to the decorator in exactly the same way as you - make calls to the original calendar object. This allows you to "overwrite" calendar methods, add - new methods or even apply multiple decorators to the same calendar object. Decorators a typically - either "injected" (via selection or the <classname>Calendar_Decorator_Wrapper</classname> - decorator) into the loop where the calendar is rendered and / or to alter the output content - (e.g. convert a numeric month into a textual month: 1 => January).</para> - <para> - PEAR::Calendar provides some decorator implementations for you, to help with common tasks. These - are not designed to suit everyone and hence are provided as optional code for you to use as - needed (avoiding the performance cost associated with parsing code you're not using). + <title>Les Décorateurs</title> + <para>Fournit un mécanisme permettant d'ajouter des fonctionnalités aux principaux objets Calendar (les sous classes de + <classname>Calendar</classname>) sans avoir besoin de les étendre (et prendre le risque d'écraser des champs + accidentellement). Pour créer un décorateur, vous devez passer un objet Calendar au constructeur. + Vous pourrez alors faire des appels au décorateur au lieu de les faire sur l'objet d'origine. + Cela vous permettra de réécrire les méthodes de Calendar, ajouter de nouvelles méthodes ou même + appliquer des décorateurs multiples au même objet Calendar. Les décorateurs peuvent être injecté + (via une sélection ou le décorateur <classname>Calendar_Decorator_Wrapper</classname> ) + dans la boucle générant le calendrier afin de modifier son contenu + (pour par exemple convertir des valeurs numériques en textes : 1 -> janvier).</para> + <para> + PEAR::Calendar fournit des implémentations de décorateurs afin d'effectuer les tâches communes. Celles-ci + ne correspondront pas aux besoins de tous et sont fournies en tant que code optionnel + (afin de ne pas détériorer les performances si vous ne les utilisez pas). </para> <para> <itemizedlist> <listitem> - <para><classname>Calendar_Decorator</classname> - this is the base decorator class which you - should extend with your own. It provides the same API as the calendar object it is - decorating, and simply routes calls through to it. Example; + <para><classname>Calendar_Decorator</classname> - C'est la classe de base des décorateurs. Etendez cette classe + pour créer vos propres décorateurs. Elle fournit la même API que la classe Calendar qu'elle agrémente et renvoie + simplement les appels vers elle. Exemple; <programlisting role="php"> <![CDATA[ require_once 'Calendar/Decorator.php'; @@ -168,19 +162,19 @@ </para> </listitem> <listitem> - <para><classname>Calendar_Decorator_Uri</classname> - provides a decorator to help with generating URLs (for example next / prev URLs). + <para><classname>Calendar_Decorator_Uri</classname> - Fournit un décorateur permettant de générer des URLs (Par exemple prec. / suivant). </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Uri.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Uri.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Decorator_Textual</classname> - helps with obtaining textual month names and weekday names from a calendar object. + <para><classname>Calendar_Decorator_Textual</classname> - permet d'obtenir des mois et jours sous forme de textes à partir d'un objet calendar. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Textual.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Textual.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Decorator_Wrapper</classname> - is intended to help you add decorators to the children of the calendar object you are working with. It will wrap the children in the decorator you specify at the point <function>fetch</function> or <function>fetchAll</function> is called, after a build <function>build</function> call. + <para><classname>Calendar_Decorator_Wrapper</classname> - permet d'ajouter des décorateurs aux fils de l'objet Calendar que vous utilisez. Le fils sera englobé par le décorateur spécifié au moment de l'appel à <function>fetch</function> ou à <function>fetchAll</function>, après un appel à <function>build</function>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Wrapper.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Wrapper.php'; ]]></programlisting>.</para> </listitem> </itemizedlist> </para>
http://cvs.php.net/diff.php/peardoc/fr/package/datetime/calendar/intro-overview.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/fr/package/datetime/calendar/intro-overview.xml diff -u peardoc/fr/package/datetime/calendar/intro-overview.xml:1.1 peardoc/fr/package/datetime/calendar/intro-overview.xml:1.2 --- peardoc/fr/package/datetime/calendar/intro-overview.xml:1.1 Wed Mar 24 09:55:22 2004 +++ peardoc/fr/package/datetime/calendar/intro-overview.xml Wed Mar 31 13:53:22 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" ?> -<!-- $Id: intro-overview.xml,v 1.1 2004/03/24 14:55:22 didou Exp $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: partial --> +<!-- $Id: intro-overview.xml,v 1.2 2004/03/31 18:53:22 romain Exp $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: partial --> <refentry id="package.datetime.calendar.intro-overview"> <refnamediv> <refname>Tour d'horizon du package</refname> @@ -24,120 +24,114 @@ <para> <itemizedlist> <listitem> - <para><classname>Calendar_Year</classname> - represents a year and can build <classname>Calendar_Month</classname>, <classname>Calendar_Month_Weekdays</classname> and <classname>Calendar_Month_Weeks</classname> objects. + <para><classname>Calendar_Year</classname> - représente une année et peut contruire des objets <classname>Calendar_Month</classname>, <classname>Calendar_Month_Weekdays</classname> et <classname>Calendar_Month_Weeks</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Year.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Year.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Month</classname> - represents a month and can build <classname>Calendar_Day</classname> objects. + <para><classname>Calendar_Month</classname> - représente un mois et peut construire des objets <classname>Calendar_Day</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Month.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Month.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Day</classname> - represents a day and can build <classname>Calendar_Hour</classname> objects. + <para><classname>Calendar_Day</classname> - représente un jour et peut contstruire des objets <classname>Calendar_Hour</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Day.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Day.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Hour</classname> - represents a hour and can build <classname>Calendar_Minute</classname> objects. + <para><classname>Calendar_Hour</classname> - représente une heure et peut construire des objets <classname>Calendar_Minute</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Hour.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Hour.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Minute</classname> - represents a minute and can build <classname>Calendar_Second</classname> objects. + <para><classname>Calendar_Minute</classname> - représente une minute et peut construire des objets <classname>Calendar_Second</classname>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Minute.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Minute.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Second</classname> - represents a second but cannot build anything. + <para><classname>Calendar_Second</classname> - représente une seconde et ne peut construire aucun objet. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Second.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Second.php'; ]]></programlisting>.</para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.datetime.calendar.intro-overview.tabular"> - <title>Tabular Date Classes</title> - <para>Designed for building calendars in tabular format. All are subclasses of <classname>Calendar</classname> so provide the methods defined there.</para> + <title>Classes de Dates Tabulaires </title> + <para>Permet de construire des calendriers au format tabulaire. Ce sont toutes des sous classes de <classname>Calendar</classname>, elles disposent donc des mêmes méthodes.</para> <para> <itemizedlist> <listitem> - <para><classname>Calendar_Month_Weekdays</classname> - builds <classname>Calendar_Day</classname> objects setting the <function>isFirst</function>, <function>isLast</function> and <function>isEmpty</function> states, to display a month in tabular form. + <para><classname>Calendar_Month_Weekdays</classname> - construit des objets <classname>Calendar_Day</classname> en réglant les états <function>isFirst</function>, <function>isLast</function> et <function>isEmpty</function> afin d'afficher un mois sous forme tabulaire. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Month/Weekdays.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Month/Weekdays.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Month_Weeks</classname> - builds <classname>Calendar_Week</classname> objects, representing a month in terms of the tabular weeks in contains (see FAQ for what a week represents). + <para><classname>Calendar_Month_Weeks</classname> - construit des objets <classname>Calendar_Week</classname> en représentant un mois en fonction des semaines tabulaires qu'il contient (consultez la FAQ pour la représentation des semaines). </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Month/Weeks.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Month/Weeks.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Week</classname> - builds <classname>Calendar_Day</classname> objects, setting the <function>isEmpty</function> state if necessary and representing a tabular week in a month (i.e. you get 7 days from it). + <para><classname>Calendar_Week</classname> - construit des objets <classname>Calendar_Day</classname> en réglant l' état <function>isEmpty</function> si nécessaire et en représentant une semaine tabulaire dans un mois (elle renvoie 7 jours). </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Week.php'; ]]></programlisting>.</para> - </listitem> - <listitem> - <para><classname>Calendar_Week</classname> - builds <classname>Calendar_Day</classname> objects, setting the <function>isEmpty</function> state if necessary and representing a tabular week in a month (i.e. you get 7 days from it). - </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Week.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Week.php'; ]]></programlisting>.</para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.datetime.calendar.intro-overview.validation"> - <title>Validation Classes</title> - <para>Used to validate dates. <classname>Calendar</classname> provides the methods - <function>isValid</function> to perform a simple check on any date and - <function>getValidator</function> to return an instance of - <classname>Calendar_Validator</classname> for fine grained validation.</para> + <title>Classes de Validation</title> + <para>Permet de valider des dates. <classname>Calendar</classname> fournit les méthodes + <function>isValid</function> afin de faire une vérification simple sur n'importe quelle date + et <function>getValidator</function> qui renvoie une instance de + <classname>Calendar_Validator</classname> pour une validation plus fine.</para> <para> <itemizedlist> <listitem> - <para><classname>Calendar_Validator</classname> - is not instantiated by your code directly - (you need need specifically include / create it) but instead returned from the - <classname>Calendar</classname>::<function>getValidator</function> method you can call on - any subclass of <classname>Calendar</classname>. It is used to provide fine grained - validation of a date to find out exactly what's wrong with it (for simple validation just - call <function>isValid</function> on any Date object or Tabular Date object, to know if it - was created with valid values. + <para><classname>Calendar_Validator</classname> - n'est pas instancié automatiquement dans + votre code (vous devez inclure / le créer). Pour le créer utilisez la méthode + <classname>Calendar</classname>::<function>getValidator</function> que vous pouvez utiliser + sur n'importe quelle sous classe de <classname>Calendar</classname>. Cette méthode permet + d'avoir des informations de validité détaillées et ainsi de trouver la source de l'erreur + pour des objets de Date ou de Date Tabulaire. </para> </listitem> <listitem> - <para><classname>Calendar_Validation_Error</classname> - represents a validation error, - providing methods to determine what went wrong. Available methods are - <function>getUnit</function> (e.g. returns Year or Month), <function>getValue</function> - (the value it failed with), <function>getMessage</function> (the validation error message) - and <function>toString</function> which returns a combination of all the three preceding - methods. The default validation error messages are in English but stored in the constants - <constant>CALENDAR_VALUE_TOOSMALL</constant> and - <constant>CALENDAR_VALUE_TOOLARGE</constant> which you can redefine in your code. + <para><classname>Calendar_Validation_Error</classname> - représente une erreur de validation, + fournit des méthodes pour détermnier la source de l'erreur. Les méthodes disponibles sont + <function>getUnit</function> (renvoie Year ou Month), <function>getValue</function> + (la valeur de l'erreur), <function>getMessage</function> (le message d'erreur de validation) + et <function>toString</function> qui renvoie une combinaison des trois méthodes précédentes. + Les messages d'erreur de validation sont en Anglais par défaut. Il sont définis par les constantes + <constant>CALENDAR_VALUE_TOOSMALL</constant> et + <constant>CALENDAR_VALUE_TOOLARGE</constant> qui peuvent être redéfinies dans votre code. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.datetime.calendar.intro-overview.decorators"> - <title>Decorators</title> - <para>Provide a mechanism to add functionality to the main calendar objects (the subclasses of - <classname>Calendar</classname>) without needing to directly extend them (and risk overwriting - fields accidentally). When you create a decorator, you pass it's constructor an instance of an - existing calendar object. You can then make calls to the decorator in exactly the same way as you - make calls to the original calendar object. This allows you to "overwrite" calendar methods, add - new methods or even apply multiple decorators to the same calendar object. Decorators a typically - either "injected" (via selection or the <classname>Calendar_Decorator_Wrapper</classname> - decorator) into the loop where the calendar is rendered and / or to alter the output content - (e.g. convert a numeric month into a textual month: 1 => January).</para> - <para> - PEAR::Calendar provides some decorator implementations for you, to help with common tasks. These - are not designed to suit everyone and hence are provided as optional code for you to use as - needed (avoiding the performance cost associated with parsing code you're not using). + <title>Les Décorateurs</title> + <para>Fournit un mécanisme permettant d'ajouter des fonctionnalités aux principaux objets Calendar (les sous classes de + <classname>Calendar</classname>) sans avoir besoin de les étendre (et prendre le risque d'écraser des champs + accidentellement). Pour créer un décorateur, vous devez passer un objet Calendar au constructeur. + Vous pourrez alors faire des appels au décorateur au lieu de les faire sur l'objet d'origine. + Cela vous permettra de réécrire les méthodes de Calendar, ajouter de nouvelles méthodes ou même + appliquer des décorateurs multiples au même objet Calendar. Les décorateurs peuvent être injecté + (via une sélection ou le décorateur <classname>Calendar_Decorator_Wrapper</classname> ) + dans la boucle générant le calendrier afin de modifier son contenu + (pour par exemple convertir des valeurs numériques en textes : 1 -> janvier).</para> + <para> + PEAR::Calendar fournit des implémentations de décorateurs afin d'effectuer les tâches communes. Celles-ci + ne correspondront pas aux besoins de tous et sont fournies en tant que code optionnel + (afin de ne pas détériorer les performances si vous ne les utilisez pas). </para> <para> <itemizedlist> <listitem> - <para><classname>Calendar_Decorator</classname> - this is the base decorator class which you - should extend with your own. It provides the same API as the calendar object it is - decorating, and simply routes calls through to it. Example; + <para><classname>Calendar_Decorator</classname> - C'est la classe de base des décorateurs. Etendez cette classe + pour créer vos propres décorateurs. Elle fournit la même API que la classe Calendar qu'elle agrémente et renvoie + simplement les appels vers elle. Exemple; <programlisting role="php"> <![CDATA[ require_once 'Calendar/Decorator.php'; @@ -168,19 +162,19 @@ </para> </listitem> <listitem> - <para><classname>Calendar_Decorator_Uri</classname> - provides a decorator to help with generating URLs (for example next / prev URLs). + <para><classname>Calendar_Decorator_Uri</classname> - Fournit un décorateur permettant de générer des URLs (Par exemple prec. / suivant). </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Uri.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Uri.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Decorator_Textual</classname> - helps with obtaining textual month names and weekday names from a calendar object. + <para><classname>Calendar_Decorator_Textual</classname> - permet d'obtenir des mois et jours sous forme de textes à partir d'un objet calendar. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Textual.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Textual.php'; ]]></programlisting>.</para> </listitem> <listitem> - <para><classname>Calendar_Decorator_Wrapper</classname> - is intended to help you add decorators to the children of the calendar object you are working with. It will wrap the children in the decorator you specify at the point <function>fetch</function> or <function>fetchAll</function> is called, after a build <function>build</function> call. + <para><classname>Calendar_Decorator_Wrapper</classname> - permet d'ajouter des décorateurs aux fils de l'objet Calendar que vous utilisez. Le fils sera englobé par le décorateur spécifié au moment de l'appel à <function>fetch</function> ou à <function>fetchAll</function>, après un appel à <function>build</function>. </para> - <para>Include with <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Wrapper.php'; ]]></programlisting>.</para> + <para>Inclure avec <programlisting role="php"><![CDATA[ require_once 'Calendar/Decorator/Wrapper.php'; ]]></programlisting>.</para> </listitem> </itemizedlist> </para>