You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sis.apache.org by de...@apache.org on 2012/09/28 05:00:28 UTC

svn commit: r1391285 - in /sis/trunk: ./ src/main/docbook/ src/main/docbook/fr/ src/site/apt/ src/site/resources/book/

Author: desruisseaux
Date: Fri Sep 28 03:00:27 2012
New Revision: 1391285

URL: http://svn.apache.org/viewvc?rev=1391285&view=rev
Log:
Initial commit of the developer guide.

Added:
    sis/trunk/src/main/docbook/
    sis/trunk/src/main/docbook/README.txt   (with props)
    sis/trunk/src/main/docbook/book.entities   (with props)
    sis/trunk/src/main/docbook/book.xsl   (with props)
    sis/trunk/src/main/docbook/fr/
    sis/trunk/src/main/docbook/fr.xml   (with props)
    sis/trunk/src/main/docbook/fr/geoapi.xml   (with props)
    sis/trunk/src/main/docbook/fr/introduction.xml   (with props)
    sis/trunk/src/main/docbook/fr/standards.xml   (with props)
    sis/trunk/src/site/resources/book/
    sis/trunk/src/site/resources/book/book.css   (with props)
Modified:
    sis/trunk/pom.xml
    sis/trunk/src/site/apt/index.apt

Modified: sis/trunk/pom.xml
URL: http://svn.apache.org/viewvc/sis/trunk/pom.xml?rev=1391285&r1=1391284&r2=1391285&view=diff
==============================================================================
--- sis/trunk/pom.xml (original)
+++ sis/trunk/pom.xml Fri Sep 28 03:00:27 2012
@@ -348,6 +348,47 @@ Apache SIS is a toolkit for describing l
         </configuration>
       </plugin>
 
+      <!-- Build XHTML pages from the DocBook files
+           See src/main/docbook/README.txt -->
+      <plugin>
+        <groupId>com.agilejava.docbkx</groupId>
+        <artifactId>docbkx-maven-plugin</artifactId>
+        <version>2.0.14</version>
+        <inherited>false</inherited>
+        <dependencies>
+          <dependency> <!-- XHTML generation -->
+            <groupId>net.sf.docbook</groupId>
+            <artifactId>docbook-xml</artifactId>
+            <version>5.0-all</version>
+            <classifier>resources</classifier>
+            <type>zip</type>
+            <scope>runtime</scope>
+          </dependency>
+          <dependency> <!-- Syntax highlighting -->
+            <groupId>net.sf.xslthl</groupId>
+            <artifactId>xslthl</artifactId>
+            <version>2.0.2</version>
+            <scope>runtime</scope>
+          </dependency>
+        </dependencies>
+        <configuration>
+          <sourceDirectory>${basedir}/src/main/docbook</sourceDirectory>
+          <targetDirectory>${basedir}/target/site/book</targetDirectory>
+          <xhtmlCustomization>src/main/docbook/book.xsl</xhtmlCustomization>
+          <xincludeSupported>true</xincludeSupported>
+          <htmlStylesheet>book.css</htmlStylesheet>
+          <highlightSource>true</highlightSource>
+        </configuration>
+        <executions>
+          <execution>
+            <goals>
+              <goal>generate-xhtml</goal>
+            </goals>
+            <phase>pre-site</phase>
+          </execution>
+        </executions>
+      </plugin>
+
       <!-- Create web site -->
       <plugin>
         <artifactId>maven-site-plugin</artifactId>

Added: sis/trunk/src/main/docbook/README.txt
URL: http://svn.apache.org/viewvc/sis/trunk/src/main/docbook/README.txt?rev=1391285&view=auto
==============================================================================
--- sis/trunk/src/main/docbook/README.txt (added)
+++ sis/trunk/src/main/docbook/README.txt Fri Sep 28 03:00:27 2012
@@ -0,0 +1,19 @@
+This is the root directory of the developer guide in DocBook format.
+A documentation about the DocBook format is available on-line there:
+
+    http://www.docbook.org/tdg5/en/html
+
+Direct link to a frequently used chapter:
+
+    http://www.docbook.org/tdg5/en/html/ch02.html#s.inline
+
+XHTML pages are generated automatically from the docbook files when
+Maven build the web site. But it is also possible to generate only
+the document (which is much faster than generating the whole site)
+by executing the following command-line from the SIS project root:
+
+   touch src/main/docbook/fr.xml
+   mvn docbkx:generate-xhtml --non-recursive
+   ln src/site/resources/book/book.css target/site/book/
+
+The result will be placed in the target/site/book directory.

Propchange: sis/trunk/src/main/docbook/README.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: sis/trunk/src/main/docbook/README.txt
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: sis/trunk/src/main/docbook/book.entities
URL: http://svn.apache.org/viewvc/sis/trunk/src/main/docbook/book.entities?rev=1391285&view=auto
==============================================================================
--- sis/trunk/src/main/docbook/book.entities (added)
+++ sis/trunk/src/main/docbook/book.entities Fri Sep 28 03:00:27 2012
@@ -0,0 +1,5 @@
+<!ENTITY geoapi-version "3.0.0">
+<!ENTITY geoapi-release "3.0.0">
+<!ENTITY sis-release    "0.3-snapshot">
+<!ENTITY gml-version    "3.3">
+<!ENTITY geoapi-javadoc "http://www.geoapi.org/3.0/javadoc">

Propchange: sis/trunk/src/main/docbook/book.entities
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: sis/trunk/src/main/docbook/book.entities
------------------------------------------------------------------------------
    svn:mime-type = text/plain

Added: sis/trunk/src/main/docbook/book.xsl
URL: http://svn.apache.org/viewvc/sis/trunk/src/main/docbook/book.xsl?rev=1391285&view=auto
==============================================================================
--- sis/trunk/src/main/docbook/book.xsl (added)
+++ sis/trunk/src/main/docbook/book.xsl Fri Sep 28 03:00:27 2012
@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- ============================================================
+     Docbook customization
+
+     This file solves the issue of docbook using the <h2> elements
+     both for chapter and for the first level of sections heading.
+     ============================================================= -->
+<xsl:stylesheet xmlns        = "http://www.w3.org/1999/xhtml"
+                xmlns:xsl    = "http://www.w3.org/1999/XSL/Transform"
+                xmlns:d      = "http://docbook.org/ns/docbook"
+                xmlns:db     = "http://docbook.org/ns/docbook"
+                xmlns:ng     = "http://docbook.org/docbook-ng"
+                xmlns:exsl   = "http://exslt.org/common"
+                xmlns:exslt  = "http://exslt.org/common"
+                xmlns:xslthl = "http://xslthl.sf.net"
+                exclude-result-prefixes="d db ng exsl exslt xslthl" version="1.0">
+
+  <!-- Symbolic URN specific to docbkx-maven-plugin -->
+  <xsl:import href="urn:docbkx:stylesheet/docbook.xsl"/>
+  <xsl:import href="urn:docbkx:stylesheet/highlight.xsl"/>
+
+  <!--
+       Following is copied from "http://docbook.sourceforge.net/release/xsl/current/xhtml/component.xsl".
+       Only the lines identified by a comment have been modified.  This file is used only for building
+       the web site and is not included in the SIS distributions.
+  -->
+  <xsl:template name="component.title">
+    <xsl:param name="node" select="."/>
+    <xsl:variable name="level">
+      <xsl:choose>
+        <xsl:when test="ancestor::section">
+          <xsl:value-of select="count(ancestor::section)+1"/>
+        </xsl:when>
+        <xsl:when test="ancestor::sect5">6</xsl:when>
+        <xsl:when test="ancestor::sect4">5</xsl:when>
+        <xsl:when test="ancestor::sect3">4</xsl:when>
+        <xsl:when test="ancestor::sect2">3</xsl:when>
+        <xsl:when test="ancestor::sect1">2</xsl:when>
+        <xsl:when test="ancestor::sect0">1</xsl:when>   <!-- Added -->
+        <xsl:otherwise>0</xsl:otherwise>  <!-- Was 1, changed to 0 -->
+      </xsl:choose>
+    </xsl:variable>
+    <xsl:element name="h{$level+1}" namespace="http://www.w3.org/1999/xhtml">
+      <xsl:attribute name="class">title</xsl:attribute>
+      <xsl:if test="$generate.id.attributes = 0">
+        <xsl:call-template name="anchor">
+	  <xsl:with-param name="node" select="$node"/>
+          <xsl:with-param name="conditional" select="0"/>
+        </xsl:call-template>
+      </xsl:if>
+      <xsl:apply-templates select="$node" mode="object.title.markup">
+        <xsl:with-param name="allow-anchors" select="1"/>
+      </xsl:apply-templates>
+    </xsl:element>
+  </xsl:template>
+
+
+  <!--
+       Syntax highlighting partially copied from the "docbook/xhtml-1_1/highlight.xsl" file
+       in the "net/sf/docbook/docbook-xsl/docbook-xsl-ns-resources.zip" archive, then edited.
+  -->
+  <xsl:template match="xslthl:string" mode="xslthl">
+    <span class="hl-string">
+      <xsl:apply-templates mode="xslthl"/>
+    </span>
+  </xsl:template>
+  <xsl:template match="xslthl:annotation" mode="xslthl">
+    <span class="hl-annotation">
+      <xsl:apply-templates mode="xslthl"/>
+    </span>
+  </xsl:template>
+  <xsl:template match="xslthl:doccomment|xslthl:doctype" mode="xslthl">
+    <span class="hl-doccomment">
+      <xsl:apply-templates mode="xslthl"/>
+    </span>
+  </xsl:template>
+
+
+  <!--
+       Map "OGC", "GeoAPI" and "SIS" roles to CSS styles
+       for <classname>, <function> and <literal> elements.
+  -->
+  <xsl:template match="d:classname[@role = 'OGC']"    mode="class.value"> <xsl:value-of select="'OGC'"   /> </xsl:template>
+  <xsl:template match="d:classname[@role = 'GeoAPI']" mode="class.value"> <xsl:value-of select="'GeoAPI'"/> </xsl:template>
+  <xsl:template match="d:classname[@role = 'SIS']"    mode="class.value"> <xsl:value-of select="'SIS'"   /> </xsl:template>
+  <xsl:template match= "d:function[@role = 'OGC']"    mode="class.value"> <xsl:value-of select="'OGC'"   /> </xsl:template>
+  <xsl:template match= "d:function[@role = 'GeoAPI']" mode="class.value"> <xsl:value-of select="'GeoAPI'"/> </xsl:template>
+  <xsl:template match= "d:function[@role = 'SIS']"    mode="class.value"> <xsl:value-of select="'SIS'"   /> </xsl:template>
+  <xsl:template match=  "d:literal[@role = 'GeoAPI']" mode="class.value"> <xsl:value-of select="'GeoAPI'"/> </xsl:template>
+  <xsl:template match=  "d:literal[@role = 'SIS']"    mode="class.value"> <xsl:value-of select="'SIS'"   /> </xsl:template>
+
+</xsl:stylesheet>

Propchange: sis/trunk/src/main/docbook/book.xsl
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: sis/trunk/src/main/docbook/book.xsl
------------------------------------------------------------------------------
    svn:mime-type = text/xsl

Added: sis/trunk/src/main/docbook/fr.xml
URL: http://svn.apache.org/viewvc/sis/trunk/src/main/docbook/fr.xml?rev=1391285&view=auto
==============================================================================
--- sis/trunk/src/main/docbook/fr.xml (added)
+++ sis/trunk/src/main/docbook/fr.xml Fri Sep 28 03:00:27 2012
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE book [
+  <!ENTITY % book.entities SYSTEM "book.entities">
+  %book.entities;
+]>
+<book xmlns="http://docbook.org/ns/docbook" version="5.0"
+      xmlns:xi    = "http://www.w3.org/2001/XInclude"
+      xmlns:xlink = "http://www.w3.org/1999/xlink">
+
+  <info>
+    <title>Introduction à Apache SIS</title>
+    <orgname class="informal">Apache SIS</orgname>
+    <author><personname>
+      <firstname>Martin</firstname>
+      <surname>Desruisseaux</surname>
+    </personname></author>
+    <abstract><para>
+      Introduction aux standards internationaux utilisées en information géographique,
+      et à l’approche choisie pour les implémenter dans la bibliothèque
+      <link xlink:href="http://incubator.apache.org/sis">Apache SIS</link> &sis-release;.
+      Ce document couvre les outils de développement, structures, conventions et
+      principales classes Java.
+    </para></abstract>
+    <keywordset>
+      <keyword>Apache SIS</keyword> <keyword>GeoAPI</keyword>
+      <keyword>OGC</keyword> <keyword>geospatial</keyword>
+    </keywordset>
+  </info>
+
+  <xi:include href="fr/introduction.xml"/>
+  <xi:include href="fr/standards.xml"/>
+  <xi:include href="fr/geoapi.xml"/>
+
+</book>

Propchange: sis/trunk/src/main/docbook/fr.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: sis/trunk/src/main/docbook/fr.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: sis/trunk/src/main/docbook/fr/geoapi.xml
URL: http://svn.apache.org/viewvc/sis/trunk/src/main/docbook/fr/geoapi.xml?rev=1391285&view=auto
==============================================================================
--- sis/trunk/src/main/docbook/fr/geoapi.xml (added)
+++ sis/trunk/src/main/docbook/fr/geoapi.xml Fri Sep 28 03:00:27 2012
@@ -0,0 +1,471 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book [
+  <!ENTITY % book.entities SYSTEM "../book.entities">
+  %book.entities;
+]>
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0"
+      xmlns:xlink = "http://www.w3.org/1999/xlink">
+
+<title>GeoAPI</title>
+  <para>
+    Le projet <link xlink:href="http://www.geoapi.org">GeoAPI</link> offre un ensemble d’interfaces Java pour les applications géo-spatiales.
+    Dans une séries de paquets <literal role="GeoAPI">org.opengis.*</literal>, GeoAPI &geoapi-release; définit des structures représentant des méta-données,
+    des systèmes de référence des coordonnées, ainsi que des opérations effectuant des projections cartographiques.
+    Dans une partie qui n’est pas encore standardisée — dénommée <foreignphrase>pending</foreignphrase> — GeoAPI définit des structures
+    représentant des images géo-référencées, des géométries, des filtres pouvant s’appliquer à des requêtes, et d’autres fonctionnalités.
+    Ces interfaces suivent de très près les spécifications de l’<acronym>OGC</acronym>, tout en les interprétant et en les adaptant
+    de manière à répondre aux attentes des développeurs Java — par exemple en se conformant aux conventions de nommage.
+    Ces interfaces bénéficient à la fois aux applications clientes et aux bibliothèques:
+  </para>
+
+  <itemizedlist>
+    <listitem><para>
+      Les développeurs des applications clientes bénéficient d’une plus grande base de connaissances disponible sur internet
+      (due aux nombreuses publications en lien avec les standards de l’OGC), ainsi que d’une interopérabilité accrue.
+      L’interopérabilité est facilitée par une meilleure séparation entre les applications qui <emphasis>appellent</emphasis> les fonctions de GeoAPI,
+      et les bibliothèques qui <emphasis>implémentent</emphasis> GeoAPI. Il s’agit d’une séparation similaire à celle qu’offrent les interfaces
+      <link xlink:href="http://docs.oracle.com/javase/7/docs/technotes/guides/jdbc/"><acronym>JDBC</acronym></link>
+      (<foreignphrase>Java Database Connectivity</foreignphrase>) du Java standard.
+      En utilisant l’<acronym>API</acronym> des interfaces, les développeurs peuvent faire abstraction de l’implémentation sous-jacente.
+      Par exemple ils peuvent effectuer des projections cartographiques à l’aide des bibliothèques
+      <link xlink:href="http://www.geoapi.org/geoapi-proj4/index.html">Proj.4</link> ou Apache SIS,
+      sans changer leurs programmes lorsqu’ils changent de bibliothèque.
+    </para></listitem>
+    <listitem><para>
+      Les développeurs des bibliothèques héritent de l’expertise des auteurs des spécifications, via les modèles que représentent les interfaces.
+      GeoAPI fournit aussi un cadre dans lequel les développeurs peuvent implémenter en priorité les fonctionnalité qui leurs sont le plus nécessaires,
+      tout en ayant des points où raccrocher les développements futurs.
+      Par exemple les clients peuvent appeler une fonction de GeoAPI même si elle n’est pas encore supportée par la bibliothèque,
+      quitte à obtenir une valeur nulle en attendant qu’une nouvelle version de la bibliothèque retourne une valeur intéressante.
+    </para></listitem>
+  </itemizedlist>
+
+<section>
+  <title>Historique</title>
+  <para>
+    En 2001, le consortium <foreignphrase>Open GIS</foreignphrase> (l’ancien nom du consortium <foreignphrase>Open Geospatial</foreignphrase>) publia la spécification d’implémentation
+    <link xlink:href="http://www.opengeospatial.org/standards/ct"><acronym>OGC</acronym> 01-009: <foreignphrase>Coordinate Transformation Services</foreignphrase></link>.
+    Cette spécification, élaborée par <foreignphrase>Computer Aided Development Corporation</foreignphrase> (<acronym>Cadcorp</acronym>), était accompagnée d’interfaces
+    <acronym>COM</acronym>, <acronym>CORBA</acronym> et Java. À cette époque, la vague des services web n’avait pas encore éclipsé les interfaces de programmation classiques.
+    Les interfaces de l’<acronym>OGC</acronym> anticipaient tout de même un monde connecté en réseau,
+    mais misaient plutôt — dans le cas du Java — sur la technologie <acronym>RMI</acronym> (<foreignphrase>Remote Method Invocation</foreignphrase>).
+    Bien que le projet GeoAPI n’existait pas encore, nous désignons rétrospectivement ces interfaces historiques sous le nom de
+    « <link xlink:href="http://www.geoapi.org/0.1/index.html">GeoAPI 0.1</link> ».
+    Ces interfaces utilisaient déjà le nom de paquet <literal role="GeoAPI">org.opengis</literal>, qui sera adopté par GeoAPI.
+  </para>
+  <para>
+    En 2002, des développeurs de projets libres ont lancé un <link xlink:href="http://web.archive.org/web/20030509104308/http://digitalearth.org/story/2002/10/10/55046/206">appel
+    à la création d’un <acronym>API</acronym> géo-spatial</link>. La proposition initiale suscita l’intérêt d’au moins cinq projets libres.
+    Le projet fut créé sur <link xlink:href="http://sourceforge.net/projects/geoapi/">SourceForge</link>,
+    qui héberge depuis lors le code source dans un <link xlink:href="http://www.geoapi.org/source-repository.html">dépôt Subversion</link>.
+    Le projet pris le nom de « GeoAPI » à ce moment là, et utilisa les interfaces de la spécification <acronym>OGC</acronym> 01-009 comme point de départ.
+  </para>
+  <para>
+    Quelques mois plus tard, l’<acronym>OGC</acronym> lança le projet
+    <link xlink:href="http://www.opengeospatial.org/standards/go"><acronym>GO-1</acronym>: <foreignphrase>Geographic Objects</foreignphrase></link>,
+    qui poursuivait des buts similaires à ceux de GeoAPI. Entre-temps, l’OGC avait abandonné certaines de leur spécifications en faveur des normes <acronym>ISO</acronym>.
+    GeoAPI et <acronym>GO-1</acronym> ont joint leurs efforts pour une refonte des interfaces de GeoAPI en les basant sur ces nouvelles normes ISO.
+    La première mouture, <link xlink:href="http://www.geoapi.org/1.0/index.html">GeoAPI 1.0</link>, a servit de point de départ
+    aux premières ébauches de la spécification <acronym>OGC</acronym> 03-064 du groupe de travail <acronym>GO-1</acronym>.
+    La version finale de cette spécification est devenue un standard <acronym>OGC</acronym> en 2005, et
+    <link xlink:href="http://www.geoapi.org/2.0/index.html">GeoAPI 2.0</link> a été publiée à cette occasion.
+  </para>
+  <para>
+    Le projet <acronym>GO-1</acronym> était porté essentiellement par une compagnie nommée <foreignphrase>Polexis</foreignphrase>.
+    Son rachat par <foreignphrase>Sys Technology</foreignphrase> et le changement de priorité des nouveaux propriétaires
+    ont causé l’arrêt des travaux de <acronym>GO-1</acronym>, et par ricochet un ralentissement des développements de GeoAPI.
+    Afin de reprendre les développements, un nouveau groupe de travail « GeoAPI 3.0 » a été créé à l’<acronym>OGC</acronym>.
+    Ce groupe a réduit les ambitions par rapport à GeoAPI 2.0 en se concentrant sur les interfaces les plus stables,
+    et en plaçant les autres — notamment les géométries — dans un module nommé « <link xlink:href="http://www.geoapi.org/geoapi-pending/index.html">pending</link> »,
+    pour considérations futures. <link xlink:href="http://www.geoapi.org/3.0/index.html">GeoAPI 3.0</link> est devenu un
+    <link xlink:href="http://www.opengeospatial.org/standards/geoapi">standard <acronym>OGC</acronym></link> en 2011.
+    Cette version a été la première à être déployée dans le <link xlink:href="http://search.maven.org/#search|ga|1|geoapi">dépôt central de Maven</link>.
+  </para>
+</section>
+
+<section>
+  <title>Des spécifications aux interfaces</title>
+  <para>
+    Les standards de l’<acronym>OGC</acronym> étant définis par des moyens bien éprouvés en génie logiciel,
+    il est possible de générer automatiquement des interfaces Java à l’aide d’outils relativement répandus.
+    Une des approches les plus utilisées est de transformer les <link xlink:href="http://schemas.opengis.net/gml/&gml-version;/">schémas <acronym>XSD</acronym></link>
+    en interfaces Java à l’aide de l’utilitaire en ligne de commande <command>xjc</command>.
+    Cet utilitaire étant fournit avec la plupart des distributions du Java
+    (il fait partie des outils de <link xlink:href="http://jaxb.java.net"><acronym>JAXB</acronym></link>),
+    cette approche est choisie par plusieurs projets que l’on trouve sur internet.
+    D’autres approches utilisent des outils intégrés à l’environnement de développement Eclipse, ou
+    prennent comme point de départ les schémas <acronym>UML</acronym> plutôt que <acronym>XSD</acronym>.
+  </para>
+  <para>
+    Une approche similaire avait été tentée dans les débuts du projet GeoAPI, mais a été rapidement abandonnée.
+    Nous avons privilégié une approche manuelle pour les raisons suivantes:
+  </para>
+
+  <itemizedlist>
+    <listitem><para>
+      Certains schémas <acronym>XSD</acronym> sont beaucoup plus verbeux que les schémas <acronym>UML</acronym> d’origines.
+      Une conversion à partir des schémas <acronym>XSD</acronym> introduit, au moins dans le cas des méta-données, près du
+      double du nombre d’interfaces réellement définies par le standard, sans que cela n’apporte de nouvelles fonctionnalités.
+      Une conversion à partir des schémas <acronym>UML</acronym> évite ce problème, mais les outils capable d’effectuer cette
+      opération sont plus rares.
+      </para>
+      <informalexample><para>
+        <emphasis role="bold">Exemple:</emphasis>
+        Les schémas <acronym>XSD</acronym> des méta-données insèrent
+        un élément <classname role="OGC">&lt;gmd:CI_Citation&gt;</classname> à l’intérieur de <function role="OGC">&lt;gmd:citation&gt;</function>,
+        un élément <classname role="OGC">&lt;gmd:CI_OnlineResource&gt;</classname> à l’intérieur de <function role="OGC">&lt;gmd:onlineResource&gt;</function>,
+        et ainsi de suite pour la centaine de classes définies dans le standard ISO 19115.
+        Cette redondance n’est absolument pas nécessaire à un programme Java.
+      </para></informalexample>
+    </listitem>
+
+    <listitem><para>
+      Les standards de l’<acronym>OGC</acronym> utilisent des conventions de nommage qui sont différentes de celles du Java.
+      En particulier les noms de presque toutes les classes de l’<acronym>OGC</acronym> commencent par un préfixe de deux lettres,
+      comme dans <classname role="OGC">MD_Identifier</classname>. Ces préfixes jouent le même rôle que les noms de paquets en Java.
+      GeoAPI adapte cette pratique en utilisant des noms d’interfaces sans préfixes,
+      et en plaçant ces interfaces dans des paquets correspondants aux préfixes mais avec des noms plus descriptifs.
+      Occasionnellement nous changeons aussi les noms, par exemple pour éviter des acronymes
+      ou pour se conformer à une convention établie telle que <foreignphrase>Java beans</foreignphrase>.
+      </para>
+      <informalexample><para>
+        <emphasis role="bold">Exemple:</emphasis>
+        la classe <classname role="OGC">MD_Identifier</classname> de l’<acronym>OGC</acronym> devient
+        l’interface <classname role="GeoAPI">Identifier</classname> dans le paquet <literal role="GeoAPI">org.opengis.metadata</literal>.
+        La classe <classname role="OGC">SC_CRS</classname> de l’<acronym>OGC</acronym> devient l’interface <classname role="GeoAPI">CoordinateReferenceSystem</classname>,
+        et l’association <function role="OGC">usesDatum</function> devient une méthode <function role="GeoAPI">getDatum()</function> —
+        et non pas « <function>getUsesDatum()</function> » comme aurait fait un outil de conversion automatique.
+        Nous ne laissons pas des programmes appliquer aveuglement des règles qui ignorent les conventions de la communauté dont on traduit les schémas.
+      </para></informalexample>
+    </listitem>
+
+    <listitem><para>
+      Les standards contiennent parfois des structures qui n’ont pas d’équivalent direct en Java,
+      notamment les unions telles qu’on peut trouver en C/C++.
+      La stratégie employée pour obtenir une fonctionnalité équivalente en Java dépend du contexte:
+      multi-héritage des interfaces, modification de la hiérarchie ou simplement omettre l’union.
+      Les décisions se font au cas-par-cas en fonction de l’analyse des besoins.
+      </para>
+      <informalexample><para>
+        <emphasis role="bold">Exemple:</emphasis>
+        Le standard ISO 19111 définit différents types de systèmes de coordonnées, tels que sphérique, cylindrique, polaire ou cartésien.
+        Puis, il définit différents <emphasis>sous-ensembles</emphasis> de ces types de systèmes de coordonnées.
+        Ces sous-ensembles, représentés par des unions, servent à spécifier qu’une classe peut être associée à seulement tel ou tel type de système de coordonnées.
+        Par exemple l’union des types pouvant être associés à une image, nommée <classname role="OGC">CS_ImageCS</classname>,
+        ne contient que <classname role="OGC">CS_CartesianCS</classname> et <classname role="OGC">CS_AffineCS</classname>.
+        Dans ce cas particulier, nous obtenons en Java l’effet souhaité par une modification de la hiérarchie des classes:
+        nous définissons l’interface <classname role="GeoAPI">CartesianCS</classname> comme une spécialisation de <classname role="GeoAPI">AffineCS</classname>, ce qui est sémantiquement correct.
+        Mais il n’est pas possible d’appliquer une stratégie similaire pour les autres unions sans violer la sémantique.
+      </para></informalexample>
+    </listitem>
+
+    <listitem><para>
+      Plusieurs spécifications se chevauchent. GeoAPI effectue un travail d’intégration en remplaçant certaines
+      structures qui font doublons par des références vers les structures équivalentes du standard qui les définies le mieux.
+      </para>
+      <informalexample><para>
+        <emphasis role="bold">Exemple:</emphasis>
+        Le standard ISO 19115, qui définit des structures de méta-données,
+        s’aventure aussi à décrire quelques structures représentant les systèmes de références des coordonnées (<acronym>CRS</acronym>).
+        Or ces derniers sont le sujet à part entière d’un autre standard: ISO 19111.
+        D’ailleurs le standard ISO 19111:2007 stipule, dans sa section 3, qu’il réutilise tous les éléments
+        de ISO 19115 à l’exclusion de <classname role="OGC">MD_CRS</classname> et de ses composantes.
+        Les interfaces de GeoAPI réduisent la redondance en appliquant à l’ensemble du projet l’exclusion recommandée par ISO 19111.
+      </para></informalexample>
+    </listitem>
+
+    <listitem><para>
+      Certains standards ont vu leur complexité s’accroître pour des raisons historiques plutôt que techniques,
+      liées au processus de standardisation. GeoAPI réduit la dette technique en concevant les interfaces comme
+      si chaque élément avait pu être intégré à sa place, sans les contraintes liées à l’ordre chronologique
+      dans lequel les standards ont été publiés.
+      </para>
+      <informalexample><para>
+        <emphasis role="bold">Exemple:</emphasis>
+        Le standard ISO 19115-2 est une extension du standard ISO 19115-1 ajoutant des structures de méta-données d’images.
+        Ces méta-données ont été définies dans un standard séparé parce qu’elles n’ont pas été prêtes à temps pour la publication de la première partie du standard.
+        Comme il n’était pas possible, pour des raisons administratives, d’ajouter des attributs dans les classes déjà publiées,
+        les nouveaux attributs ont été ajoutées dans une sous-classe portant quasiment le même nom.
+        Ainsi, le standard ISO 19115-2 définit une classe <classname role="OGC">MI_Band</classname> qui étend la
+        classe <classname role="OGC">MD_Band</classname> du standard ISO 19115-1 en y ajoutant les attributs qui
+        auraient dû apparaître directement dans la classe parente s’ils avaient été prêts à temps.
+        Dans GeoAPI, nous avons choisis de « réparer » ces anomalies en fusionnant ces deux classes en une seule interface.
+      </para></informalexample>
+    </listitem>
+  </itemizedlist>
+
+  <para>
+    Les écarts par rapport aux normes sont documentés dans chaque classe et chaque méthode concernées.
+    Chaque mention d’un écart est aussi recopiée dans <link xlink:href="&geoapi-javadoc;/departures.html">une page unique</link>,
+    pour donner une vue d’ensemble.
+    Étant donné que ces écarts brouillent les liens qui existent entre les standards et certaines interfaces Java,
+    la correspondance entre ces langages est explicitée par des annotations <classname role="GeoAPI">@UML</classname>
+    et des fichiers de propriétés, décrits dans la section suivante.
+  </para>
+
+<section>
+  <title>Correspondances explicitées par l’annotation <classname>@UML</classname></title>
+  <para>
+    Pour chaque classe, méthode et constante définie à partir d’un standard <acronym>OGC</acronym> ou <acronym>ISO</acronym>,
+    GeoAPI indique sa provenance à l’aide d’annotations définies dans le paquet <literal role="GeoAPI">org.opengis.annotation</literal>.
+    En particulier l’annotation <classname role="GeoAPI">@UML</classname> indique le standard, le nom de l’élément dans ce standard ainsi
+    que son niveau d’obligation. Par exemple dans l’extrait de code suivant:
+  </para>
+  <itemizedlist>
+    <listitem>
+      La première annotation <classname role="GeoAPI">@UML</classname> indique que l’interface Java qui la suit
+      (<classname role="GeoAPI">ProjectedCRS</classname>) est définie à partir du type
+      <classname role="OGC">SC_ProjectedCRS</classname> du standard ISO 19111.
+    </listitem>
+    <listitem>
+      La seconde annotation <classname role="GeoAPI">@UML</classname>, appliquée cette fois à la méthode
+      <function role="GeoAPI">getCoordinateSystem()</function>, indique que la méthode est définie
+      à partir de l’association <function role="OGC">coordinateSystem</function> du standard ISO 19111,
+      et que cette association est obligatoire — ce qui, traduit en Java, signifie que la méthode n’est
+      pas autorisée à retourner la valeur <literal>null</literal>.
+    </listitem>
+  </itemizedlist>
+
+  <example>
+    <title>Une interface annotée avec <classname>@UML</classname></title>
+    <programlisting language="java">package org.opengis.referencing.crs;
+
+/**
+ * A 2D coordinate reference system used to approximate the shape of the earth on a planar surface.
+ */
+@UML(specification = ISO_19111,
+     identifier = "SC_ProjectedCRS")
+public interface ProjectedCRS extends GeneralDerivedCRS {
+    /**
+     * Returns the coordinate system, which must be Cartesian.
+     */
+    @UML(obligation = MANDATORY,
+         specification = ISO_19111,
+         identifier = "coordinateSystem")
+    CartesianCS getCoordinateSystem();
+}
+</programlisting>
+  </example>
+
+  <para>
+    Les méthodes d’introspections du Java permettent d’accéder à ces informations pendant l’exécution d’une application.
+    C’est utile pour obtenir les noms à afficher à des utilisateurs familiers avec les normes de l’<acronym>OGC</acronym>,
+    ou pour écrire des éléments dans un document <acronym>XML</acronym>. L’exemple suivant affiche le nom standard de la
+    méthode <function role="GeoAPI">getTitle()</function> de l’interface <classname role="GeoAPI">Citation</classname>:
+  </para>
+
+  <example>
+    <title>Obtenir le nom <acronym>OGC</acronym>/<acronym>ISO</acronym> d’une méthode de GeoAPI</title>
+    <programlisting language="java">Class&lt;?&gt; type   = Citation.class;
+Method   method = type.getMethod("getTitle", (Class&lt;?&gt;[]) null);
+UML      annot  = method.getAnnotation(UML.class);
+String   ident  = annot.identifier();
+System.out.println("Le nom standard de la méthode " + method.getName() + " est " + ident);
+</programlisting>
+  </example>
+
+  <para>
+    L’opération inverse — obtenir la classe et méthode Java d’un nom standard — est un peu plus lourde.
+    Elle nécessite la lecture du fichier <literal role="GeoAPI">class-index.properties</literal> fournit dans le
+    paquet <literal role="GeoAPI">org.opengis.annotation</literal>. L’exemple suivant lit ce fichier juste avant
+    de rechercher le nom de l’interface correspondant à <classname role="OGC">CI_Citation</classname>.
+    Toutefois les utilisateurs sont encouragés à ne lire ce fichier qu’une fois et de conserver son contenu dans
+    une cache de leur application.
+  </para>
+
+  <example>
+    <title>Obtenir une interface GeoAPI à partir d’un nom <acronym>OGC</acronym>/<acronym>ISO</acronym></title>
+    <programlisting language="java">Properties isoToGeoAPI = new Properties();
+try (InputStream in = UML.class.getResourceAsStream("class-index.properties")) {
+    isoToGeoAPI.load(in);
+}
+String isoName = "CI_Citation";
+String geoName = getProperty(isoName);
+Class&lt;?&gt;  type = Class.forName(geoName);
+System.out.println("L’interface GeoAPI du type ISO " + isoName + " est " + type);
+</programlisting>
+  </example>
+  <para>
+    Certaines classes et méthodes n’ont ni annotation <classname role="GeoAPI">@UML</classname>,
+    ni entrée dans le fichier <literal role="GeoAPI">class-index.properties</literal>. Il s’agit
+    soit d’extensions de GeoAPI, ou soit de types définis dans d’autres bibliothèques (notamment
+    le JDK standard). Pour ce dernier cas, une correspondance implicite avec les standards ISO
+    est décrite dans la section suivante.
+  </para>
+</section>
+
+<section>
+  <title>Correspondances implicites avec le JDK standard</title>
+  <para>
+    Le tableau suivant énumère les types de la norme ISO 19103 pour lesquels des types du Java
+    standard ont été utilisés. Les types primitifs sont préférés lorsqu’ils sont applicables,
+    mais parfois leurs équivalents sous forme d’objets sont employés lorsqu’il est nécessaire
+    d’autoriser des valeurs nulles.
+  </para>
+  <table frame="none">
+    <title>Correspondances entre ISO 19103 et JDK</title>
+    <tgroup cols="3">
+      <colspec colname="ISO"/>
+      <colspec colname="JDK"/>
+      <colspec colname="Remark"/>
+      <thead>
+        <row>
+          <entry>Type ISO</entry>
+          <entry>Type JDK</entry>
+          <entry>Remarques</entry>
+        </row>
+      </thead>
+      <tbody>
+        <row>
+          <entry namest="ISO" nameend="Remark" role="separator">Nombres</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Integer</classname></entry>
+          <entry><classname>int</classname></entry>
+          <entry>Parfois <classname>java.lang.Integer</classname> pour les attributs optionnels.</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Integer</classname> (certains cas)</entry>
+          <entry><classname>long</classname></entry>
+          <entry>Parfois <classname>java.lang.Long</classname> pour les attributs optionnels.</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Real</classname></entry>
+          <entry><classname>double</classname></entry>
+          <entry>Parfois <classname>java.lang.Double</classname> pour les attributs optionnels.</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Decimal</classname></entry>
+          <entry><classname>java.math.BigDecimal</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Number</classname></entry>
+          <entry><classname>java.lang.Number</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry namest="ISO" nameend="Remark" role="separator">Textes</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">CharacterString</classname></entry>
+          <entry><classname>java.lang.String</classname></entry>
+          <entry>Souvent <classname role="GeoAPI">org.opengis.util.InternationalString</classname> (voir ci-dessous)</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Sequence&lt;Character&gt;</classname></entry>
+          <entry><classname>java.lang.CharSequence</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Character</classname></entry>
+          <entry><classname>char</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry namest="ISO" nameend="Remark" role="separator">Dates et heures</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Date</classname></entry>
+          <entry><classname>java.util.Date</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Time</classname></entry>
+          <entry><classname>java.util.Date</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">DateTime</classname></entry>
+          <entry><classname>java.util.Date</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry namest="ISO" nameend="Remark" role="separator">Collections</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Collection</classname></entry>
+          <entry><classname>java.util.Collection</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Bag</classname></entry>
+          <entry><classname>java.util.Collection</classname></entry>
+          <entry>Un <classname role="OGC">Bag</classname> est similaire à un <classname>Set</classname>
+                 sans la restriction d’unicité.</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Set</classname></entry>
+          <entry><classname>java.util.Set</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Sequence</classname></entry>
+          <entry><classname>java.util.List</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Dictionary</classname></entry>
+          <entry><classname>java.util.Map</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">KeyValuePair</classname></entry>
+          <entry><classname>java.util.Map.Entry</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry namest="ISO" nameend="Remark" role="separator">Énumérations</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Enumeration</classname></entry>
+          <entry><classname>java.lang.Enum</classname></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">CodeList</classname></entry>
+          <entry>(pas d’équivalent)</entry>
+          <entry>Voir <classname role="GeoAPI">org.opengis.util.CodeList</classname> ci-dessous.</entry>
+        </row>
+        <row>
+          <entry namest="ISO" nameend="Remark" role="separator">Divers</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Boolean</classname></entry>
+          <entry><classname>boolean</classname></entry>
+          <entry>Parfois <classname>java.lang.Boolean</classname> pour les attributs optionnels.</entry>
+        </row>
+        <row>
+          <entry><classname role="OGC">Any</classname></entry>
+          <entry><classname>java.lang.Object</classname></entry>
+          <entry></entry>
+        </row>
+      </tbody>
+    </tgroup>
+  </table>
+
+  <para>
+    L’équivalent le plus direct de <classname role="OGC">CharacterString</classname> est la classe
+    <classname>String</classname>, mais GeoAPI emploie souvent l’interface
+    <classname role="GeoAPI">InternationalString</classname> pour permettre au client de choisir la langue.
+    C’est utile par exemple sur un serveur fournissant simultanément des pages dans plusieurs langues.
+    En reportant les traductions à l’utilisation des objets plutôt qu’au moment de leur création,
+    on permet à la bibliothèque SIS de fournir les mêmes instances de <classname role="GeoAPI">Metadata</classname>
+    ou <classname role="GeoAPI">Coverage</classname> (par exemple) pour les mêmes données peu importe la langue du client.
+    Les traductions peuvent être faites à la volée à l’aide d’un <classname>ResourceBundle</classname> de l’application,
+    ou être fournies directement avec les données (cas des <classname role="GeoAPI">Metadata</classname> notamment).
+  </para>
+  <para>
+    Les <classname role="OGC">Enumeration</classname> correspondent aux <classname>Enum</classname> du Java.
+    Ils ont en commun de définir toutes les valeurs autorisées, sans permettre à l’utilisateur d’en ajouter.
+    Les <classname role="OGC">CodeList</classname> sont similaires à ces énumérations, excepté que les
+    utilisateurs peuvent y ajouter leurs propres éléments. Le JDK standard n’offrant pas cette possibilité,
+    GeoAPI définie une classe abstraite <classname role="GeoAPI">CodeList</classname> reproduisant certaines
+    fonctionnalités de <classname>Enum</classname> tout en étant extensible. Les extensions s’obtiennent par
+    les méthodes statiques <function class="GeoAPI">valueOf(String)</function> qui, contrairement à celle de
+    <classname>Enum</classname>, créera de nouvelles instances si le nom donné ne correspond pas au nom d’une
+    instance existante.
+  </para>
+</section>
+</section>
+</chapter>

Propchange: sis/trunk/src/main/docbook/fr/geoapi.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: sis/trunk/src/main/docbook/fr/geoapi.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: sis/trunk/src/main/docbook/fr/introduction.xml
URL: http://svn.apache.org/viewvc/sis/trunk/src/main/docbook/fr/introduction.xml?rev=1391285&view=auto
==============================================================================
--- sis/trunk/src/main/docbook/fr/introduction.xml (added)
+++ sis/trunk/src/main/docbook/fr/introduction.xml Fri Sep 28 03:00:27 2012
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book [
+  <!ENTITY % book.entities SYSTEM "../book.entities">
+  %book.entities;
+]>
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0"
+      xmlns:xlink = "http://www.w3.org/1999/xlink">
+
+<title>Introduction</title>
+  <para>
+    Une communauté d’informations géospatiales est un ensemble de systèmes ou d’individus capables d’échanger
+    leurs données géospatiales grâce à des définitions et des standards communs ainsi qu’une reconnaissance réciproque.
+    Comme il existe une multitude de façons de représenter des informations géospatiales, chaque communauté est amenée
+    à les structurer en fonction de ses centres d’intérêts.
+    Cette diversité complique la tâche des utilisateurs de systèmes d’information géographiques (<acronym>SIG</acronym>)
+    en les plaçant devant une variété apparemment chaotique de formats et de structures de données.
+    Les caractéristiques de ces structures varient en fonction des phénomènes observés et des méthodes de mesure,
+    ainsi que des habitudes des organisations produisant les données.
+    Une telle variété agit comme un frein aux études qui requièrent des combinaisons de données hétérogènes,
+    surtout lorsqu’elles proviennent de communautés traditionnellement distinctes.
+    Par exemple, un chercheur étudiant le choléra peut s’intéresser aux populations de crevettes
+    comme vecteur de propagation de la maladie.
+    Mais les médecins et les océanographes n’ayant pas forcement l’habitude de partager leurs travaux,
+    les participants à une telle étude peuvent être limités par les efforts qu’ils sont disposés à
+    fournir pour convertir les données.
+  </para>
+
+  <para>
+    Nous ne pouvons pas imposer un format uniforme à l’ensemble des données, car la diversité des formats tient
+    à des facteurs tels que les contraintes des appareils de mesure et la distribution statistique des valeurs.
+    Une solution plus flexible consiste à assurer l’interopérabilité des données à travers une interface
+    de programmation (<acronym>API</acronym>) commune. Cette <acronym>API</acronym> n’est pas forcement
+    définie dans un langage de programmation; la tendance actuelle est plutôt de définir des conventions
+    utilisant les protocoles web existants, que l’on peut transposer dans des langages de programmation.
+    Mais pour que cette démarche puisse être pérennisée, l’<acronym>API</acronym> doit être largement
+    accepté par des développeurs indépendants.
+    Autrement dit, l’<acronym>API</acronym> doit s’approcher autant que possible des standards industriels.
+  </para>
+
+  <para>
+    Les accès aux bases de données relationnelles sont un exemple de tâche ayant bénéficié d’une standardisation
+    relativement bien réussie. L’industrie a établie un langage commun — le standard <acronym>SQL</acronym> —
+    que les concepteurs du Java ont enrobé dans des interfaces de programmation formant le standard <acronym>JDBC</acronym>.
+    Ces interfaces sont aujourd’hui implementées par de nombreux logiciels libres et commerciaux.
+    Comme pour les bases de données, des méthodes d’accès aux informations géographiques ont été standardisées.
+    Mais les efforts en ce sens sont plus récents et leurs intégrations dans les logiciels,
+    surtout les plus anciens, sont incomplètes et pas toujours cohérentes.
+    Au moment d’écrire ces lignes, aucun produit de notre connaissance n’implémente la totalité des spécifications.
+    Mais on trouve de nombreuses implémentations couvrant un spectre plus ou moins large.
+    La bibliothèque Apache SIS décrite dans ce document en est une.
+  </para>
+
+  <para>
+    Apache SIS se caractérise par un effort soutenu de respect des standards,
+    allant jusqu’à une participation à certains travaux de l’OGC.
+    De manière générale, le respect des standards exige un effort plus grand que ce qu’aurait requis un
+    développement isolé, mais se rentabilise par un double avantage: en plus d’accroître l’interopérabilité
+    des données avec celles des projets externes, il nous indique aussi une voie robuste à suivre pour
+    l’élaboration du modèle conceptuel qui sera reflété par l’<acronym>API</acronym>.
+    En effet, les groupes d’experts qui conçoivent les standards anticipent des difficultés
+    qui échappent parfois à l’ingénieur en début de projet, mais qui risquent de le rattraper avant la fin.
+  </para>
+
+<section>
+  <title>À propos de ce document</title>
+  <para>
+   Les éléments définis dans un langage informatique, tels que les classes ou méthodes en Java
+   ainsi que les éléments dans un fichier <acronym>XML</acronym>, apparaissent avec une police
+   de caractères mono-espacée.
+   Afin de faciliter la compréhension des liens qui existent entre Apache SIS et les standards,
+   ces éléments sont en outre représentés en utilisant les codes de couleurs suivants:
+  </para>
+  <itemizedlist>
+    <listitem>
+      Les éléments définis dans un standard de l’<acronym>OGC</acronym> ou de l’<acronym>ISO</acronym> apparaissent en bleu.
+      Exemple: <classname role="OGC">CD_Ellipsoid</classname>.
+    </listitem>
+    <listitem>
+      Les éléments définis dans GeoAPI apparaissent en vert.
+      Exemple: <classname role="GeoAPI">Ellipsoid</classname>.
+    </listitem>
+    <listitem>
+      Les éléments définis dans Apache SIS apparaissent en brun.
+      Exemple: <classname role="SIS">DefaultEllipsoid</classname>.
+    </listitem>
+    <listitem>
+      Les autres éléments, notamment ceux du Java standard, sont laissés en noir.
+      Exemple: <classname>String</classname>.
+    </listitem>
+  </itemizedlist>
+  <para>
+    Cette convention est appliquée dans le texte, mais pas dans les cadres contenant des exemples de codes.
+    Ces cadres utilisent leur propre coloration syntactique.
+  </para>
+
+</section>
+</chapter>

Propchange: sis/trunk/src/main/docbook/fr/introduction.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: sis/trunk/src/main/docbook/fr/introduction.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: sis/trunk/src/main/docbook/fr/standards.xml
URL: http://svn.apache.org/viewvc/sis/trunk/src/main/docbook/fr/standards.xml?rev=1391285&view=auto
==============================================================================
--- sis/trunk/src/main/docbook/fr/standards.xml (added)
+++ sis/trunk/src/main/docbook/fr/standards.xml Fri Sep 28 03:00:27 2012
@@ -0,0 +1,397 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book [
+  <!ENTITY % book.entities SYSTEM "../book.entities">
+  %book.entities;
+]>
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0"
+      xmlns:xlink = "http://www.w3.org/1999/xlink">
+
+<title>Standards et normes</title>
+
+<section>
+  <title>Contexte et historique</title>
+  <para>
+    La majorité des standards utilisés par Apache SIS ont été élaborés par le
+    <link xlink:href="http://www.opengeospatial.org">consortium <foreignphrase>Open Geospatial</foreignphrase></link> (<acronym>OGC</acronym>),
+    parfois en collaboration avec l’<link xlink:href="http://www.iso.org">organisation internationale de normalisation</link> (<acronym>ISO</acronym>).
+    Certains standards de l’ISO deviennent eux-mêmes des standards Européens via la <link xlink:href="http://inspire.jrc.ec.europa.eu">directive <acronym>INSPIRE</acronym></link>,
+    ou des standards français via l’<acronym>AFNOR</acronym>.
+    Ces standards offrent deux technologies clés:
+  </para>
+
+  <itemizedlist>
+    <listitem>
+      Permettre à une communauté d’annoncer leurs informations,
+      de manière à ce que des individus ou des systèmes en dehors de cette communauté puissent les découvrir.
+    </listitem>
+    <listitem>
+      Transférer des informations d’une communauté vers une autre en préservant leurs sémantiques,
+      même si les deux communautés utilisent des représentations internes très différentes.
+    </listitem>
+  </itemizedlist>
+
+  <para>
+    Ces standards sont fournis gratuitement à la communauté internationale sous la forme de
+    <link xlink:href="http://www.opengeospatial.org/standards/is">spécifications (fichiers <acronym>PDF</acronym>)</link> ou
+    de <link xlink:href="http://schemas.opengis.net/gml/&gml-version;/">schémas (fichiers <acronym>XSD</acronym>)</link>.
+    Les organismes de normalisation ne fabriquent pas de logiciel; pour obtenir une implémentation de ces spécifications,
+    les utilisateurs doivent choisir un des produits conformes disponibles sur le marché ou développer leur propres solutions.
+    C’est le respect volontaire de ces spécifications qui permet à des communautés à priori indépendantes d’échanger plus
+    facilement des informations géographiques.
+  </para>
+
+  <para>
+    Outre ces organisations formelles de normalisation, il existe aussi des organisations qui ne sont pas officiellement
+    dédiées à l’élaboration de normes mais dont les travaux ont été largement adoptés comme standards de fait.
+    En particulier, la base de données <link xlink:href="http://www.epsg.org">EPSG</link> fournit des
+    codes numériques permettant d’identifier facilement un système de référence des coordonnées parmi
+    <link xlink:href="../sis-referencing/supported-codes.html">plusieurs milliers</link>.
+    Cette base de données est offerte par des compagnies pétrolières qui ont vu leur intérêt à ce
+    que leurs prospections se fassent bien à l’endroit voulu, sachant qu’elles ne contrôlent pas toujours
+    la production des cartes sur lesquelles elles se positionnent.
+    D’autres exemples de standards de fait sont les formats
+    <link xlink:href="http://geotiff.osgeo.org">GeoTIFF</link> pour les données réparties sur une grille (les images), et
+    <link xlink:href="http://fr.wikipedia.org/wiki/Shapefile">Shapefile</link> pour les données vectorielles (les géométries).
+  </para>
+</section>
+
+<section>
+  <title>Processus de standardisation à l’<acronym>OGC</acronym></title>
+  <para>
+    Les travaux de l’OGC se font par courriers électroniques, par conférences téléphoniques et par
+    <link xlink:href="http://www.opengeospatial.org/event?category=ogctcpc">réunions réelles</link>.
+    L’OGC organise quatre réunions par années, chacune d’une durée de cinq jours, hébergées par des organisations membres
+    sponsorisant l’événement (compagnies, universités, centres de recherches, <foreignphrase>etc.</foreignphrase>).
+    Le continent hôte alterne entre l’Europe et l’Amérique du Nord, avec une présence croissante en Asie depuis 2011.
+    Ces réunions reçoivent habituellement entre 50 et 100 participants parmi les centaines de membres de l’<acronym>OGC</acronym>.
+    Certains participants sont présents à quasiment toutes les réunions et constituent des piliers de l’organisation.
+  </para>
+  <para>
+    Les réunions de l’OGC offrent des opportunités d’échanges avec des membres d’horizons diverses.
+    La création d’un standard OGC commence par le regroupement d’organisations ou d’individus constatant
+    un intérêt commun pour une problématique. Un groupe de travail est proposé sous l’appellation de
+    <foreignphrase>Discussion Working Group</foreignphrase> (<acronym>DWG</acronym>) si le travail est au
+    stade exploratoire, ou <foreignphrase>Standard Working Group</foreignphrase> (<acronym>SWG</acronym>)
+    si le travail de normalisation peut commencer. Les <acronym>DWG</acronym> sont ouverts à tout membre
+    de l’<acronym>OGC</acronym>, tandis que les <acronym>SWG</acronym> nécessitent de la part des participants
+    un engagement à ne pas entraver la diffusion du standard par des réclamations de propriétés intellectuelles.
+  </para>
+
+<section>
+  <title>Fonctionnement des groupes de travail (<acronym>SWG</acronym>)</title>
+  <para>
+    Pour être accepté, un projet de standardisation doit être supporté par un nombre minimal de membres
+    appartement à des organisations distinctes. Ces membres fondateurs rédigent une charte définissant les
+    objectifs du <acronym>SWG</acronym>, qui doit être approuvée par le comité technique de l’<acronym>OGC</acronym>.
+    Chaque membre fondateur est doté d’un droit de vote, dans les limites d’un membre votant par organisation.
+    Tout nouveau membre qui souhaite joindre le <acronym>SWG</acronym> après sa création se verra attribué un rôle d’observateur,
+    avec attribution sur demande d’un droit de vote après quelques mois d’observation.
+  </para>
+  <para>
+    Un <acronym>SWG</acronym> peut contenir plusieurs dizaines de membres, mais les volontaires effectuant
+    l’essentiel du travail sont habituellement moins nombreux. Leurs propositions sont soumises à l’ensemble
+    des membres du groupe, qui peuvent les accepter par consentement unanime. Les objections, s’il y en a,
+    doivent être argumentées et une alternative proposée. Les <acronym>SWG</acronym> essaient généralement de
+    débattre d’un problème jusqu’à ce qu’un consensus se forme plutôt que d’avancer malgré des votes négatifs,
+    même s’ils sont minoritaires. Les décisions du groupes sont alors intégrées dans la spécification par un
+    membre assumant le rôle d’éditeur.
+  </para>
+  <para>
+    Le groupe de travail doit autant que possible structurer la spécification sous forme d’un noyau
+    autour duquel gravite diverses extensions. Une suite de tests doit accompagner le standard,
+    et permettre de classer les implémentations en fonction du niveau des tests passés.
+    Au moins une <firstterm>implémentation de référence</firstterm> passant les tests doit exister
+    pour démontrer que le standard est utilisable.
+  </para>
+  <para>
+    Lorsque le standard est jugé prêt, le <acronym>SWG</acronym> vote une motion proposant de le soumettre
+    au vote des instances supérieures de l’OGC. Cette procédure nécessite plusieurs mois. Il existe une
+    procédure plus rapide pour entériner des standards de fait, mais elle n’est appliquée qu’avec parcimonie.
+  </para>
+</section>
+
+<section>
+  <title>Le conseil d’architecture (<acronym>OAB</acronym>) et le comité technique (<acronym>TC</acronym>)</title>
+  <para>
+    Toute proposition de standard est d’abord examinée par le conseil d’architecture
+    (<foreignphrase>OGC Architecture Board</foreignphrase> - <acronym>OAB</acronym>). Ce conseil
+    vérifie que le standard répond aux exigences de l’OGC sur la forme, sur la modularisation, et
+    en termes d’intégration avec les autres standards. Si l’<acronym>OAB</acronym> donne son aval,
+    le standard est alors soumis au vote des membres du comité technique (<acronym>TC</acronym>).
+    Ce comité regroupe les principaux membres de l’OGC qui sont seuls habilités à donner le vote final.
+    En cas d’approbation, le standard est diffusé publiquement pour commentaires pendant une période
+    de quelques mois. Au terme de cette période, le <acronym>SWG</acronym> doit examiner et répondre
+    à chacun des commentaires. Les éventuelles modifications au standard sous soumises à l’<acronym>OAB</acronym>,
+    puis le standard est définitivement publié.
+    Cette diffusion est alors annoncée par un communiqué de presse de l’<acronym>OGC</acronym>.
+  </para>
+  <para>
+    Certains membres de l’<acronym>OAB</acronym> et du <acronym>TC</acronym> assurent aussi la liaison
+    avec l’organisation internationale de normalisation (<acronym>ISO</acronym>).
+    La coopération entre les deux organismes va dans les deux sens: l’<acronym>OGC</acronym> adopte
+    les standards <acronym>ISO</acronym> comme base sur laquelle développer de nouveaux standards,
+    et certains de ces nouveaux standards <acronym>OGC</acronym> deviennent des standards <acronym>ISO</acronym>.
+  </para>
+</section>
+
+<section>
+  <title>Procédure de soumission de propositions de modifications</title>
+  <para>
+    Tout utilisateur, qu’il soit membre ou non du consortium <foreignphrase>Open Geospatial</foreignphrase>,
+    peut proposer des modifications à des standards <acronym>OGC</acronym>.
+    Une liste des propositions actuelles de changements, ainsi qu’un formulaire permettant d’en soumettre de nouvelles,
+    sont <link xlink:href="http://www.opengeospatial.org/standards/cr">disponibles en ligne</link>.
+    Chaque proposition est revue par le <acronym>SWG</acronym>.
+  </para>
+  <para>
+    Certains groupes de travail utilisent d’autres systèmes de soumission en parallèle.
+    En particulier, le projet GeoAPI continue à utiliser un
+    <link xlink:href="http://jira.codehaus.org/browse/GEO">système de tâches JIRA</link>
+    hébergé en dehors des structures de l’<acronym>OGC</acronym>.
+    Cet état des choses existe en partie pour des raisons historiques, et en partie parce que les
+    développements du projet GeoAPI se font davantage au niveau d’un code source plutôt qu’au
+    niveau de documents ou de diagrammes de classes.
+  </para>
+</section>
+</section>
+
+<section>
+  <title>Les différents types de spécifications</title>
+  <para>
+    Les standards <acronym>OGC</acronym> sont spécifiés dans plusieurs dizaines de documents.
+    Chaque document élabore un service, par exemple les transformations de coordonnées.
+    Le fonctionnement de chaque service est décrit par un ensemble de classes d’objets et leurs interactions.
+    Ces éléments sont illustrés par des diagrammes <acronym>UML</acronym> (<foreignphrase>Unified Modeling Language</foreignphrase>)
+    dans des spécifications dites « abstraites ».
+  </para>
+  <para>
+    Les <link xlink:href="http://www.opengeospatial.org/standards/as"><firstterm>spécifications abstraites</firstterm></link>
+    ne font référence à aucun langage informatique concret.
+    Leurs concepts peuvent se concrétiser dans un langage de programmation, une base de données ou un schéma
+    <acronym>XML</acronym> de manière plus ou moins directe. Il existe toutefois une part d’arbitraire dans la façon
+    de concrétiser une spécification abstraite, étant donné que des ajustements sont souvent nécessaires
+    pour tenir compte des contraintes ou des conventions du langage ciblé. Par exemple:
+  </para>
+
+  <itemizedlist>
+    <listitem>
+      L’approche orientée objets se concrétise par des solutions verbeuses dans certains langages
+      (notamment le <acronym>XML</acronym> défini par <acronym>ISO</acronym> 19139),
+      notamment pour le support du polymorphisme.
+    </listitem>
+    <listitem>
+      Certaines structures de données n’existent que dans quelques langages,
+      par exemple les unions qui existent en C/C++ mais pas en Java.
+    </listitem>
+    <listitem>
+      Certaines spécifications (surtout les plus anciennes) définissent des opérations,
+      qui se prêtent bien aux langages de programmation ou à des services mais pas à des bases de données.
+    </listitem>
+  </itemizedlist>
+
+  <para>
+    Au tournant du millénaire, les spécifications abstraites étaient explicitement concrétisées dans des
+    <firstterm>spécifications d’implémentations</firstterm>. Le terme « implémentation » était ici à prendre au
+    sens de tout type d’interfaces (Java ou autres) dérivées des diagrammes <acronym>UML</acronym> — et non pas
+    d’implémentations au sens du Java. Des telles spécifications existaient pour les langages
+    <acronym>SQL</acronym>, <acronym>CORBA</acronym>, <acronym>COM</acronym> et Java.
+    Ces langages étant capables d’exécuter des procédures, les spécifications de cette époque définissaient
+    non seulement des structures de données, mais aussi des opérations s’appliquant sur ces structures.
+  </para>
+  <para>
+    Par la suite, l’engouement pour le « web 2.0 » a fait grimper l’intérêt pour le <acronym>XML</acronym>
+    au détriment des autres langages. Les anciennes spécifications d’implémentations ont été dépréciées,
+    et les schémas <acronym>XSD</acronym> sont devenus la principale concrétisation des spécifications abstraites.
+    Même la façon de concevoir les spécifications abstraites a évoluée: les opérations y sont plus rarement définies,
+    par conséquence ce qui reste ressemble davantage à des descriptions de schémas de base de données.
+    Certaines opérations qui étaient définies dans les anciennes normes apparaissent maintenant,
+    sous une autre forme, dans les spécifications des services web.
+    Enfin le terme « spécification d’implémentation » a été abandonné, pour être englobé dans « standard <acronym>OGC</acronym> ».
+    Mais malgré leur dépréciation, les <link xlink:href="http://www.opengeospatial.org/standards/retired">anciennes spécifications d’implémentations</link>
+    restent utiles aux programmes en langage Java car:
+  </para>
+
+  <itemizedlist>
+    <listitem>
+      Leurs modèles plus simples, appliqués aux mêmes concepts, aident à comprendre les nouvelles spécifications.
+    </listitem>
+    <listitem>
+      Ils définissent parfois des façons simples d’effectuer des tâches courantes
+      là où les nouvelles spécifications se limitent au cas général.
+    </listitem>
+    <listitem>
+      Les opérations étant plus souvent omises dans les nouvelles spécifications,
+      les anciennes spécifications restent un complément utile pour définir des <acronym>API</acronym>.
+    </listitem>
+  </itemizedlist>
+
+  <para>
+    Le projet Apache SIS se base sur les spécifications les plus récentes, tout en puisant dans les archives
+    de l’<acronym>OGC</acronym> pour compléter certains standards abstraits ou les rendre un peu plus facile
+    d’utilisation. Certaines anciennes définitions sont conservées comme « méthodes de commodités »,
+    n’apportant pas toujours de nouvelles fonctionnalités mais facilitant l’usage pratique d’une bibliothèque.
+  </para>
+  <para>
+    Le tableau suivant liste les principales normes utilisées par le projet.
+    Plusieurs normes sont publiées à la fois comme standard <acronym>ISO</acronym> et comme
+    standard <acronym>OGC</acronym>, d’où la disposition côte-à-côte des deux premières colonnes.
+    Les normes dépréciées mais malgré tout utilisées apparaissent <phrase role="deprecated">barrées</phrase>.
+    Enfin, les paquets GeoAPI seront introduits dans le chapitre suivant.
+  </para>
+
+  <table frame="none">
+    <title>Principaux standards utilisés par le projet Apache SIS</title>
+    <tgroup cols="4">
+      <colspec colname="ISO"/>
+      <colspec colname="OGC"/>
+      <colspec colname="name"/>
+      <colspec colname="GeoAPI"/>
+      <thead>
+        <row>
+          <entry>Norme ISO</entry>
+          <entry>Norme OGC</entry>
+          <entry>Titre</entry>
+          <entry>Paquet GeoAPI</entry>
+        </row>
+      </thead>
+      <tbody>
+        <row>
+          <entry namest="ISO" nameend="GeoAPI" role="separator">Spécifications abstraites</entry>
+        </row>
+        <row>
+          <entry>ISO 19103</entry>
+          <entry></entry>
+          <entry><foreignphrase>Conceptual schema language</foreignphrase></entry>
+          <entry><literal>org.opengis.util</literal></entry>
+        </row>
+        <row>
+          <entry>ISO 19115</entry>
+          <entry>Topic 11</entry>
+          <entry><foreignphrase>Metadata</foreignphrase></entry>
+          <entry><literal>org.opengis.metadata</literal></entry>
+        </row>
+        <row>
+          <entry>ISO 19111</entry>
+          <entry>Topic 2</entry>
+          <entry><foreignphrase>Spatial referencing by coordinates</foreignphrase></entry>
+          <entry><literal>org.opengis.referencing</literal></entry>
+        </row>
+        <row>
+          <entry>ISO 19108</entry>
+          <entry></entry>
+          <entry><foreignphrase>Temporal Schema</foreignphrase></entry>
+          <entry><literal>org.opengis.temporal</literal></entry>
+        </row>
+        <row>
+          <entry>ISO 19107</entry>
+          <entry>Topic 1</entry>
+          <entry><foreignphrase>Feature geometry</foreignphrase></entry>
+          <entry><literal>org.opengis.geometry</literal></entry>
+        </row>
+        <row>
+          <entry>ISO 19101</entry>
+          <entry>Topic 5</entry>
+          <entry><foreignphrase>Features</foreignphrase></entry>
+          <entry><literal>org.opengis.feature</literal></entry>
+        </row>
+        <row>
+          <entry>ISO 19123</entry>
+          <entry>Topic 6</entry>
+          <entry><foreignphrase>Schema for coverage geometry and functions</foreignphrase></entry>
+          <entry><literal>org.opengis.coverage</literal></entry>
+        </row>
+        <row>
+          <entry>ISO 19156</entry>
+          <entry>Topic 20</entry>
+          <entry><foreignphrase>Observations and measurements</foreignphrase></entry>
+          <entry><literal>org.opengis.observation</literal></entry>
+        </row>
+        <row>
+          <entry namest="ISO" nameend="GeoAPI" role="separator">Spécifications d’implémentation</entry>
+        </row>
+        <row>
+          <entry>ISO 19139</entry>
+          <entry></entry>
+          <entry><foreignphrase>Metadata XML schema implementation</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry>ISO 13249</entry>
+          <entry></entry>
+          <entry><foreignphrase>SQL spatial</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry><phrase role="deprecated">OGC 01-009</phrase></entry>
+          <entry><phrase role="deprecated"><foreignphrase>Coordinate Transformation Services</foreignphrase></phrase></entry>
+          <entry><literal>org.opengis.referencing</literal></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry><phrase role="deprecated">OGC 01-004</phrase></entry>
+          <entry><phrase role="deprecated"><foreignphrase>Grid Coverage</foreignphrase></phrase></entry>
+          <entry><literal>org.opengis.coverage</literal></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry>SLD</entry>
+          <entry><foreignphrase>Styled Layer Descriptor</foreignphrase></entry>
+          <entry><literal>org.opengis.style</literal></entry>
+        </row>
+        <row>
+          <entry namest="ISO" nameend="GeoAPI" role="separator">Services web</entry>
+        </row>
+        <row>
+          <entry>ISO 19128</entry>
+          <entry>WMS</entry>
+          <entry><foreignphrase>Web Map Service</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry>WMTS</entry>
+          <entry><foreignphrase>Web Map Tile Service</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry>ISO 19142</entry>
+          <entry>WFS</entry>
+          <entry><foreignphrase>Web Feature Service</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry>WCS</entry>
+          <entry><foreignphrase>Web Coverage Service</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry>WPS</entry>
+          <entry><foreignphrase>Web Processing Service</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry>OpenLS</entry>
+          <entry><foreignphrase>Location Services</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry>SWE</entry>
+          <entry><foreignphrase>Sensor Web Enablement</foreignphrase></entry>
+          <entry></entry>
+        </row>
+        <row>
+          <entry></entry>
+          <entry>SOS</entry>
+          <entry><foreignphrase>Sensor Observation Service</foreignphrase></entry>
+          <entry></entry>
+        </row>
+      </tbody>
+    </tgroup>
+  </table>
+</section>
+</chapter>

Propchange: sis/trunk/src/main/docbook/fr/standards.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: sis/trunk/src/main/docbook/fr/standards.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Modified: sis/trunk/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/sis/trunk/src/site/apt/index.apt?rev=1391285&r1=1391284&r2=1391285&view=diff
==============================================================================
--- sis/trunk/src/site/apt/index.apt (original)
+++ sis/trunk/src/site/apt/index.apt Fri Sep 28 03:00:27 2012
@@ -23,3 +23,5 @@ The Apache SIS library
     * {{{http://builds.apache.org/job/sis-trunk/site/apidocs/index.html}Aggregated Javadoc}}
 
     * {{{./code-patterns.html}Recommended code patterns}}
+
+    * Developer Guide (English - translation to be provided later) ({{{./book/fr.xhtml}Français}})

Added: sis/trunk/src/site/resources/book/book.css
URL: http://svn.apache.org/viewvc/sis/trunk/src/site/resources/book/book.css?rev=1391285&view=auto
==============================================================================
--- sis/trunk/src/site/resources/book/book.css (added)
+++ sis/trunk/src/site/resources/book/book.css Fri Sep 28 03:00:27 2012
@@ -0,0 +1,104 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+div.informalexample {
+  margin-left:  1.25cm;
+  margin-right: 1.5cm;
+  font-size: smaller;
+}
+
+p {
+  text-align: justify;
+}
+
+span.deprecated {
+  text-decoration: line-through;
+}
+
+div.table p.title {
+  text-align: center;
+}
+
+table {
+  margin-left:  auto;
+  margin-right: auto;
+  border-style: solid;
+  border-width:   2pt;
+  border-spacing: 0pt;
+}
+
+table tr th {
+  background-color: #B9DCFF;
+  border-bottom-style: solid;
+  border-bottom-width: 1pt;
+  padding: 3pt;
+}
+
+table tr td {
+  padding-left:  9pt;
+  padding-right: 9pt;
+}
+
+table tr td.separator {
+  font-weight: bold;
+  text-align: center;
+  padding-top:    3pt;
+  padding-bottom: 3pt;
+  border-top-style: solid;
+  border-top-width: 1pt;
+  border-top-color: lightgray;
+  border-bottom-style: solid;
+  border-bottom-width: 1pt;
+  border-bottom-color: lightgray;
+  background-color: #EEEEFF;
+}
+
+pre.programlisting {
+  border-style: solid;
+  border-width: 1pt;
+  padding: 9pt;
+}
+
+/*
+ * OGC/ISO, GeoAPI and SIS legends.
+ */
+code.OGC {
+  color: MediumBlue;
+}
+
+code.GeoAPI {
+  color: Green;
+}
+
+code.Geotk {
+  color: SaddleBrown;
+}
+
+/*
+ * Syntax highlighting.
+ */
+span.hl-string {
+  color: fireBrick;
+}
+
+span.hl-annotation {
+  color: slateGray;
+}
+
+span.hl-doccomment {
+  font-style: italic;
+  color: teal;
+}

Propchange: sis/trunk/src/site/resources/book/book.css
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: sis/trunk/src/site/resources/book/book.css
------------------------------------------------------------------------------
    svn:mime-type = text/css