sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1815622 - in /sis/site/trunk/book: en/introduction/AboutBook.html en/introduction/GeoAPI.html en/overview/DataAccess.html fr/introduction/AboutBook.html fr/introduction/GeoAPI.html fr/overview/DataAccess.html
Date Fri, 17 Nov 2017 20:07:39 GMT
Author: desruisseaux
Date: Fri Nov 17 20:07:39 2017
New Revision: 1815622

URL: http://svn.apache.org/viewvc?rev=1815622&view=rev
Log:
Change section order in introduction.

Modified:
    sis/site/trunk/book/en/introduction/AboutBook.html
    sis/site/trunk/book/en/introduction/GeoAPI.html
    sis/site/trunk/book/en/overview/DataAccess.html
    sis/site/trunk/book/fr/introduction/AboutBook.html
    sis/site/trunk/book/fr/introduction/GeoAPI.html
    sis/site/trunk/book/fr/overview/DataAccess.html

Modified: sis/site/trunk/book/en/introduction/AboutBook.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/en/introduction/AboutBook.html?rev=1815622&r1=1815621&r2=1815622&view=diff
==============================================================================
--- sis/site/trunk/book/en/introduction/AboutBook.html [UTF-8] (original)
+++ sis/site/trunk/book/en/introduction/AboutBook.html [UTF-8] Fri Nov 17 20:07:39 2017
@@ -36,27 +36,6 @@
         <h2 id="AboutBook">Conventions used in this guide</h2>
       </header>
       <p>
-        Standards sometimes favour the application of certain generic terms to particular
contexts,
-        which may differ from the context in which other communities use these terms.
-        For example, the terms <i>domain</i> and <i>range</i> may
apply to arbitrary functions in order to designate
-        a set of possible values of inputs and outputs respectively.
-        But the functions to which they are applied by certain <abbr>ISO</abbr>
standards are not the same as the functions to which they are applied by other libraries.
-        For example, <abbr>ISO</abbr> 19123 applies these terms to <code>CV_Coverage</code>
objects,
-        seen as functions in which the <i>domain</i> is the set of spatio-temporal
coordinates encompassed by the data,
-        and the <i>range</i> is the set of values encompassed.
-        But <abbr title="University Corporation for Atmospheric Research">UCAR</abbr>’s
<abbr title="Network Common Data Form">netCDF</abbr> library
-        applies these terms instead to the function of converting pixel indices (its <i>domain</i>)
to spatial-temporal coordinates (its <i>range</i>).
-        Thus the <abbr>UCAR</abbr> library’s <i>range</i> may be
the <i>domain</i> of <abbr>ISO</abbr> 19123.
-      </p><p>
-        The Apache <abbr>SIS</abbr> library prefers as much as possible to use
terms in the sense of <abbr>OGC</abbr> and <abbr>ISO</abbr> norms.
-        Particular care must be taken, however, with the interfaces between <abbr>SIS</abbr>
and certain other external libraries,
-        in order to reduce the risk of confusion.
-      </p>
-
-
-
-      <h3 id="CodeColors">Code colors</h3>
-      <p>
         The elements defined in a computer language, such as classes and methods in Java
or elements in an <abbr>XML</abbr> document,
         appear in monospaced font.
         In order to facilitate an understanding of the relationships between Apache <abbr>SIS</abbr>
and the standards, these elements are also represented using the following colour codes:
@@ -83,6 +62,27 @@
       <p>
         Text in gray boxes are for information purpose only and can be ignored.
       </p>
+
+
+
+      <h3 id="ChosenTerms">Chosen terms</h3>
+      <p>
+        Standards sometimes favour the application of certain generic terms to particular
contexts,
+        which may differ from the context in which other communities use these terms.
+        For example, the terms <i>domain</i> and <i>range</i> may
apply to arbitrary functions in order to designate
+        a set of possible values of inputs and outputs respectively.
+        But the functions to which they are applied by certain <abbr>ISO</abbr>
standards are not the same as the functions to which they are applied by other libraries.
+        For example, <abbr>ISO</abbr> 19123 applies these terms to <code>CV_Coverage</code>
objects,
+        seen as functions in which the <i>domain</i> is the set of spatio-temporal
coordinates encompassed by the data,
+        and the <i>range</i> is the set of values encompassed.
+        But <abbr title="University Corporation for Atmospheric Research">UCAR</abbr>’s
<abbr title="Network Common Data Form">netCDF</abbr> library
+        applies these terms instead to the function of converting pixel indices (its <i>domain</i>)
to spatial-temporal coordinates (its <i>range</i>).
+        Thus the <abbr>UCAR</abbr> library’s <i>range</i> may be
the <i>domain</i> of <abbr>ISO</abbr> 19123.
+      </p><p>
+        The Apache <abbr>SIS</abbr> library prefers as much as possible to use
terms in the sense of <abbr>OGC</abbr> and <abbr>ISO</abbr> norms.
+        Particular care must be taken, however, with the interfaces between <abbr>SIS</abbr>
and certain other external libraries,
+        in order to reduce the risk of confusion.
+      </p>
     </section>
   </body>
 </html>

Modified: sis/site/trunk/book/en/introduction/GeoAPI.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/en/introduction/GeoAPI.html?rev=1815622&r1=1815621&r2=1815622&view=diff
==============================================================================
--- sis/site/trunk/book/en/introduction/GeoAPI.html [UTF-8] (original)
+++ sis/site/trunk/book/en/introduction/GeoAPI.html [UTF-8] Fri Nov 17 20:07:39 2017
@@ -144,8 +144,8 @@
         Both approaches expect the same arguments (omitted in this example for brevity).
       </div>
       <p>
-        In the default Apache SIS configuration, using <code>CRSFactory.createXXX(…)</code>
or <code>new DefaultXXX(…)</code>
-        is almost the same except that <code>Factory</code> may return existing
instances instead than creating new instances,
+        In the default Apache SIS configuration, using <code>FooFactory.createXXX(…)</code>
or <code>new DefaultXXX(…)</code>
+        is almost the same except that <code>FooFactory</code> may return existing
instances instead than creating new instances,
         and that exceptions thrown in case of invalid arguments are different types.
         In more advanced configurations, using <code>Factory</code> reduces the
         <a href="#ServiceLoader">direct dependencies toward Apache SIS</a>

Modified: sis/site/trunk/book/en/overview/DataAccess.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/en/overview/DataAccess.html?rev=1815622&r1=1815621&r2=1815622&view=diff
==============================================================================
--- sis/site/trunk/book/en/overview/DataAccess.html (original)
+++ sis/site/trunk/book/en/overview/DataAccess.html Fri Nov 17 20:07:39 2017
@@ -66,8 +66,8 @@
         This approach — to select a single metadata model as the <em>pivot
model</em> — is often used by other libraries.
         For example Apache Tika uses <cite>Dublin Core</cite> as the pivot metadata
model,
         while Java Image I/O defines its own standard metadata model in its <code>javax.imageio.metadata</code>
package.
-        For Apache <abbr>SIS</abbr>, the chosen pivot model is the <cite><abbr>ISO</abbr>
19115-1:2014 — Fundamentals</cite>
-        international standard, completed by <cite><abbr>ISO</abbr> 19115-2
— Extensions for imagery and gridded data</cite>.
+        For Apache <abbr>SIS</abbr>, the chosen pivot model is the <abbr>ISO</abbr>
<cite>19115-1:2014 — Fundamentals</cite>
+        international standard, completed by <abbr>ISO</abbr> 19115-2 —
<cite>Extensions for imagery and gridded data</cite>.
         This model organizes metadata in a tree structure where each information is accessible
by a well-defined path,
         regardless the origin of that information.
         For example if a data format can provides a geographic bounding box encompassing
all data,
@@ -97,10 +97,10 @@
 
 <pre><samp>The geographic bounding box is:
 Geographic Bounding Box
-  ├─West bound longitude……………………………
108°20′10,464″E
-  ├─East bound longitude……………………………
110°26′39,66″E
-  ├─South bound latitude……………………………
10°29′59,604″N
-  └─North bound latitude……………………………
12°37′25,716″N</samp></pre>
+  ├─West bound longitude……………………………
108°20′10.464″E
+  ├─East bound longitude……………………………
110°26′39.66″E
+  ├─South bound latitude……………………………
10°29′59.604″N
+  └─North bound latitude……………………………
12°37′25.716″N</samp></pre>
 
         <p>
           The Java code in this example extracts metadata elements by Java method invocations
like <code class="GeoAPI">getExtents()</code>,

Modified: sis/site/trunk/book/fr/introduction/AboutBook.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/fr/introduction/AboutBook.html?rev=1815622&r1=1815621&r2=1815622&view=diff
==============================================================================
--- sis/site/trunk/book/fr/introduction/AboutBook.html [UTF-8] (original)
+++ sis/site/trunk/book/fr/introduction/AboutBook.html [UTF-8] Fri Nov 17 20:07:39 2017
@@ -36,27 +36,6 @@
         <h2 id="AboutBook">Conventions utilisées dans ce guide</h2>
       </header>
       <p>
-        Les standards privilégient parfois l’application de certains termes génériques
à des contextes particuliers,
-        qui peuvent différer du contexte dans lequel d’autres communautés emploient ces
termes.
-        Par exemple les termes <i>domain</i> et <i>range</i> peuvent
s’appliquer à des fonctions arbitraires
-        pour désigner l’ensemble des valeurs possibles en entrés et en sorties respectivement.
-        Mais les fonctions auxquelles certains standards <abbr>ISO</abbr>
-        les appliquent ne sont pas les mêmes que les fonctions auxquelles d’autres bibliothèques
les appliquent.
-        Par exemple <abbr>ISO</abbr> 19123 applique ces termes aux objets <code>CV_Coverage</code>,
-        vus comme des fonctions dont le domaine est l’ensemble des coordonnées spatio-temporelles
de la couverture de données
-        et le <i>range</i> l’ensemble des valeurs de la couverture.
-        Mais la bibliothèque <abbr title="Network Common Data Form">netCDF</abbr>
de l’<abbr title="University Corporation for Atmospheric Research">UCAR</abbr>
-        applique plutôt ces termes à la fonction convertissant les indices de pixels (son
domaine) vers les coordonnées spatio-temporelles (son <i>range</i>).
-        Ainsi, un <i>range</i> de la bibliothèque de l’<abbr>UCAR</abbr>
peut être le domaine de <abbr>ISO</abbr> 19123.
-      </p><p>
-        La bibliothèque Apache <abbr>SIS</abbr> privilégie autant que possible
l’utilisation des termes dans le sens des normes <abbr>OGC</abbr> et <abbr>ISO</abbr>.
-        Mais un soin particulier doit être apporté aux interfaces entre <abbr>SIS</abbr>
et certaines bibliothèques externes, afin de réduire les risques de confusions.
-      </p>
-
-
-
-      <h3 id="CodeColors">Code de couleurs</h3>
-      <p>
         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 <abbr>XML</abbr>, apparaissent
avec une police de caractères mono-espacée.
         Afin de faciliter la compréhension des liens qui existent entre Apache <abbr>SIS</abbr>
et les standards,
@@ -85,6 +64,27 @@
         Des compléments d’information apparaissent dans des boîtes grises.
         Le lecteur peut ignorer ces boîtes grises sans que cela ne nuise à la compréhension
du texte.
       </p>
+
+
+
+      <h3 id="ChosenTerms">Choix des termes</h3>
+      <p>
+        Les standards privilégient parfois l’application de certains termes génériques
à des contextes particuliers,
+        qui peuvent différer du contexte dans lequel d’autres communautés emploient ces
termes.
+        Par exemple les termes <i>domain</i> et <i>range</i> peuvent
s’appliquer à des fonctions arbitraires
+        pour désigner l’ensemble des valeurs possibles en entrés et en sorties respectivement.
+        Mais les fonctions auxquelles certains standards <abbr>ISO</abbr>
+        les appliquent ne sont pas les mêmes que les fonctions auxquelles d’autres bibliothèques
les appliquent.
+        Par exemple <abbr>ISO</abbr> 19123 applique ces termes aux objets <code>CV_Coverage</code>,
+        vus comme des fonctions dont le domaine est l’ensemble des coordonnées spatio-temporelles
de la couverture de données
+        et le <i>range</i> l’ensemble des valeurs de la couverture.
+        Mais la bibliothèque <abbr title="Network Common Data Form">netCDF</abbr>
de l’<abbr title="University Corporation for Atmospheric Research">UCAR</abbr>
+        applique plutôt ces termes à la fonction convertissant les indices de pixels (son
domaine) vers les coordonnées spatio-temporelles (son <i>range</i>).
+        Ainsi, un <i>range</i> de la bibliothèque de l’<abbr>UCAR</abbr>
peut être le domaine de <abbr>ISO</abbr> 19123.
+      </p><p>
+        La bibliothèque Apache <abbr>SIS</abbr> privilégie autant que possible
l’utilisation des termes dans le sens des normes <abbr>OGC</abbr> et <abbr>ISO</abbr>.
+        Mais un soin particulier doit être apporté aux interfaces entre <abbr>SIS</abbr>
et certaines bibliothèques externes, afin de réduire les risques de confusions.
+      </p>
     </section>
   </body>
 </html>

Modified: sis/site/trunk/book/fr/introduction/GeoAPI.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/fr/introduction/GeoAPI.html?rev=1815622&r1=1815621&r2=1815622&view=diff
==============================================================================
--- sis/site/trunk/book/fr/introduction/GeoAPI.html [UTF-8] (original)
+++ sis/site/trunk/book/fr/introduction/GeoAPI.html [UTF-8] Fri Nov 17 20:07:39 2017
@@ -148,8 +148,8 @@
       </div>
       <p>
         Dans la configuration par défaut de Apache SIS,
-        utiliser <code>CRSFactory.createXXX(…)</code> ou <code>new DefaultXXX(…)</code>
revient presque au même
-        excepté que les <code>Factory</code> peuvent retourner des instances
existantes
+        utiliser <code>FooFactory.createXXX(…)</code> ou <code>new DefaultXXX(…)</code>
revient presque au même
+        excepté que les <code>FooFactory</code> peuvent retourner des instances
existantes
         plutôt que de créer systématiquement de nouvelles instances,
         et que les exceptions en cas d’arguments invalides sont de types différents.
         Dans des configurations plus avancées, l’usage des <code>Factory</code>
permet de

Modified: sis/site/trunk/book/fr/overview/DataAccess.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/fr/overview/DataAccess.html?rev=1815622&r1=1815621&r2=1815622&view=diff
==============================================================================
--- sis/site/trunk/book/fr/overview/DataAccess.html (original)
+++ sis/site/trunk/book/fr/overview/DataAccess.html Fri Nov 17 20:07:39 2017
@@ -68,8 +68,8 @@
         Par exemple Apache Tika utilise le standard <cite>Dublin Core</cite>
comme modèle pivot,
         alors que Java Image I/O définit son propre modèle standard dans le paquet
<code>javax.imageio.metadata</code>.
         Pour Apache <abbr>SIS</abbr>, le modèle pivot choisi est le standard
international de méta-données en information géographique
-        <cite><abbr>ISO</abbr> 19115-1:2014 — principes de base</cite>,
complété par
-        <cite><abbr>ISO</abbr> 19115-2 — extensions pour l’acquisition
et le traitement</cite>.
+        <abbr>ISO</abbr> 19115-1:2014 — <cite>principes de base</cite>,
complété par
+        <abbr>ISO</abbr> 19115-2 — <cite>extensions pour l’acquisition
et le traitement</cite>.
         Ce modèle organise les méta-données dans une arborescence où chaque information
est accessible via un chemin bien défini,
         peu importe l’origine de cette information.
         Par exemple si un format de données peut nous fournir les coordonnées géographiques
d’une boîte englobant toutes les données,



Mime
View raw message