Changeset 242

Timestamp:

05/07/06 18:21:18 (3 years ago)

Author:

gleu

Message:

"make installation" crée la version standalone du document d'installation.
Pour cela, nous utilisons un paramètre particulier, standalone. Avec yes, il s'agit d'un mode standalone
alors qu'avec no, il s'agit du livre complet.

Location:

traduc/trunk/sgml

Files:

• Makefile (modified) (3 diffs)
• installation.xml (modified) (9 diffs)
• regress.xml (modified) (2 diffs)
• standalone-install.xml (modified) (1 diff)
• stylesheets/pg-nochunks.xsl (modified) (4 diffs)

traduc/trunk/sgml/Makefile

@@ -7 +7 @@
 html:
         xsltproc --xinclude --nonet -stringparam profile.condition html \
+                -stringparam  profile.attribute  "standalone" -stringparam  profile.value  "no" \
                 -stringparam chunk.quietly $(CHUNK_QUIET) \
                 -stringparam base.dir $(BASEDIR)/ \
@@ -34 +35 @@
 pdf:
         xsltproc --xinclude --nonet --stringparam profile.condition pdf \
+                -stringparam  profile.attribute  "standalone" -stringparam  profile.value  "no" \
                 --output $(BASEDIR)/pg-pdf.xml stylesheets/pg-profile.xsl postgres.xml
         xsltproc --nonet --output $(BASEDIR)/pg-pdf.fo stylesheets/pg-pdf.xsl \
@@ -54 +56 @@
         xmllint --noout --nonet --xinclude --postvalid postgres.xml
 
+installation:
+        xsltproc --xinclude --nonet -stringparam profile.condition html \
+                --stringparam  profile.attribute  "standalone" --stringparam  profile.value  "yes" \
+                --output $(BASEDIR)/standalone-install.html \
+                stylesheets/pg-nochunks.xsl standalone-install.xml
+
+        tidy -config tidy.conf $(BASEDIR)/standalone-install.html || true
+
+        sed -i -e "s@text/html@application/xhtml+xml@g"  \
+          $(BASEDIR)/standalone-install.html
+

traduc/trunk/sgml/installation.xml

@@ -3 +3 @@
 
 <chapter id="installation">
- <title>Procédure d'installation</title>
+ <title>Procédure d'installation<phrase standalone="yes"> de
+   <productname>PostgreSQL</productname></phrase></title>
 
  <indexterm zone="installation">
@@ -10 +11 @@
 
  <para>
-  Ce chapitre décrit l'installation de
+  Ce <phrase standalone="yes">document</phrase><phrase
+  standalone="no">chapitre</phrase> décrit l'installation de
   <productname>PostgreSQL</productname> à partir du code source (si vous
-  installé une distribution préparée, tels qu'un paquetage RPM ou Debian, vous
-  pouvez ignorer ce chapitre et lire à la place les instructions du
+  installez une distribution préparée, tels qu'un paquetage RPM ou Debian, vous
+  pouvez ignorer ce <phrase standalone="yes">document</phrase><phrase
+  standalone="no">chapitre</phrase> et lire à la place les instructions du
   mainteneur du paquetage).
  </para>
@@ -33 +36 @@
 /usr/local/pgsql/bin/createdb test
 /usr/local/pgsql/bin/psql test</synopsis>
-   Le reste du chapitre est la version longue.
+   Le reste du <phrase standalone="yes">document</phrase><phrase
+   standalone="no">chapitre</phrase> est la version longue.
   </para>
  </sect1>
@@ -150 +154 @@
       (<application>psql</application>) en utilisant d'autres environnements de
       développement sous <productname>Windows</productname>. Pour des détails, voir
-      le <xref linkend="install-win32"/>.
+      le <phrase standalone="yes">le chapitre «Installation sur
+      <productname>Windows</productname> du seul client » de la
+      documentation</phrase><phrase standalone="no"><xref
+      linkend="install-win32"/></phrase>.
      </para>
     </listitem>
@@ -319 +326 @@
  </sect1>
 
- <sect1 id="install-getsource">
+ <sect1 id="install-getsource" standalone="no">
   <title>Obtenir les sources</title>
 
@@ -450 +457 @@
   <para>
    Des informations supplémentaires apparaissent dans
-   la <xref linkend="migration"/> que vous êtes encouragés
-   à lire dans tous les cas.
+   la <phrase standalone="yes">documentation</phrase>
+   <phrase standalone="no"><xref linkend="migration"/></phrase>
+   que vous êtes encouragés à lire dans tous les cas.
   </para>
  </sect1>
@@ -856 +864 @@
          Ceci réduit le nombre de valeurs représentatives mais garantie une
          précision à la microseconde sur toute l'échelle de valeurs (voir
-         la <xref linkend="datatype-datetime"/>
+         la <phrase standalone="yes">la documentation sur les types de données
+         date et heure</phrase><phrase standalone="no"><xref
+         linkend="datatype-datetime"/></phrase>
          pour plus d'informations). Notez aussi que le code de datetime au
          format entier est plus récent que celui au format en virgule flottante
@@ -1011 +1021 @@
     (cela ne fonctionne pas en tant que root&nbsp;; faites-le en tant
     qu'utilisateur sans droits).
-    Le <xref linkend="regress"/> contient
+    <phrase standalone="yes">Le fichier <filename>src/test/regress/README</filename>
+    et la documentation contiennent</phrase><phrase standalone="no">Le <xref
+    linkend="regress"/> contient</phrase>
     des détails sur l'interprétation des résultats de ces tests. Vous pouvez
     les répéter autant de fois que vous le voulez en utilisant la même
@@ -1261 +1273 @@
    </para>
   </sect2>
+ </sect1>
+
+ <sect1 id="install-getting-started">
+  <title>Démarrer</title>
+
+  <para>
+   La suite est un résumé rapide de la façon de faire fonctionner
+   <productname>PostgreSQL</productname> une fois l'installation terminée. La
+   documentation principale contient plus d'informations.
+  </para>
+
+  <procedure>
+   <step>
+    <para>
+     Créer un compte utilisateur pour le serveur <productname>PostgreSQL</productname>.
+     C'est cet utilisateur qui fera démarrer le serveur. Pour un usage
+     en production, vous devez créer un compte sans droits
+     (<quote>postgres</quote> est habituellement utilisé). Si vous n'avez pas les
+     accès superutilisateur ou si vous voulez juste regarder, votre propre 
+     compte utilisateur est suffisant. Mais, utiliser le compte superutilisateur
+     pour démarrer le serveur est risqué (au point de vue sécurité) et ne
+     fonctionnera pas.
+<screen><userinput>adduser postgres</userinput></screen>
+    </para>
+   </step>
+
+   <step>
+    <para>
+     Faire l'installation de la base de données avec la commande
+     <command>initdb</command>. Pour exécuter <command>initdb</command>, vous devez être
+     connecté sur votre serveur avec le compte <productname>PostgreSQL</productname>.
+     Cela ne fonctionnera pas avec le compte superutilisateur.
+<screen>root# <userinput>mkdir /usr/local/pgsql/data</userinput>
+root# <userinput>chown postgres /usr/local/pgsql/data</userinput>
+root# <userinput>su - postgres</userinput>
+postgres$ <userinput>/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data</userinput></screen>
+    </para>
+
+    <para>
+     L'option <option>-D</option> spécifie le répertoire où les données seront
+     stockées. Vous pouvez utiliser le chemin que vous voulez, il n'a pas à
+     être sous le répertoire de l'installation. Avant de lancer
+     <command>initdb</command>, assurez-vous que le compte serveur peut écrire dans ce
+     répertoire (ou le créer s'il n'existe pas), comme c'est montré ici.
+    </para>
+   </step>
+
+   <step>
+    <para>
+     L'étape précédente vous a indiqué comment démarrer le serveur de base.
+     Maintenant, faites-le. La commande doit ressembler à
+<programlisting>/usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data</programlisting>
+     Cela démarrera le serveur en avant-plan. Pour le mettre en arrière plan
+     faites quelque chose comme
+<programlisting>nohup /usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data \
+    &lt;/dev/null &gt;&gt;server.log 2&gt;&amp;1 &lt;/dev/null &amp;</programlisting>
+    </para>
+
+    <para>
+     Pour arrêter le serveur fonctionnant en arrière-plan, vous pouvez saisir
+<programlisting>kill `cat /usr/local/pgsql/data/postmaster.pid`</programlisting>
+    </para>
+
+    <para>
+     Dans le but d'autoriser les connexions TCP/IP (plutôt que de n'utiliser
+     que les sockets Unix) il vous faut passer l'option <option>-i</option> à
+     <filename>postmaster</filename>.
+    </para>
+   </step>
+
+   <step>
+    <para>
+     Créer une base de données&nbsp;:
+<screen><userinput>createdb testdb</userinput></screen>
+     Ensuite, entrez
+<screen><userinput>psql testdb</userinput></screen>
+     pour vous connecter à la base. À l'invite, vous pouvez saisir des
+     commandes SQL et commencer l'expérimentation.
+    </para>
+   </step>
+  </procedure>
+ </sect1>
+
+ <sect1 id="install-whatnow">
+  <title>Et maintenant&nbsp;?</title>
+
+  <para>
+   <itemizedlist>
+    <listitem>
+     <para>
+      La distribution de <productname>PostgreSQL</productname> comprend un 
+      document compréhensible que vous devriez lire de temps en temps.
+      Après l'installation, le document peut être lu en faisant pointer
+      votre navigateur internet sur
+      <filename>/usr/local/pgsql/doc/html/index.html</filename>, excepté si vous avez
+      changé les répertoires d'installation.
+     </para>
+
+     <para>
+      Le premier chapitre de la documentation est un tutoriel qui devrait être
+      votre première lecture si vous êtes nouveau dans le monde des bases
+      de données <acronym>SQL</acronym>. Si vous êtes familier avec les concepts des
+      bases de données, alors vous voudrez commencer avec la partie
+      administration du serveur qui contient des informations sur la façon de
+      mettre en place le serveur de base, les bases des utilisateurs et
+      l'authentification.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Normalement, vous voudrez faire en sorte que le serveur de base démarre
+      automatiquement au boot de la machine. Pour ce faire, quelques
+      suggestions se trouvent dans la documentation.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Faire les tests de régression sur le serveur installé (en utilisant
+      <command>gmake installcheck</command>). Si vous ne l'avez pas fait auparavant,
+      vous devriez définitivement le faire maintenant. C'est aussi expliqué
+      dans la documentation.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Par défaut, <productname>PostgreSQL</productname> est configuré pour fonctionner sur
+      un matériel mimimal. Ceci lui permet de fonctionner sur pratiquement
+      toutes les configurations matérielles. Néanmoins, la configuration par
+      défaut n'est pas conçue pour des performances optimales. Pour disposer des
+      meilleures performances, plusieurs paramètres serveurs doivent être
+      ajustés, les deux plus communs étant <varname>shared_buffers</varname> et
+      <varname>work_mem</varname>.
+      Les autres paramètres mentionnés dans la documentation affectent aussi les
+      performances.
+     </para>
+    </listitem>
+   </itemizedlist>
+  </para>
+
  </sect1>
 

traduc/trunk/sgml/regress.xml

@@ -117 +117 @@
 
   <para>
-   Pour lancer les tests après l'installation (voir le <xref
-   linkend="installation"/>), initialisez un espace de données et lancez le
-   serveur comme expliqué dans le <xref linkend="runtime"/>, puis lancez
+   Pour lancer les tests après l'installation<phrase standalone="no"> (voir le <xref
+   linkend="installation"/>)</phrase>, initialisez un espace de données et lancez le
+   serveur<phrase standalone="no"> comme expliqué dans le <xref linkend="runtime"/></phrase>,
+   puis lancez
 <screen>gmake installcheck</screen>
 ou pour un test parallèle
@@ -301 +302 @@
      infinite_recurse()</literal>, cela signifie que la limite de la plateforme pour
      la taille de pile du processus est plus petite que le paramètre
-     <xref linkend="guc-max-stack-depth"/> ne l'indique. Ceci est corrigeable
+     <phrase standalone="yes"><literal>max_stack_depth</literal></phrase>
+     <phrase standalone="no"><xref linkend="guc-max-stack-depth"/></phrase>
+     ne l'indique. Ceci est corrigeable
      en exécutant le postmaster avec une limite pour la taille de pile plus
      importante (4&nbsp;Mo est recommandé avec la valeur par défaut de

traduc/trunk/sgml/standalone-install.xml

@@ -1 @@
-<!-- $Header: /var/lib/cvs/pgsql-fr/sgml/standalone-install.xml,v 1.3 2004/03/27 16:36:17 guillaume Exp $ -->
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+$Header: /var/lib/cvs/pgsql-fr/sgml/postgres.xml,v 1.15 2005/10/02 12:42:21 guillaume Exp $
+-->
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
 
-<!--
-This file helps in generating the INSTALL text file that lives in the
-top level directory of the distribution. The exact process is like
-this:
+<!ENTITY nbsp " ">
+<!ENTITY eacute "é">
+<!ENTITY egrave "è">
+<!ENTITY agrave "à">
+<!ENTITY uuml "ü">
+<!ENTITY ouml "ö">
+<!ENTITY laquo "« ">
+<!ENTITY raquo " »">
+<!ENTITY copy "(c)">
+<!ENTITY mdash " -- ">
+<!ENTITY oelig "oe">
+<!ENTITY pi "pi">
 
-1. Paste together with installation.xml
+<!ENTITY % version SYSTEM "version.xml">
+%version;
+<!ENTITY installation SYSTEM "installation.xml">
 
-2. Process with jade to HTML (use -V nochunks)
+]>
 
-3. Remove "Chapter 1" heading
+<article id="postgres" lang="fr">
+ <title>Documentation PostgreSQL &version;</title>
+ <articleinfo>
+  <corpauthor>The PostgreSQL Global Development Group</corpauthor>
+ </articleinfo>
 
-4. Save as text file in Netscape
+ &installation;
 
-5. Put in place of old INSTALL file
-
-Running 'make INSTALL' in the doc/src/sgml directory will do 1 through
-3 for you.
--->
-
-<!doctype chapter PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-
-<!entity % version SYSTEM "version.xml">
-%version;
-
-<!--
-The standalone version has some portions that are different from the
-version that is integrated into the full documentation set, in
-particular as regards links. The following are essentially SGML's
-equivalent of C's #ifdef and friends. The other end of this is in
-installation.xml.
--->
-
- <!entity % standalone-ignore  "IGNORE">
- <!entity % standalone-include "INCLUDE">
-
-<!--
-When you're building the full documentation set, you want to flip the
-IGNORE and INCLUDE.
--->
-]>
+</article>

traduc/trunk/sgml/stylesheets/pg-nochunks.xsl

@@ -6 +6 @@
 
     <!-- We use XHTML -->
-  <xsl:import href="http://docbook.sourceforge.net/release/xsl/1.69.1/xhtml/profile-docbook.xsl"/>
+  <xsl:import href="/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/xhtml/profile-docbook.xsl"/>
 
     <!-- Fix encoding issues with default UTF-8 output of the xhtml stylesheet -->
@@ -12 +12 @@
 
    <!-- Including our others customized templates -->
-  <xsl:include href="xhtml/lfs-index.xsl"/>
-  <xsl:include href="xhtml/lfs-mixed.xsl"/>
-  <xsl:include href="xhtml/lfs-sections.xsl"/>
-  <xsl:include href="xhtml/lfs-toc.xsl"/>
-  <xsl:include href="xhtml/lfs-xref.xsl"/>
+  <xsl:include href="xhtml/pg-index.xsl"/>
+  <xsl:include href="xhtml/pg-mixed.xsl"/>
+  <xsl:include href="xhtml/pg-sections.xsl"/>
+  <xsl:include href="xhtml/pg-toc.xsl"/>
+  <xsl:include href="xhtml/pg-xref.xsl"/>
 
     <!-- Dropping some unwanted style attributes -->
@@ -39 +39 @@
   </xsl:template>
 
-    <!-- To drop the remainig dot when title is empty (from lfs-titles.xsl)-->
+    <!-- To drop the remainig dot when title is empty (from pg-titles.xsl)-->
   <xsl:template name="sect2.titlepage">
     <xsl:choose>
@@ -59 +59 @@
 
     <!-- Added the role param for proper punctuation in xref calls
-            (from lfs-titles.xsl). -->
+            (from pg-titles.xsl). -->
   <xsl:template match="*" mode="insert.title.markup">
     <xsl:param name="purpose"/>