Convert MongoDB from set to book

php · Oct 23, 2024 · 8a8c0cf · 8a8c0cf
1 parent e4a97be
commit 8a8c0cf
Show file tree

Hide file tree

Showing 14 changed files with 64 additions and 63 deletions.
diff --git a/language-snippets.ent b/language-snippets.ent
@@ -399,12 +399,12 @@ xmlns="http://docbook.org/ns/docbook"><simpara>
 </simpara></warning>'>
 
 <!ENTITY warn.deprecated.feature-8-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
- Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 8.3.0. 
+ Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 8.3.0.
  Dépendre de cette fonctionnalité est fortement déconseillé.
 </simpara></warning>'>
 
 <!ENTITY warn.deprecated.function-8-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
- Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 8.3.0. 
+ Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 8.3.0.
  Dépendre de cette fonction est fortement déconseillé.
 </simpara></warning>'>
 
@@ -1778,7 +1778,7 @@ peuvent être utilisées pour gérer ces erreurs.</para>'>
   résultant.
  </para>
 </warning>'>
- 
+
 
 <!-- Dom Examples -->
 <!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">L&#39;exemple suivant
@@ -2733,7 +2733,7 @@ alphabétique.</para>'>
   <parameter>writer</parameter> attend une instance de <classname>XMLWriter</classname>
   désormais; auparavant, une <type>resource</type> était attendu.
  </entry>
-</row>'> 
+</row>'>
 
 <!-- SOAP notes -->
 <!ENTITY soap.wsdl.mode.only "<note xmlns='http://docbook.org/ns/docbook'><para>Cette fonction n'est disponible qu&#39;en mode WSDL.</para></note>">
@@ -2794,7 +2794,7 @@ avec libfann &gt;= 2.2.</para></note>'>
 
 <!ENTITY imagick.constant.available 'Cette constante n&#39;est disponible que si Imagick a été compilé avec ImageMagick version'>
 
-<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de Imagick 3.4.4. Dépendre de cette fonctionnalité est fortement déconseillé.</simpara></warning>'> 
+<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de Imagick 3.4.4. Dépendre de cette fonctionnalité est fortement déconseillé.</simpara></warning>'>
 
 <!-- Imagick default channel information -->
 <!ENTITY imagick.default.channel.info 'Par défaut, vaut <constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>. Reportez-vous à la liste des <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">constantes de canaux</link>'>
@@ -3864,7 +3864,7 @@ local: {
     </para>
     <note>
         <simpara>
-            Lors de l&#39;évaluation des critères de requête, MongoDB compare les type et les valeurs en fonction de leur propre <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">règles de comparaison pour les types BSON</link>, qui diffère des règles de <link linkend="types.comparisons">comparaison</link> et de <link linkend="language.types.type-juggling">manipulation des type</link> de PHP. Lors de  la correspondance d&#39;un type BSON spcécial, les critères de requête doivent utiliser la <link linkend="book.bson">classe BSON</link> (ex. : utiliser <classname>MongoDB\BSON\ObjectId</classname> pour correspondre à un <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
+            Lors de l&#39;évaluation des critères de requête, MongoDB compare les type et les valeurs en fonction de leur propre <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">règles de comparaison pour les types BSON</link>, qui diffère des règles de <link linkend="types.comparisons">comparaison</link> et de <link linkend="language.types.type-juggling">manipulation des type</link> de PHP. Lors de  la correspondance d&#39;un type BSON spcécial, les critères de requête doivent utiliser la <link linkend="mongodb.bson">classe BSON</link> (ex. : utiliser <classname>MongoDB\BSON\ObjectId</classname> pour correspondre à un <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
         </simpara>
     </note>
 </listitem>
@@ -4253,7 +4253,7 @@ a été définie de façon incorrecte pour l&#39;entrée fournie.
         Comme le spécificateur <literal>g</literal> mais utilise
         <literal>E</literal> et <literal>F</literal>. Disponible à partir de PHP 8.0.0.
        </entry>
-      </row> 
+      </row>
       <row>
        <entry><literal>o</literal></entry>
        <entry>
@@ -4397,8 +4397,8 @@ a été définie de façon incorrecte pour l&#39;entrée fournie.
  <para xmlns="http://docbook.org/ns/docbook">
   Antérieur à PHP 8.0.0, si <parameter>needle</parameter> n&#39;est pas une chaîne de caractères,
   elle est convertie en un entier et appliqué en tant que valeur ordinal d&#39;un caractère.
-  Ce comportement est obsolète à partir de PHP 7.3.0, et se fier à celui-ci 
-  est fortement déconseillé. En fonction du comportement attendu, 
+  Ce comportement est obsolète à partir de PHP 7.3.0, et se fier à celui-ci
+  est fortement déconseillé. En fonction du comportement attendu,
   <parameter>needle</parameter> doit être transtypé explicitement en une chaîne de caractère,
   ou un appel explicite à <function>chr</function> doit être exécuté.
  </para>
@@ -4714,7 +4714,7 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction a été
   <parameter>parser</parameter> attend une instance de <classname>XMLParser</classname>
   désormais; auparavent, une <type>resource</type> <literal>xml</literal> était attendue.
  </entry>
-</row>'> 
+</row>'>
 
 <!-- Migration Guide snippets -->
 <!ENTITY migration56.openssl.peer-verification '

diff --git a/reference/mongodb/architecture.xml b/reference/mongodb/architecture.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 22eb2f39973a06dd565e0030f173f8460d2f2811 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
-<book xml:id="mongodb.architecture" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<chapter xml:id="mongodb.architecture" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <titleabbrev>Architecture et fonctionnalités spéciales</titleabbrev>
  <title>Explications de l'architecture du pilote et des fonctionnalités spéciales</title>
 
- <article xml:id="mongodb.overview">
+ <section xml:id="mongodb.overview">
   <titleabbrev>Architecture</titleabbrev>
   <title>Aperçu de l'architecture</title>
 
@@ -23,7 +23,7 @@
      libmongocrypt. Le niveau intermédiaire est l'extension PHP MongoDB. Le
      niveau supérieur est le code utilisateur PHP et inclut la bibliothèque
      MongoDB PHP et des packages de plus haut niveau tels que les intégrations
-     de frameworks et les applications. 
+     de frameworks et les applications.
     </alt>
     <imageobject>
      <imagedata fileref="en/reference/mongodb/images/driver_arch.svg" width="625" depth="450" format="SVG" />
@@ -34,15 +34,15 @@
   <para>
    En haut de cette pile se trouve une
    <link xlink:href="&url.mongodb.library;">librairie PHP</link>,
-   qui distribue un 
+   qui distribue un
    <link xlink:href="https://packagist.org/packages/mongodb/mongodb">package Composer</link>.
    Cette librairie fournit une API cohérente avec d'autres
    <link xlink:href="&url.mongodb.drivers;">drivers</link>
-   MongoDB et implémente diverses 
+   MongoDB et implémente diverses
    <link xlink:href="&url.mongodb.specs;">specifications</link>
    croisées. Bien que l'extension puisse être utilisée directement, la librairie
    a un surcoût minimal et devrait être une dépendance commune pour la plupart
-   des applications construites avec MongoDB.   
+   des applications construites avec MongoDB.
   </para>
 
   <para>
@@ -89,9 +89,9 @@
     </tgroup>
    </table>
   </para>
- </article>
+ </section>
 
- <article xml:id="mongodb.connection-handling">
+ <section xml:id="mongodb.connection-handling">
   <titleabbrev>Connections</titleabbrev>
   <title>Gestion de la connection et de la persistence</title>
 
@@ -214,9 +214,9 @@ foreach ($managers as $manager) {
     utilise l'API des flux PHP.
    </para>
   </section>
- </article>
+ </section>
 
- <article xml:id="mongodb.persistence">
+ <section xml:id="mongodb.persistence">
   <titleabbrev>Persister des données</titleabbrev>
   <title>Sérialisation and déserialisation des variables PHP dans MongoDB</title>
 
@@ -560,7 +560,7 @@ class UpperClass implements MongoDB\BSON\Persistable
     impossible d'inférer le type BSON original. Par défaut, l'extension
     <code>mongodb</code> adresse cette préoccupation en s'assurant que les
     tableaux BSON et les documents BSON sont convertis en tableaux et objets PHP,
-    respectivement. 
+    respectivement.
    </para>
    <para>
     Pour les types composés, il existe trois types de données :
@@ -645,7 +645,7 @@ class UpperClass implements MongoDB\BSON\Persistable
              binaire, et que le sous-type de la valeur binaire est 0x80. Si
              une de ces trois conditions n'est pas remplie, la propriété
              __pclass n'existe pas et doit être traitée comme toute autre
-             propriété normale. 
+             propriété normale.
             </para>
            </footnote>
            devient un objet <type>stdClass</type>, avec chaque clé de document
@@ -977,8 +977,8 @@ function bsonUnserialize( array $map )
    </section>
   </section>
 
- </article>
-</book>
+ </section>
+</chapter>
 
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/reference/mongodb/set.xml → reference/mongodb/book.xml b/reference/mongodb/set.xml → reference/mongodb/book.xml
@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
-<set xml:id="set.mongodb" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<book xml:id="book.mongodb" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <?phpdoc extension-membership="pecl" ?>
  <title>L'extension MongoDB</title>
  <titleabbrev>MongoDB</titleabbrev>
 
@@ -16,7 +17,7 @@
     <link linkend="class.mongodb-driver-query">requêtes</link>,
     <link linkend="class.mongodb-driver-bulkwrite">écritures</link>,
     <link linkend="class.mongodb-driver-manager">gestion de connection</link>,
-    et <link linkend="book.bson">serialization BSON</link>.
+    et <link linkend="mongodb.bson">serialization BSON</link>.
    </simpara>
    <simpara>
     Les bibliothèques PHP côté utilisateur qui dépendent de cette extension
@@ -35,6 +36,7 @@
  </info>
 
   &reference.mongodb.setup;
+  &reference.mongodb.constants;
   &reference.mongodb.tutorial;
   &reference.mongodb.architecture;
   &reference.mongodb.security;
@@ -43,7 +45,7 @@
   &reference.mongodb.bson;
   &reference.mongodb.monitoring;
   &reference.mongodb.exceptions;
-</set>
+</book>
 
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/reference/mongodb/bson.xml b/reference/mongodb/bson.xml
@@ -3,7 +3,7 @@
 <!-- EN-Revision: dd9038795cefd9b08ce1453b770496cbf132782e Maintainer: girgias Status: ready -->
 <!-- Reviewed: yes -->
 
- <book xml:id="book.bson" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <part xml:id="mongodb.bson" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <?phpdoc extension-membership="pecl" ?>
   <title>Classes et fonctions BSON de MongoDB</title>
   <titleabbrev>MongoDB\BSON</titleabbrev>
@@ -46,5 +46,5 @@
   &reference.mongodb.bson.int64;
   &reference.mongodb.bson.symbol;
   &reference.mongodb.bson.undefined;
- </book>
+ </part>
 
diff --git a/reference/mongodb/configure.xml b/reference/mongodb/configure.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 8c84a7f1fd238b71d31f315cc52b8b7771401fdd Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
-<article xml:id="mongodb.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<section xml:id="mongodb.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
 
  <section xml:id="mongodb.installation.pecl">
@@ -31,7 +31,7 @@ $ sudo pecl install mongodb
   </para>
 
   <para>
-   Depuis la version 1.17.0 de l'extension, PECL demandera diverses options de 
+   Depuis la version 1.17.0 de l'extension, PECL demandera diverses options de
    <literal>configurations</literal>. Pour installer l'extension avec les options par défaut
    dans un script non interactif, une entrée vide peut être envoyée à
    <literal>pecl install</literal> en utilisant la commande <literal>yes</literal> :
@@ -59,9 +59,9 @@ $ sudo pecl install --configureoptions='with-mongodb-system-libs="yes" enable-mo
   <para>
    Par défaut l'installation de l'extension via PECL utilisera les versions incluses de
    <link xlink:href="&url.mongodb.libbson;">libbson</link>,
-   <link xlink:href="&url.mongodb.libmongoc;">libmongoc</link>, et 
+   <link xlink:href="&url.mongodb.libmongoc;">libmongoc</link>, et
    <link xlink:href="&url.mongodb.libmongocrypt;">libmongocrypt</link> et essayera automatiquement
-   de les configurer. 
+   de les configurer.
   </para>
 
   <note>
@@ -70,7 +70,7 @@ $ sudo pecl install --configureoptions='with-mongodb-system-libs="yes" enable-mo
     paquets de développement (par exemple <literal>libssl-dev</literal>) et
     <link xlink:href="&url.mongodb.wiki.pkg-config;">pkg-config</link> sont tous deux
     installés. Si cela ne résout pas le problème, envisagez d'utiliser le
-    processus          
+    processus
     <link linkend="mongodb.installation.manual">d'installation manuel</link>.
    </simpara>
   </note>
@@ -232,7 +232,7 @@ $ sudo make install
   <para>
    La dernière étape de construction, <command>make install</command>, indiquera où
    <filename>mongodb.so</filename> a été installé, similaire à :
-   <programlisting role="txt"> 
+   <programlisting role="txt">
 <![CDATA[
 Installing shared extensions:     /usr/lib/php/extensions/debug-non-zts-20220829/
 ]]>
@@ -269,7 +269,7 @@ extension=mongodb.so
   </para>
  </section>
 
-</article>
+</section>
 
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/mongodb/exceptions.xml b/reference/mongodb/exceptions.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 4083e8f9523a60390960c52a7ab810dc7b096d40 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
- <book xml:id="mongodb.exceptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <part xml:id="mongodb.exceptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <titleabbrev>MongoDB\Driver\Exception</titleabbrev>
   <title>Les classes d'exception</title>
 
@@ -66,4 +66,4 @@
    </itemizedlist>
   </article>
 
- </book>
+ </part>
diff --git a/reference/mongodb/ini.xml b/reference/mongodb/ini.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
-<article xml:id="mongodb.configuration" xmlns="http://docbook.org/ns/docbook">
+<section xml:id="mongodb.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
  &extension.runtime;
  <para>
@@ -74,7 +74,7 @@
     </varlistentry>
   </variablelist>
  </para>
-</article>
+</section>
 
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/reference/mongodb/mongodb.xml b/reference/mongodb/mongodb.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: dd9038795cefd9b08ce1453b770496cbf132782e Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
- <book xml:id="book.mongodb" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <part xml:id="mongodb.mongodb" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <?phpdoc extension-membership="pecl" ?>
   <title>Classes de l'extension MongoDB</title>
   <titleabbrev>MongoDB\Driver</titleabbrev>
@@ -29,4 +29,4 @@
   &reference.mongodb.mongodb.driver.writeconcernerror;
   &reference.mongodb.mongodb.driver.writeerror;
   &reference.mongodb.mongodb.driver.writeresult;
- </book>
+ </part>
diff --git a/reference/mongodb/monitoring.xml b/reference/mongodb/monitoring.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: b817c8855866acbb37c260cbc62235b8d2d88ea1 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
- <book xml:id="mongodb.monitoring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <part xml:id="mongodb.monitoring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Classes de surveillance et fonctions abonnées</title>
   <titleabbrev>MongoDB\Driver\Monitoring</titleabbrev>
 
@@ -28,4 +28,4 @@
   &reference.mongodb.mongodb.driver.monitoring.logsubscriber;
   &reference.mongodb.mongodb.driver.monitoring.sdamsubscriber;
   &reference.mongodb.mongodb.driver.monitoring.subscriber;
- </book>
+ </part>
diff --git a/reference/mongodb/security.xml b/reference/mongodb/security.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 4e0bf229045ff87d5f84469280bf0a6b195bfb8b Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
-<book xml:id="mongodb.security" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<chapter xml:id="mongodb.security" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Sécurité</title>
 
- <article xml:id="mongodb.security.request_injection">
+ <section xml:id="mongodb.security.request_injection">
   <title>Attaques par injection de requêtes</title>
   <para>
    Si vous passez des paramètres <literal>$_GET</literal> (ou <literal>$_POST</literal>)
@@ -45,9 +45,9 @@
    Voir <link xlink:href="&url.mongodb.dochub.security;">la documentation principale</link>
    pour plus d'informations sur les problèmes de type injection SQL avec MongoDB.
   </para>
- </article>
+ </section>
 
- <article xml:id="mongodb.security.script_injection">
+ <section xml:id="mongodb.security.script_injection">
   <title>Attaque par injection de scripts</title>
   <para>
    Si vous utilisez JavaScript, assurez-vous que toutes les variables qui
@@ -160,8 +160,8 @@ $r = $m->executeCommand( 'dramio', $cmd );
     xlink:href="&url.mongodb.docs;reference/command/eval/">commande eval</link>
     a été dépréciée depuis MongoDB 3.0, et devrait également être évitée.
   </para>
- </article>
-</book>
+ </section>
+</chapter>
 
 <!-- Keep this comment at the end of the file
 Local variables: