cvs: peardoc /fr/package/datetime/calendar intro-overview.xml

From: 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&eacute;sente une ann&eacute;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&eacute;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&eacute;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&eacute;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&eacute;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&eacute;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&ecirc;mes m&eacute;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&eacute;glant les &eacute;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&eacute;sentant un mois en fonction des semaines tabulaires qu'il contient (consultez la FAQ pour la repr&eacute;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&eacute;glant l' &eacute;tat <function>isEmpty</function> si n&eacute;cessaire et en repr&eacute;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&eacute;thodes + <function>isValid</function> afin de faire une v&eacute;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&eacute; automatiquement dans + votre code (vous devez inclure / le cr&eacute;er). Pour le cr&eacute;er utilisez la m&eacute;thode + <classname>Calendar</classname>::<function>getValidator</function> que vous pouvez utiliser + sur n'importe quelle sous classe de <classname>Calendar</classname>. Cette m&eacute;thode permet + d'avoir des informations de validit&eacute; d&eacute;taill&eacute;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&eacute;sente une erreur de validation, + fournit des m&eacute;thodes pour d&eacute;termnier la source de l'erreur. Les m&eacute;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&eacute;thodes pr&eacute;c&eacute;dentes. + Les messages d'erreur de validation sont en Anglais par d&eacute;faut. Il sont d&eacute;finis par les constantes + <constant>CALENDAR_VALUE_TOOSMALL</constant> et + <constant>CALENDAR_VALUE_TOOLARGE</constant> qui peuvent &ecirc;tre red&eacute;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&eacute;corateurs</title> + <para>Fournit un m&eacute;canisme permettant d'ajouter des fonctionnalit&eacute;s aux principaux objets Calendar (les sous classes de + <classname>Calendar</classname>) sans avoir besoin de les &eacute;tendre (et prendre le risque d'&eacute;craser des champs + accidentellement). Pour cr&eacute;er un d&eacute;corateur, vous devez passer un objet Calendar au constructeur. + Vous pourrez alors faire des appels au d&eacute;corateur au lieu de les faire sur l'objet d'origine. + Cela vous permettra de r&eacute;&eacute;crire les m&eacute;thodes de Calendar, ajouter de nouvelles m&eacute;thodes ou m&ecirc;me + appliquer des d&eacute;corateurs multiples au m&ecirc;me objet Calendar. Les d&eacute;corateurs peuvent &ecirc;tre inject&eacute; + (via une s&eacute;lection ou le d&eacute;corateur <classname>Calendar_Decorator_Wrapper</classname> ) + dans la boucle g&eacute;n&eacute;rant le calendrier afin de modifier son contenu + (pour par exemple convertir des valeurs num&eacute;riques en textes : 1 -> janvier).</para> + <para> + PEAR::Calendar fournit des impl&eacute;mentations de d&eacute;corateurs afin d'effectuer les t&acirc;ches communes. Celles-ci + ne correspondront pas aux besoins de tous et sont fournies en tant que code optionnel + (afin de ne pas d&eacute;t&eacute;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&eacute;corateurs. Etendez cette classe + pour cr&eacute;er vos propres d&eacute;corateurs. Elle fournit la m&ecirc;me API que la classe Calendar qu'elle agr&eacute;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&eacute;corateur permettant de g&eacute;n&eacute;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 &agrave; 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&eacute;corateurs aux fils de l'objet Calendar que vous utilisez. Le fils sera englob&eacute; par le d&eacute;corateur sp&eacute;cifi&eacute; au moment de l'appel &agrave; <function>fetch</function> ou &agrave; <function>fetchAll</function>, apr&egrave;s un appel &agrave; <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>
« previous php.pear.doc (#3165) next »