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"><gmd:CI_Citation></classname> à lâintérieur de <function role="OGC"><gmd:citation></function>,
+ un élément <classname role="OGC"><gmd:CI_OnlineResource></classname> à lâintérieur de <function role="OGC"><gmd:onlineResource></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<?> type = Citation.class;
+Method method = type.getMethod("getTitle", (Class<?>[]) 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<?> 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<Character></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