Changeset 833

Show
Ignore:
Timestamp:
12/04/07 23:58:32 (1 year ago)
Author:
gleu
Message:

Le fichier contrib du jour.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • traduc/trunk/manuel/isn.xml

    r803 r833  
    77 
    88 <para> 
    9   The <literal>isn</literal> module adds data types for the following  
    10   international-standard namespaces: EAN13, UPC, ISBN (books), ISMN (music),  
    11   and ISSN (serials). This module is inspired by Garrett A. Wollman's  
    12   isbn_issn code. 
     9  Le module <literal>isn</literal> ajoute des types de données pour les 
     10  espaces de noms suivants du standard international&nbsp;: EAN13, UPC, 
     11  ISBN (pour les livres), ISMN (pour la musique) et ISSN (pour les numéros 
     12  de série). Ce module est inspiré du code isbn_issn de Garrett A. Wollman. 
    1313 </para> 
    1414 <para> 
    15   This module validates, and automatically adds the correct  
    16   hyphenations to the numbers. Also, it supports the new ISBN-13  
    17   numbers to be used starting in January 2007. 
     15  Ce module valide et ajoute automatiquement les tirets corrects pour les 
     16  nombres. De plus, il support les nouveaux nombres ISBN-13 à utiliser 
     17  depuis janvier 2007. 
    1818 </para> 
    1919 
    2020 <para> 
    21   Premises: 
     21  Pour commencer&nbsp;: 
    2222 </para> 
    2323 
    2424 <orderedlist> 
    2525  <listitem> 
    26    <para>ISBN13, ISMN13, ISSN13 numbers are all EAN13 numbers</para> 
     26   <para>Les nombres ISBN13, ISMN13, ISSN13 sont tous des nombres EAN13</para> 
    2727  </listitem> 
    2828  <listitem> 
    29    <para>EAN13 numbers aren't always ISBN13, ISMN13 or ISSN13 (some are)</para> 
     29   <para>Les nombres EAN13 ne sont pas toujours ISBN13, ISMN13 ou ISSN13 (mais 
     30    certains le sont)</para> 
    3031  </listitem> 
    3132  <listitem> 
    32    <para>some ISBN13 numbers can be displayed as ISBN</para> 
     33   <para>Certains nombres ISBN13 peuvent être affichés en tant qu'ISBN</para> 
    3334  </listitem> 
    3435  <listitem> 
    35    <para>some ISMN13 numbers can be displayed as ISMN</para> 
     36   <para>Certains nombres ISMN13 peuvent être affichés en tant qu'ISMN</para> 
    3637  </listitem> 
    3738  <listitem> 
    38    <para>some ISSN13 numbers can be displayed as ISSN</para> 
     39   <para>Certains nombres ISSN13 peuvent être affichés en tant qu'ISSN</para> 
    3940  </listitem> 
    4041  <listitem> 
    41    <para>all UPC, ISBN, ISMN and ISSN can be represented as EAN13 numbers</para> 
     42   <para>Tous les nombres UPC, ISBN, ISMN et ISSN peuvent être représentés 
     43    sous la forme de nombres EAN13</para> 
    4244  </listitem> 
    4345 </orderedlist> 
    …… 
    4547 <note> 
    4648  <para> 
    47    All types are internally represented as 64 bit integers,  
    48    and internally all are consistently interchangeable. 
     49   Tous les types sont représentés en interne sous la forme d'entiers de 64 
     50   bits, et sont interchangeables. 
    4951  </para> 
    5052 </note> 
    5153 <note> 
    5254  <para> 
    53    We have two operator classes (for btree and for hash) so each data type 
    54    can be indexed for faster access. 
     55   Nous avons deux classes d'opérateur (pour les btree et pour les hash), 
     56   donc chaque type de données peut être indexé pour un accÚs rapide. 
    5557  </para> 
    5658 </note> 
    5759 
    5860 <sect2> 
    59   <title>Data types</title> 
     61  <title>Types de données</title> 
    6062   
    6163  <para> 
    62    We have the following data types: 
     64   Nous avons les types de données suivants&nbsp;: 
    6365  </para> 
    6466 
    6567  <table> 
    66    <title>Data types</title> 
     68   <title>Types de données</title> 
    6769   <tgroup cols="2"> 
    6870    <thead> 
    6971     <row> 
    70       <entry><para>Data type</para></entry> 
     72      <entry><para>Type de données</para></entry> 
    7173      <entry><para>Description</para></entry> 
    7274     </row> 
    …… 
    7779      <entry> 
    7880       <para> 
    79         European Article Numbers. This type will always show the EAN13-display  
    80         format. Te output function for this is <literal>ean13_out()</literal> 
     81        Numéros européens d'article (<foreignphrase>European Article 
     82        Numbers</foreignphrase>. Ce type affichera toujours le format EAN13. 
     83        La fonction d'affichage est <literal>ean13_out()</literal> 
    8184       </para> 
    8285      </entry> 
    …… 
    8790      <entry> 
    8891       <para> 
    89         For International Standard Book Numbers to be displayed in  
    90           the new EAN13-display format. 
     92        Standard international pour les numéros de livre 
     93        (<foreignphrase>International Standard Book Numbers</foreignphrase>) 
     94        à afficher dans le nouveau format EAN13. 
    9195       </para> 
    9296      </entry> 
    …… 
    97101      <entry> 
    98102       <para> 
    99         For International Standard Music Numbers to be displayed in 
    100         the new EAN13-display format. 
     103        Standard international des numéros de musique 
     104        (<foreignphrase>International Standard Music Numbers</freignphrase> 
     105        à afficher dans le nouveau format EAN13. 
    101106       </para> 
    102107      </entry> 
    …… 
    106111      <entry> 
    107112       <para> 
    108         For International Standard Serial Numbers to be displayed in the new  
    109         EAN13-display format. 
     113        Standard international des numéros de série 
     114        (<foreignphrase>International Standard Serial Numbers</foreignphrase>) 
     115        à afficher dans le nouveau format EAN13. 
    110116       </para> 
    111117      </entry> 
    …… 
    115121      <entry> 
    116122       <para> 
    117         For International Standard Book Numbers to be displayed in the current  
    118         short-display format. 
     123        Standard internal pour les numéros de livres 
     124        (<foreignphrase>International Standard Book Numbers</foreignphrase>) 
     125        à afficher dans le format court. 
    119126       </para> 
    120127      </entry> 
    …… 
    124131      <entry> 
    125132       <para> 
    126         For International Standard Music Numbers to be displayed in the  
    127         current short-display format. 
     133        Standard international des numéros de musique 
     134        (<foreignphrase>International Standard Music Numbers</freignphrase> 
     135        à afficher dans le format court. 
    128136       </para> 
    129137      </entry> 
    …… 
    133141      <entry> 
    134142       <para> 
    135         For International Standard Serial Numbers to be displayed in the  
    136         current short-display format. These types will display the short  
    137         version of the ISxN (ISxN 10) whenever it's possible, and it will  
    138         show ISxN 13 when it's impossible to show the short version.  The  
    139         output function to do this is <literal>isn_out()</literal> 
     143        Standard international des numéros de série 
     144        (<foreignphrase>International Standard Serial Numbers</foreignphrase>) 
     145        à afficher dans le format court. Ces types affichent la version 
     146        courte d'ISxN (ISxN 10) à chaque fois que c'est possible, et 
     147        affichera la version ISxN 13 dans le cas contraire. La fonction 
     148        d'affichage est <literal>isn_out()</literal> 
    140149       </para> 
    141150      </entry> 
    …… 
    145154      <entry> 
    146155       <para> 
    147         For Universal Product Codes. UPC numbers are a subset of the EAN13  
    148         numbers (they are basically EAN13 without the first '0' digit.) 
    149         The output function to do this is also <literal>isn_out()</literal> 
     156        Codes de produit universels (<foreignphrase>Universal Product 
     157        Codes</foreignphrase>). Les codes UPC sont un sous-ensemble des codes 
     158        EAN13 (ils sont basiquement EAN13 sans le premier chiffre 0). La 
     159        fonction d'affichage est aussi <literal>isn_out()</literal> 
    150160       </para> 
    151161      </entry> 
    …… 
    157167  <note> 
    158168   <para> 
    159     <literal>EAN13</literal>, <literal>ISBN13</literal>,  
    160     <literal>ISMN13</literal> and <literal>ISSN13</literal> types will always  
    161     display the long version of the ISxN (EAN13). The output function to do  
    162     this is <literal>ean13_out()</literal>. 
     169    Les types <literal>EAN13</literal>, <literal>ISBN13</literal>,  
     170    <literal>ISMN13</literal> et <literal>ISSN13</literal> afficheront 
     171    toujours la version longue d'ISxN (EAN13). La fonction d'affichage pour 
     172    ce faire est <literal>ean13_out()</literal>. 
    163173   </para> 
    164174   <para> 
    165     The need for these types is just for displaying in different ways the same  
    166     data: <literal>ISBN13</literal> is actually the same as  
    167     <literal>ISBN</literal>, <literal>ISMN13=ISMN</literal> and  
     175    Ces types sont nécessaires pour afficher la même donnée de différentes 
     176    façons&nbsp;: <literal>ISBN13</literal> est identique à 
     177    <literal>ISBN</literal>, <literal>ISMN13=ISMN</literal> et 
    168178    <literal>ISSN13=ISSN</literal>. 
    169179   </para> 
    …… 
    172182 
    173183 <sect2> 
    174   <title>Input functions</title> 
     184  <title>Fonctions en entrée</title> 
    175185  
    176186  <para> 
    177    We have the following input functions: 
     187   Voici la liste des fonctions en entrée&nbsp;: 
    178188  </para> 
    179189 
    180190  <table> 
    181    <title>Input functions</title> 
     191   <title>Fonctions en entrée</title> 
    182192   <tgroup cols="2"> 
    183193    <thead> 
    184194     <row> 
    185       <entry>Function</entry> 
     195      <entry>Fonction</entry> 
    186196      <entry>Description</entry> 
    187197     </row> 
    …… 
    192202      <entry> 
    193203       <para> 
    194         To take a string and return an EAN13. 
     204        Prend une chaîne en argument et renvoie un EAN13. 
    195205       </para> 
    196206      </entry> 
    …… 
    201211      <entry> 
    202212       <para> 
    203         To take a string and return valid ISBN or ISBN13 numbers. 
     213        Prend une chaîne en argument et renvoie un nombre ISBN ou 
     214        ISBN13 valide. 
    204215       </para> 
    205216      </entry> 
    …… 
    210221      <entry> 
    211222       <para> 
    212         To take a string and return valid ISMN or ISMN13 numbers. 
     223        Prend une chaîne en argument et renvoie un nombre ISMN ou 
     224        ISMN13 valide. 
    213225       </para> 
    214226      </entry> 
    …… 
    219231      <entry> 
    220232       <para> 
    221         To take a string and return valid ISSN or ISSN13 numbers. 
     233        Prend une chaîne en argument et renvoie un nombre ISSN ou 
     234        ISSN13 valide. 
    222235       </para> 
    223236      </entry> 
    …… 
    227240      <entry> 
    228241       <para> 
    229         To take a string and return an UPC codes. 
     242        Prend une chaîne en argument et renvoie un code UPC. 
    230243       </para> 
    231244      </entry> 
    …… 
    237250 
    238251 <sect2> 
    239   <title>Casts</title> 
    240  
    241   <para> 
    242    We are able to cast from: 
     252  <title>Conversions</title> 
     253 
     254  <para> 
     255   Nous sommes capables de convertir ces types&nbsp;: 
    243256  </para> 
    244257  <itemizedlist> 
    …… 
    297310 
    298311 <sect2> 
    299   <title>C API</title> 
    300   <para> 
    301    The C API is implemented as: 
     312  <title>API C</title> 
     313  <para> 
     314   L'API C est implémentée ainsi&nbsp;: 
    302315  </para> 
    303316  <programlisting> 
    …… 
    312325 
    313326  <para> 
    314    On success: 
     327   En cas de succÚs&nbsp;: 
    315328  </para> 
    316329  <itemizedlist> 
    317330   <listitem> 
    318331    <para> 
    319      <literal>isn_out()</literal> takes any of our types and returns a string containing  
    320   the shortes possible representation of the number. 
    321     </para> 
    322    </listitem> 
    323    <listitem> 
    324     <para> 
    325      <literal>ean13_out()</literal> takes any of our types and returns the  
    326   EAN13 (long) representation of the number. 
    327     </para> 
    328    </listitem> 
    329    <listitem> 
    330     <para> 
    331      <literal>ean13_in()</literal> takes a string and return a EAN13. Which, as stated in (2)  
    332   could or could not be any of our types, but it certainly is an EAN13  
    333   number. Only if the string is a valid EAN13 number, otherwise it fails. 
    334     </para> 
    335    </listitem> 
    336    <listitem> 
    337     <para> 
    338      <literal>isbn_in()</literal> takes a string and return an ISBN/ISBN13. Only if the string 
    339   is really a ISBN/ISBN13, otherwise it fails. 
    340     </para> 
    341    </listitem> 
    342    <listitem> 
    343     <para> 
    344      <literal>ismn_in()</literal> takes a string and return an ISMN/ISMN13. Only if the string 
    345   is really a ISMN/ISMN13, otherwise it fails. 
    346     </para> 
    347    </listitem> 
    348    <listitem> 
    349     <para> 
    350      <literal>issn_in()</literal> takes a string and return an ISSN/ISSN13. Only if the string 
    351   is really a ISSN/ISSN13, otherwise it fails. 
    352     </para> 
    353    </listitem> 
    354    <listitem> 
    355     <para> 
    356      <literal>upc_in()</literal> takes a string and return an UPC. Only if the string is 
    357   really a UPC, otherwise it fails. 
     332     <literal>isn_out()</literal> prend un de nos types et renvoie une chaîne 
     333     contenant la représentation la plus petite du nombre. 
     334    </para> 
     335   </listitem> 
     336   <listitem> 
     337    <para> 
     338     <literal>ean13_out()</literal> prend un de nos types et renvoie la 
     339     représentation EAN13 (donc longue ) du nombre. 
     340    </para> 
     341   </listitem> 
     342   <listitem> 
     343    <para> 
     344     <literal>ean13_in()</literal> prend une chaîne et renvoie un EAN13. 
     345     Qui, comme indiqué dans (2), pourrait être ou pas un de nos types 
     346     mais c'est à coup sûr un nombre EAN13. Ça ne fonctionne que si la 
     347     chaîne est un nombre EAN13 valide. 
     348    </para> 
     349   </listitem> 
     350   <listitem> 
     351    <para> 
     352     <literal>isbn_in()</literal> prend une chaîne et renvoie un ISBN/ISBN13. 
     353     Ã‡a ne fonctionne que si la chaîne est un ISBN/ISBN13. 
     354    </para> 
     355   </listitem> 
     356   <listitem> 
     357    <para> 
     358     <literal>ismn_in()</literal> prend une chaîne et renvoie un ISMN/ISMN13. 
     359     Ã‡a ne fonctionne que si la chaîne est un ISMN/ISMN13. 
     360    </para> 
     361   </listitem> 
     362   <listitem> 
     363    <para> 
     364     <literal>issn_in()</literal> prend une chaîne et renvoie un ISSN/ISSN13. 
     365     Ã‡a ne fonctionne que si la chaîne est un ISSN/ISSN13. 
     366    </para> 
     367   </listitem> 
     368   <listitem> 
     369    <para> 
     370     <literal>upc_in()</literal> prend une chaîne et renvoie un code UPC. 
     371     Ã‡a ne fonctionne que si la chaîne est un code UPC. 
    358372    </para> 
    359373   </listitem> 
    …… 
    361375 
    362376  <para> 
    363    (on failure, the functions 'ereport' the error) 
    364   </para> 
    365  </sect2> 
    366  
    367  <sect2> 
    368   <title>Testing functions</title> 
     377   (en cas d'échec, les fonctions renvoient une erreur via ereport) 
     378  </para> 
     379 </sect2> 
     380 
     381 <sect2> 
     382  <title>Fonctions de test</title> 
    369383  <table> 
    370    <title>Testing functions</title> 
     384   <title>Fonctions de test</title> 
    371385   <tgroup cols="2"> 
    372386    <thead> 
    373387     <row> 
    374       <entry><para>Function</para></entry> 
     388      <entry><para>Fonction</para></entry> 
    375389      <entry><para>Description</para></entry> 
    376390     </row> 
    …… 
    379393     <row> 
    380394      <entry><para><literal>isn_weak(boolean)</literal></para></entry> 
    381       <entry><para>Sets the weak input mode.</para></entry> 
     395      <entry><para>Configure le mode de saisie faible.</para></entry> 
    382396     </row> 
    383397     <row> 
    384398      <entry><para><literal>isn_weak()</literal></para></entry> 
    385       <entry><para>Gets the current status of the weak mode.</para></entry> 
     399      <entry><para>RécupÚre le statut actuel du mode faible.</para></entry> 
    386400     </row> 
    387401     <row> 
    388402      <entry><para><literal>make_valid()</literal></para></entry> 
    389       <entry><para>Validates an invalid number (deleting the invalid flag).</para></entry> 
     403      <entry><para>Valide un nombre invalide (en supprimant l'information 
     404       d'invalidité).</para></entry> 
    390405     </row> 
    391406     <row> 
    392407      <entry><para><literal>is_valid()</literal></para></entry> 
    393       <entry><para>Checks for the invalid flag prsence.</para></entry> 
     408      <entry><para>Vérifie la présence de l'information 
     409       d'invalidité.</para></entry> 
    394410     </row> 
    395411    </tbody> 
    …… 
    398414 
    399415  <para> 
    400    <literal>Weak</literal> mode is used to be able to insert invalid data to 
    401    a table. Invalid as in the check digit being wrong, not missing numbers. 
     416   Le mode faible (<literal>weak</literal>) est utilisé pour pouvoir insérer 
     417   des données invalides dans la table. Par invalide, nous entendons des 
     418   nombres dont le chiffre de vérification est erroné. 
    402419  </para> 
    403420  <para> 
    …… 
    413430  </para> 
    414431  <para> 
    415    When you insert invalid numbers in a table using the weak mode, the number 
    416    will be inserted with the corrected check digit, but it will be flagged  
    417    with an exclamation mark ('!') at the end (i.e. 0-11-000322-5!) 
    418   </para> 
    419   <para> 
    420    You can also force the insertion of invalid numbers even not in the weak mode, 
    421    appending the '!' character at the end of the number. 
    422   </para> 
    423  </sect2> 
    424  
    425  <sect2> 
    426   <title>Examples</title> 
     432   Quand vous insérez des nombres invalides dans une table en utilisant le 
     433   mode faible, le nombre sera inséré avec le chiffre de vérification 
     434   modifié mais il sera enregistré avec un point d'exclamation à la fin 
     435   (par exemple 0-11-000322-5!). 
     436  </para> 
     437  <para> 
     438   Vous pouvez aussi forcer l'insertion de nombres invalides, même sans le 
     439   mode faible, en ajoutant le caractÚre <literal>!</literal> à la fin du 
     440   nombre. 
     441  </para> 
     442 </sect2> 
     443 
     444 <sect2> 
     445  <title>Exemples</title> 
    427446  <programlisting> 
    428447--Using the types directly: 
    …… 
    431450SELECT issn('1436-4522'); 
    432451 
    433 --Casting types: 
    434 -- note that you can only cast from ean13 to other type when the casted  
    435 -- number would be valid in the realm of the casted type;  
    436 -- thus, the following will NOT work: select isbn(ean13('0220356483481'));  
    437 -- but these will:  
     452--Conversions: 
     453-- notez que vous pouvez seulement convertir d'ean13 vers les autres types 
     454-- quand le nombre converti est valide pour ce type ; 
     455-- du coup, ceci ne fonctionnera pas : select isbn(ean13('0220356483481'));  
     456-- contrairement à ceci : 
    438457SELECT upc(ean13('0220356483481'));  
    439458SELECT ean13(upc('220356483481'));  
    440459 
    441 --Create a table with a single column to hold ISBN numbers: 
     460--Crée une table avec une seule colonne contenant des numéros ISBN : 
    442461CREATE TABLE test ( id isbn ); 
    443462INSERT INTO test VALUES('9780393040029'); 
    444463 
    445 --Automatically calculating check digits (observe the '?'): 
     464--Calcule automatiquement les nombres de vérification (notez le '?'): 
    446465INSERT INTO test VALUES('220500896?'); 
    447466INSERT INTO test VALUES('978055215372?'); 
    …… 
    450469SELECT ismn('979047213542?'); 
    451470 
    452 --Using the weak mode: 
     471--En utilisant le mode faible : 
    453472SELECT isn_weak(true); 
    454473INSERT INTO test VALUES('978-0-11-000533-4'); 
    …… 
    467486 
    468487 <sect2> 
    469   <title>Bibliography</title> 
    470   <para> 
    471    The information to implement this module was collected through 
    472    several sites, including: 
     488  <title>Bibliographie</title> 
     489  <para> 
     490   Les informations utilisées pour la création de ce module ont été récupérées 
     491   sur différents sites&nbsp;: 
    473492  </para> 
    474493  <programlisting> 
    …… 
    479498  </programlisting> 
    480499  <para> 
    481    the prefixes used for hyphenation where also compiled from: 
     500   Les préfixes utilisés pour les tirets ont aussi été tirés de&nbsp;: 
    482501  </para> 
    483502  <programlisting> 
    …… 
    487506  </programlisting> 
    488507  <para> 
    489    Care was taken during the creation of the algorithms and they 
    490    were meticulously verified against the suggested algorithms 
    491    in the official ISBN, ISMN, ISSN User Manuals. 
     508   Une attention toute particuliÚre a été prise lors de la création des 
     509   algorithmes et ils ont été vérifiés méticuleusement avec les algorithmes 
     510   suggérés dans les manuels utilisateur officiels pour ISBN, ISMN, ISSN. 
    492511  </para> 
    493512 </sect2> 
    494513  
    495514 <sect2> 
    496   <title>Author</title> 
    497   <para> 
    498    Germán Méndez Bravo (Kronuz), 2004 - 2006 
     515  <title>Auteur</title> 
     516  <para> 
     517   Germán Méndez Bravo (Kronuz), 2004 - 2006 
    499518  </para> 
    500519 </sect2>