content/fr/developer-guide/introduction/AboutBook.html (63 lines of code) (raw):
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html>
<!--
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.
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr">
<head>
<title>AboutBook</title>
<meta charset="UTF-8"/>
<link rel="stylesheet" type="text/css" href="../book.css"/>
</head>
<body>
<!--
Content below this point is copied in "/static/book/fr/developer-guide.html"
by the 'org.apache.sis.internal.book.Assembler' class in 'sis-build-helper' module.
-->
<section>
<header>
<h2 id="AboutBook">Conventions utilisées dans ce guide</h2>
</header>
<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,
ces éléments sont en outre représentés en utilisant les codes de couleurs suivants:
</p>
<ul>
<li>
Les éléments en bleu sont définis dans un standard de l’<abbr title="Open Geospatial Consortium">OGC</abbr>
ou de l’<abbr title="International Organization for Standardization">ISO</abbr>.
Exemple: <code>CD_Ellipsoid</code>.
</li>
<li>
Les éléments en vert sont définis dans GeoAPI.
Exemple: <code>Ellipsoid</code>.
</li>
<li>
Les éléments en brun sont définis dans Apache <abbr title="Spatial Information System">SIS</abbr>.
Exemple: <code>DefaultEllipsoid</code>.
</li>
<li>
Les éléments laissés en noir sont soient définis ailleurs (exemple: <code>String</code>),
ou ne font pas l’objet d’une emphase particulière pour la discussion.
</li>
</ul>
<p>
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>