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 2023/11/17 15:49:20 UTC
(sis-site) 03/04: Review introduction in developer guide, update versions and references to "build helper".
This is an automated email from the ASF dual-hosted git repository.
desruisseaux pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/sis-site.git
commit f4ec9d15f62069798636a9866c33c2c6e48734e3
Author: Martin Desruisseaux <ma...@geomatys.com>
AuthorDate: Fri Nov 17 11:22:19 2023 +0100
Review introduction in developer guide, update versions and references to "build helper".
---
content/coding-conventions.md | 2 +-
content/developer-guide/README.txt | 2 +-
.../annexes/design/AffineTransform.html | 2 +-
.../annexes/design/EarlyOrLateBinding.html | 2 +-
.../annexes/design/JacobianUsage.html | 2 +-
.../annexes/design/MatrixLibrary.html | 2 +-
.../developer-guide/annexes/design/XMLTools.html | 2 +-
content/developer-guide/annexes/design/index.html | 2 +-
.../annexes/geoapi/ConceptualModels.html | 2 +-
.../annexes/geoapi/DefinitionProcess.html | 2 +-
content/developer-guide/annexes/geoapi/GeoAPI.html | 2 +-
.../developer-guide/annexes/geoapi/Modules.html | 2 +-
.../annexes/geoapi/ReduceDependency.html | 2 +-
content/developer-guide/annexes/geoapi/index.html | 2 +-
content/developer-guide/annexes/index.html | 2 +-
.../annexes/tests/GeoApiConformance.html | 2 +-
content/developer-guide/annexes/tests/index.html | 2 +-
.../developer-guide/coverage/AffineTransform.html | 2 +-
content/developer-guide/coverage/GridGeometry.html | 2 +-
.../developer-guide/coverage/SampleDimension.html | 2 +-
content/developer-guide/coverage/index.html | 2 +-
content/developer-guide/geometry/Envelope.html | 2 +-
content/developer-guide/geometry/index.html | 2 +-
.../developer-guide/introduction/Conventions.html | 45 +++-------
.../developer-guide/introduction/DataAccess.html | 9 +-
.../introduction/DefinitionOfTerms.html | 95 ++++++++++++++++++++++
.../developer-guide/introduction/Installation.html | 6 +-
content/developer-guide/introduction/index.html | 12 ++-
.../metadata/GetMetadataElement.html | 2 +-
content/developer-guide/metadata/index.html | 2 +-
content/developer-guide/referencing/AxisOrder.html | 2 +-
.../referencing/ComponentsOfCRS.html | 2 +-
.../referencing/CoordinateOperationSteps.html | 2 +-
.../referencing/CoordinateOperations.html | 2 +-
content/developer-guide/referencing/GetCRS.html | 2 +-
content/developer-guide/referencing/index.html | 2 +-
.../developer-guide/utility/ComparisonModes.html | 2 +-
.../utility/Internationalization.html | 2 +-
.../developer-guide/utility/ObjectConverters.html | 2 +-
content/developer-guide/utility/index.html | 2 +-
content/developer-guide/xml/ISO-19115.html | 2 +-
content/developer-guide/xml/index.html | 2 +-
content/downloads.md | 2 +-
content/release-management.md | 2 +-
static/book/book.css | 12 +++
static/openoffice/install.html | 6 +-
46 files changed, 171 insertions(+), 92 deletions(-)
diff --git a/content/coding-conventions.md b/content/coding-conventions.md
index 1f66614f..176d3923 100644
--- a/content/coding-conventions.md
+++ b/content/coding-conventions.md
@@ -132,7 +132,7 @@ SIS uses standard javadoc annotations. The meaning of some tags are refined as b
A separated `@author` tag is added for each developer.
The intent is to allow other developers to know to who to ask questions if needed.
-In addition, the `sis-build-helper` modules provides the following custom javadoc taglets:
+In addition, the Java code in `buildSrc` provides the following custom javadoc taglets:
Javadoc tag | Description
-------------- | -------------------------------------------------------------------------------------------
diff --git a/content/developer-guide/README.txt b/content/developer-guide/README.txt
index 55465678..f1064eca 100644
--- a/content/developer-guide/README.txt
+++ b/content/developer-guide/README.txt
@@ -1,6 +1,6 @@
This directory contains the source files for the developer guide in HTML5 format.
Those files are assembled into a single file in the "../../static/book/ directory"
-by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+by the `org.apache.sis.buildtools.book` class in `buildSrc`.
Assuming the following directory structure:
diff --git a/content/developer-guide/annexes/design/AffineTransform.html b/content/developer-guide/annexes/design/AffineTransform.html
index 86296b84..5f06e11a 100644
--- a/content/developer-guide/annexes/design/AffineTransform.html
+++ b/content/developer-guide/annexes/design/AffineTransform.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/design/EarlyOrLateBinding.html b/content/developer-guide/annexes/design/EarlyOrLateBinding.html
index 123c6352..d38b71d4 100644
--- a/content/developer-guide/annexes/design/EarlyOrLateBinding.html
+++ b/content/developer-guide/annexes/design/EarlyOrLateBinding.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/design/JacobianUsage.html b/content/developer-guide/annexes/design/JacobianUsage.html
index 336cc167..31df0a43 100644
--- a/content/developer-guide/annexes/design/JacobianUsage.html
+++ b/content/developer-guide/annexes/design/JacobianUsage.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/design/MatrixLibrary.html b/content/developer-guide/annexes/design/MatrixLibrary.html
index 8ade688e..852f4015 100644
--- a/content/developer-guide/annexes/design/MatrixLibrary.html
+++ b/content/developer-guide/annexes/design/MatrixLibrary.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/design/XMLTools.html b/content/developer-guide/annexes/design/XMLTools.html
index 583f05fd..f06daff1 100644
--- a/content/developer-guide/annexes/design/XMLTools.html
+++ b/content/developer-guide/annexes/design/XMLTools.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/design/index.html b/content/developer-guide/annexes/design/index.html
index dcd1eb70..4ec12eab 100644
--- a/content/developer-guide/annexes/design/index.html
+++ b/content/developer-guide/annexes/design/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/geoapi/ConceptualModels.html b/content/developer-guide/annexes/geoapi/ConceptualModels.html
index 9e9a20f8..9eb295b4 100644
--- a/content/developer-guide/annexes/geoapi/ConceptualModels.html
+++ b/content/developer-guide/annexes/geoapi/ConceptualModels.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/geoapi/DefinitionProcess.html b/content/developer-guide/annexes/geoapi/DefinitionProcess.html
index c5fbe6c0..1dfed58f 100644
--- a/content/developer-guide/annexes/geoapi/DefinitionProcess.html
+++ b/content/developer-guide/annexes/geoapi/DefinitionProcess.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
diff --git a/content/developer-guide/annexes/geoapi/GeoAPI.html b/content/developer-guide/annexes/geoapi/GeoAPI.html
index 53c82d9a..2cf1fd21 100644
--- a/content/developer-guide/annexes/geoapi/GeoAPI.html
+++ b/content/developer-guide/annexes/geoapi/GeoAPI.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/geoapi/Modules.html b/content/developer-guide/annexes/geoapi/Modules.html
index 15c7778b..a3fc046e 100644
--- a/content/developer-guide/annexes/geoapi/Modules.html
+++ b/content/developer-guide/annexes/geoapi/Modules.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
diff --git a/content/developer-guide/annexes/geoapi/ReduceDependency.html b/content/developer-guide/annexes/geoapi/ReduceDependency.html
index 650f59d1..8d86b75c 100644
--- a/content/developer-guide/annexes/geoapi/ReduceDependency.html
+++ b/content/developer-guide/annexes/geoapi/ReduceDependency.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/geoapi/index.html b/content/developer-guide/annexes/geoapi/index.html
index 1e6776e6..8a0de522 100644
--- a/content/developer-guide/annexes/geoapi/index.html
+++ b/content/developer-guide/annexes/geoapi/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/index.html b/content/developer-guide/annexes/index.html
index 774b8bcd..3bead281 100644
--- a/content/developer-guide/annexes/index.html
+++ b/content/developer-guide/annexes/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/tests/GeoApiConformance.html b/content/developer-guide/annexes/tests/GeoApiConformance.html
index 45ab83aa..da4ba71b 100644
--- a/content/developer-guide/annexes/tests/GeoApiConformance.html
+++ b/content/developer-guide/annexes/tests/GeoApiConformance.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/annexes/tests/index.html b/content/developer-guide/annexes/tests/index.html
index c609c93e..d5e31d39 100644
--- a/content/developer-guide/annexes/tests/index.html
+++ b/content/developer-guide/annexes/tests/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/coverage/AffineTransform.html b/content/developer-guide/coverage/AffineTransform.html
index ef25cc32..c5b43834 100644
--- a/content/developer-guide/coverage/AffineTransform.html
+++ b/content/developer-guide/coverage/AffineTransform.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/coverage/GridGeometry.html b/content/developer-guide/coverage/GridGeometry.html
index 6bff1785..07caa683 100644
--- a/content/developer-guide/coverage/GridGeometry.html
+++ b/content/developer-guide/coverage/GridGeometry.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/coverage/SampleDimension.html b/content/developer-guide/coverage/SampleDimension.html
index 9cc55283..dc3fba64 100644
--- a/content/developer-guide/coverage/SampleDimension.html
+++ b/content/developer-guide/coverage/SampleDimension.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/coverage/index.html b/content/developer-guide/coverage/index.html
index 777acac0..265aa856 100644
--- a/content/developer-guide/coverage/index.html
+++ b/content/developer-guide/coverage/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/geometry/Envelope.html b/content/developer-guide/geometry/Envelope.html
index 95535c79..9ec48bac 100644
--- a/content/developer-guide/geometry/Envelope.html
+++ b/content/developer-guide/geometry/Envelope.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/geometry/index.html b/content/developer-guide/geometry/index.html
index 4dcafc1e..063fd2c8 100644
--- a/content/developer-guide/geometry/index.html
+++ b/content/developer-guide/geometry/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/introduction/Conventions.html b/content/developer-guide/introduction/Conventions.html
index 9b83e350..aa0a3716 100644
--- a/content/developer-guide/introduction/Conventions.html
+++ b/content/developer-guide/introduction/Conventions.html
@@ -29,17 +29,17 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
- <h2 id="Conventions">Typographic and naming conventions</h2>
+ <h2 id="TypographicConventions">Typographic conventions</h2>
</header>
<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 this document.
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:
+ these elements are also represented using the following color codes:
</p>
<ul>
<li>
@@ -54,7 +54,7 @@
</li>
<li>
Elements left in black are either defined elsewhere (for example the standard Java library),
- or there is simply no emphasis on that element for the discussion.
+ or there is no emphasis on that element for the discussion.
</li>
</ul>
<p>
@@ -62,7 +62,13 @@
<code class="OGC">SC_ProjectedCRS</code> is an <abbr>UML</abbr> and <abbr>XML</abbr> element defined by the <abbr>ISO</abbr> 19111 standard.
Then <code class="GeoAPI">org.opengis.referencing.crs.<b>ProjectedCRS</b></code> is the implementation-neutral GeoAPI interface derived from that standard,
and <code class="SIS">org.apache.sis.referencing.crs.<b>DefaultProjectedCRS</b></code> is the implementation class provided by Apache SIS.
- </p><p>
+ </p>
+ </section>
+ <section>
+ <header>
+ <h2 id="CodingConventions">Coding conventions</h2>
+ </header>
+ <p>
Apache SIS implements most GeoAPI interfaces by a classes of the same name than the interface
but prefixed by <code>Abstract</code>, <code>Default</code> or <code>General</code> word.
The <code>General</code> prefix is sometimes used instead of <code>Default</code>
@@ -79,35 +85,6 @@
Such classes can be instantiated by a <code>new AbstractXXX(…)</code> statement despite being conceptually abstract.
Such instantiations should be avoided, but are nevertheless permitted in last resort when it is not possible to determine the exact subtype.
</p>
- <p>
- Text in gray boxes, like below (click to expand), are for information purpose only and can be ignored.
- </p>
- <details>
- <summary>Note about the definition of terms</summary>
- <article id="ChosenTerms">
- <header>
- <h2>Source of term definitions</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 mathematical functions in order to designate
- a set of possible values of inputs and outputs respectively.
- The <abbr>ISO</abbr> 19123 standard 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.
- </p><p>
- However the functions to which above terms are applied by <abbr>ISO</abbr> standards are not the same as the functions to which they are applied by other libraries.
- For example <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 for 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>
- </article>
- </details>
</section>
</body>
</html>
diff --git a/content/developer-guide/introduction/DataAccess.html b/content/developer-guide/introduction/DataAccess.html
index dc0f4a69..c09b283e 100644
--- a/content/developer-guide/introduction/DataAccess.html
+++ b/content/developer-guide/introduction/DataAccess.html
@@ -20,7 +20,7 @@
under the License.
-->
-<html xmlns="http://www.w3.org/1999/xhtml" xmlns:xi="http://www.w3.org/2001/XInclude" xml:lang="fr">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>DataAccess</title>
<meta charset="UTF-8"/>
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
@@ -61,9 +61,8 @@
</p><p>
Various data formats have their own metadata model, but Apache <abbr>SIS</abbr> translates all of them
in a unique metadata model in order to hide this heterogeneity.
- This <em>pivot model</em> approach is often used by various libraries,
- with <cite>Dublin Core</cite> as a popular choice.
- For Apache <abbr>SIS</abbr>, the chosen pivot model is the <abbr>ISO</abbr> <cite>19115</cite> international standard.
+ This <em>pivot model</em> approach is often used by various libraries, with Dublin Core as a popular choice.
+ For Apache <abbr>SIS</abbr>, the chosen pivot model is the <abbr>ISO</abbr> 19115 international standard.
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,
diff --git a/content/developer-guide/introduction/DefinitionOfTerms.html b/content/developer-guide/introduction/DefinitionOfTerms.html
new file mode 100644
index 00000000..87b38024
--- /dev/null
+++ b/content/developer-guide/introduction/DefinitionOfTerms.html
@@ -0,0 +1,95 @@
+<?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="en">
+ <head>
+ <title>DefinitionOfTerms</title>
+ <meta charset="UTF-8"/>
+ <link rel="stylesheet" type="text/css" href="../book.css"/>
+ </head>
+ <body>
+ <!--
+ Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
+ -->
+ <section>
+ <header>
+ <h2 id="DefinitionOfTerms">Definition of terms</h2>
+ </header>
+ <p>
+ The meaning of words sometime depend on the community using them.
+ 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> standards.
+ Particular care must be taken with the interfaces between <abbr>SIS</abbr> and certain other external libraries.
+ For example, the <abbr>ISO</abbr> 19123 standard see <code>CV_Coverage</code> as functions
+ in which the <dfn>domain</dfn> is the set of spatio-temporal coordinates encompassed by the data,
+ and the <dfn>range</dfn> is the set of values encompassed.
+ However, <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 for converting pixel indices (its <dfn>domain</dfn>) to spatial-temporal coordinates (its <dfn>range</dfn>).
+ Thus the <abbr>UCAR</abbr> library’s <dfn>range</dfn> may be the <dfn>domain</dfn> of <abbr>ISO</abbr> 19123.
+ </p>
+ <dl>
+ <dt>Coverage</dt>
+ <dd>Feature that acts as a function to return values from its range for any direct position within its spatial,
+ temporal or spatiotemporal domain.
+ <span class="term-source">ISO 19123</span></dd>
+
+ <dt>Coordinate</dt>
+ <dd>One of a sequence of numbers designating the position of a point.
+ <span class="term-source">ISO 19111</span></dd>
+
+ <dt>Coordinate operation</dt>
+ <dd>Process using a mathematical model, based on a one-to-one relationship, that changes coordinates
+ in a source coordinate reference system to coordinates in a target coordinate reference system,
+ or that changes coordinates at a source coordinate epoch to coordinates at a target coordinate epoch
+ within the same coordinate reference system.
+ <span class="term-source">ISO 19111</span></dd>
+
+ <dt>Coordinate reference system</dt>
+ <dd>Coordinate system that is related to an object by a datum.
+ <span class="term-source">ISO 19111</span></dd>
+
+ <dt>Coordinate system</dt>
+ <dd>Set of mathematical rules for specifying how coordinates are to be assigned to points.
+ <span class="term-source">ISO 19111</span></dd>
+
+ <dt>Coordinate tuple</dt>
+ <dd>Tuple composed of coordinates.
+ The number of coordinates in the coordinate tuple equals the dimension of the coordinate system.
+ The order of coordinates in the coordinate tuple is identical to the order of the axes of the coordinate system.
+ <span class="term-source">ISO 19111</span></dd>
+
+ <dt>Datum</dt>
+ <dd>Parameter or set of parameters that realize the position of the origin,
+ the scale, and the orientation of a coordinate system.
+ <span class="term-source">ISO 19111</span></dd>
+
+ <dt>Domain</dt>
+ <dd>Well-defined set.
+ <span class="term-source">ISO 19123</span></dd>
+
+ <dt>Range</dt>
+ <dd>Set of feature attribute values associated by a function with the elements of the domain of a coverage.
+ <span class="term-source">ISO 19123</span></dd>
+ </dl>
+ </section>
+ </body>
+</html>
diff --git a/content/developer-guide/introduction/Installation.html b/content/developer-guide/introduction/Installation.html
index 6749122c..ac0d3e3d 100644
--- a/content/developer-guide/introduction/Installation.html
+++ b/content/developer-guide/introduction/Installation.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
@@ -47,7 +47,7 @@
see <a href="../../epsg.html">How to use EPSG geodetic dataset</a> page for more information.
</p>
<pre><properties>
- <sis.version>1.3</sis.version>
+ <sis.version>1.4</sis.version>
</properties>
<dependencies>
<dependency>
@@ -72,7 +72,7 @@
<dependency>
<groupId>org.glassfish.jaxb</groupId>
<artifactId>jaxb-runtime</artifactId>
- <version>4.0.3</version>
+ <version>4.0.4</version>
<scope>runtime</scope>
</dependency>
diff --git a/content/developer-guide/introduction/index.html b/content/developer-guide/introduction/index.html
index 4e9473e7..a25576a7 100644
--- a/content/developer-guide/introduction/index.html
+++ b/content/developer-guide/introduction/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
@@ -46,21 +46,19 @@
</p><p>
The library is an implementation of <abbr title="Open Geospatial Consortium">OGC</abbr> <a href="http://www.geoapi.org">GeoAPI</a> interfaces.
In a series of <code>org.opengis.*</code> packages, GeoAPI offers a set of implementation-neutral Java interfaces for geospatial applications.
- These interfaces closely follow the specifications of the <abbr>OGC</abbr>, while interpreting and adapting them
- to meet the needs of Java developers — for example, conforming with Java naming conventions.
+ These interfaces closely follow the specifications of the <abbr>OGC</abbr>,
+ while interpreting and adapting them to meet the needs of Java developers.
The conceptual model of GeoAPI will be explained in detail in the chapters describing Apache <abbr>SIS</abbr> implementation.
- However, we can get an overview of its content by consulting the page listing the mapping between
- <a href="http://www.geoapi.org/3.0/javadoc/content.html">GeoAPI methods and the standards where they come from</a>.
- The <a href="#GeoAPI">annex</a> provides more details about GeoAPI history and how to use it.
</p><p>
While Apache <abbr>SIS</abbr> is primarily a library for helping developers to create their own applications,
<abbr>SIS</abbr> provides also an optional JavaFX application for testing its capability to read, transform and visualize data files.
- Screenshots of this application may be used in this document for illustrative purposes.
+ Screenshots of this application are used in this document for illustrative purposes.
</p><p>
<b>Note:</b> this document contains mathematical formulas expressed in MathML.
For viewing those formulas, a MathML-capable browser (e.g. Firefox) is required.
</p>
+ <xi:include href="DefinitionOfTerms.html"/>
<xi:include href="Conventions.html"/>
<xi:include href="Installation.html"/>
<xi:include href="DataAccess.html"/>
diff --git a/content/developer-guide/metadata/GetMetadataElement.html b/content/developer-guide/metadata/GetMetadataElement.html
index 603b676c..ef2aa3c9 100644
--- a/content/developer-guide/metadata/GetMetadataElement.html
+++ b/content/developer-guide/metadata/GetMetadataElement.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/metadata/index.html b/content/developer-guide/metadata/index.html
index f1960d31..7ebb5a6e 100644
--- a/content/developer-guide/metadata/index.html
+++ b/content/developer-guide/metadata/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/referencing/AxisOrder.html b/content/developer-guide/referencing/AxisOrder.html
index 3a37acbf..70503ec8 100644
--- a/content/developer-guide/referencing/AxisOrder.html
+++ b/content/developer-guide/referencing/AxisOrder.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/referencing/ComponentsOfCRS.html b/content/developer-guide/referencing/ComponentsOfCRS.html
index f670230a..733193ba 100644
--- a/content/developer-guide/referencing/ComponentsOfCRS.html
+++ b/content/developer-guide/referencing/ComponentsOfCRS.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/referencing/CoordinateOperationSteps.html b/content/developer-guide/referencing/CoordinateOperationSteps.html
index 12bd648b..479236b8 100644
--- a/content/developer-guide/referencing/CoordinateOperationSteps.html
+++ b/content/developer-guide/referencing/CoordinateOperationSteps.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<h3 id="CoordinateOperationSteps">Chain of coordinate operation steps</h3>
<p>
diff --git a/content/developer-guide/referencing/CoordinateOperations.html b/content/developer-guide/referencing/CoordinateOperations.html
index 9ee4dd92..79ab6638 100644
--- a/content/developer-guide/referencing/CoordinateOperations.html
+++ b/content/developer-guide/referencing/CoordinateOperations.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/referencing/GetCRS.html b/content/developer-guide/referencing/GetCRS.html
index abe279ed..e4bbde4e 100644
--- a/content/developer-guide/referencing/GetCRS.html
+++ b/content/developer-guide/referencing/GetCRS.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/referencing/index.html b/content/developer-guide/referencing/index.html
index 9a64bf23..45bee81e 100644
--- a/content/developer-guide/referencing/index.html
+++ b/content/developer-guide/referencing/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/utility/ComparisonModes.html b/content/developer-guide/utility/ComparisonModes.html
index 9cb42962..2b1f0f4b 100644
--- a/content/developer-guide/utility/ComparisonModes.html
+++ b/content/developer-guide/utility/ComparisonModes.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/utility/Internationalization.html b/content/developer-guide/utility/Internationalization.html
index 02699498..093f3807 100644
--- a/content/developer-guide/utility/Internationalization.html
+++ b/content/developer-guide/utility/Internationalization.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/utility/ObjectConverters.html b/content/developer-guide/utility/ObjectConverters.html
index 3e27caad..ec3ff412 100644
--- a/content/developer-guide/utility/ObjectConverters.html
+++ b/content/developer-guide/utility/ObjectConverters.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/utility/index.html b/content/developer-guide/utility/index.html
index d9aeca06..9eddfa1e 100644
--- a/content/developer-guide/utility/index.html
+++ b/content/developer-guide/utility/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/xml/ISO-19115.html b/content/developer-guide/xml/ISO-19115.html
index 742ebf71..52d03432 100644
--- a/content/developer-guide/xml/ISO-19115.html
+++ b/content/developer-guide/xml/ISO-19115.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/developer-guide/xml/index.html b/content/developer-guide/xml/index.html
index 48233dbe..0d22ee5a 100644
--- a/content/developer-guide/xml/index.html
+++ b/content/developer-guide/xml/index.html
@@ -29,7 +29,7 @@
<body>
<!--
Content below this point is copied in "/asf-staging/book/en/developer-guide.html" file
- by the `org.apache.sis.internal.book.Assembler` class in `sis-build-helper` module.
+ by the `org.apache.sis.buildtools.book` class in `buildSrc`.
-->
<section>
<header>
diff --git a/content/downloads.md b/content/downloads.md
index 74b9f6c2..17f87eea 100644
--- a/content/downloads.md
+++ b/content/downloads.md
@@ -125,7 +125,7 @@ Below are examples of declarations in a `pom.xml` file for building a project wi
<dependency>
<groupId>org.glassfish.jaxb</groupId>
<artifactId>jaxb-runtime</artifactId>
- <version>4.0.3</version>
+ <version>4.0.4</version>
<scope>runtime</scope>
</dependency>
</dependencies>
diff --git a/content/release-management.md b/content/release-management.md
index 6390382a..7e4574ea 100644
--- a/content/release-management.md
+++ b/content/release-management.md
@@ -514,7 +514,7 @@ In the [Nexus repository][repository], click on "Refresh".
A new `org.apache.sis` item should appear in the _Repository_ column of _Build Promotion_ → _Staging repositories_.
Navigate through the artifact tree and make sure that all Javadoc, source and jar files have `.asc` (GPG signature) and `.sha1` files.
Select any `*-javadoc.jar` file and click on the <cite>Archive Browser</cite> tab on the right side.
-Select any `*.html` file which is known to use some of the custom taglets defined in the `sis-build-helper` module.
+Select any `*.html` file which is known to use some of the custom taglets defined in `buildSrc`.
Click on that file and verify that the custom elements are rendered properly.
Then close this staging repository.
In the description field, specify _"Apache SIS main artifacts"_.
diff --git a/static/book/book.css b/static/book/book.css
index d2d61bfc..b319440c 100644
--- a/static/book/book.css
+++ b/static/book/book.css
@@ -107,6 +107,18 @@ ul.verbose li {
margin-top: 9px;
margin-bottom: 9px;
}
+dt {
+ margin-top: 9px;
+ font-weight: bold;
+}
+
+span.term-source:before {
+ color: SteelBlue;
+ content: " — Source: ";
+}
+span.term-source {
+ color: SteelBlue;
+}
/*
* Chapters and sections titles (excluding the book titles).
diff --git a/static/openoffice/install.html b/static/openoffice/install.html
index 639112d6..2e1ea376 100644
--- a/static/openoffice/install.html
+++ b/static/openoffice/install.html
@@ -31,9 +31,7 @@
<section>
<h2 id="requirements">Requirements</h2>
<p>
- This add-in requires OpenOffice or LibreOffice, together with Java 7 or 8.
- Current add-in version has been tested on LibreOffice 5.3 with Java 8.
- This version does not work yet with Java 9.
+ This add-in requires OpenOffice or LibreOffice, together with Java 11 or later.
</p>
</section>
@@ -47,7 +45,7 @@
In the dialog box, select <i>Java</i> (on OpenOffice) or <i>Advanced</i> (on LibreOffice).
If no Java runtime environment is proposed, push the <i>Add</i> button and select a directory
where a Java Runtime Environment is installed.
- When a list of <abbr>JRE</abbr> is available, select a Java version 7 or 8.
+ When a list of <abbr>JRE</abbr> is available, select a Java version 11 or later.
</p>
</section>