Reorder chapters slightly. Steamline sample responses.

264fc688 · Stephan · 08f7df1e · 264fc688 · 264fc688 · 264fc688
Commit 264fc688 authored 5 years ago by Stephan
--- a/documentation/users-guide/conf.py
+++ b/documentation/users-guide/conf.py
@@ -52,6 +52,8 @@ html_theme = 'alabaster'
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']

+html_favicon = 'images/favicon.ico'
+
 numfig = True
 numfig_format = {
    'figure': 'Figure %s',

--- a/documentation/users-guide/index.rst
+++ b/documentation/users-guide/index.rst
@@ -9,8 +9,8 @@ View Server - Users Guide
   intro

   web-client
-   searching
   viewing
+   searching
   downloading

   sample-requests

--- a/documentation/users-guide/sample-requests.rst
+++ b/documentation/users-guide/sample-requests.rst
--- a/documentation/users-guide/searching.rst
+++ b/documentation/users-guide/searching.rst
@@ -91,65 +91,7 @@ Parameter       Description

 The available parameters depend on the configuration made by the operator.

-Example response
----------------
-
-Below is a sample response from a product search for an individual product in
-Atom format.
-
-.. code-block:: xml
-
-  <feed xmlns="http://www.w3.org/2005/Atom" xmlns:cql="http://a9.com/-/opensearch/extensions/cql/1.0/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:eo="http://a9.com/-/opensearch/extensions/eo/1.0/" xmlns:geo="http://a9.com/-/opensearch/extensions/geo/1.0/" xmlns:georss="http://www.georss.org/georss" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:owc="http://www.opengis.net/owc/1.0" xmlns:time="http://a9.com/-/opensearch/extensions/time/1.0/">
-    <id>https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7</id>
-    <title>VHR_IMAGE_2018_Level_3 Search</title>
-    <description/>
-    <opensearch:totalResults>1</opensearch:totalResults>
-    <opensearch:startIndex>0</opensearch:startIndex>
-    <opensearch:itemsPerPage>1</opensearch:itemsPerPage>
-    <opensearch:Query geo:uid="urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" role="request"/>
-    <link href="https://vhr18.pdas.prism.eox.at/opensearch/" rel="search" type="application/opensearchdescription+xml"/>
-    <link href="https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" rel="self" type="application/atom+xml"/>
-    <link href="https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn%3Aeop%3ADOVE%3AMULTISPECTRAL_4m%3A20180811_081455_1054_3be7" rel="first" type="application/atom+xml"/>
-    <link href="https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?startIndex=0&amp;uid=urn%3Aeop%3ADOVE%3AMULTISPECTRAL_4m%3A20180811_081455_1054_3be7" rel="last" type="application/atom+xml"/>
-    <entry>
-      <title>urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7</title>
-      <id>https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7</id>
-      <dc:identifier>urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7</dc:identifier>
-      <dc:date>2018-08-11T08:14:55Z</dc:date>
-      <georss:box>47.297788 25.978201 47.372606 26.047511</georss:box>
-      <georss:where>
-        <gml:MultiSurface gml:id="multisurface_urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" srsName="EPSG:4326" xmlns:eop="http://www.opengis.net/eop/2.0" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:gmlcov="http://www.opengis.net/gmlcov/1.0" xmlns:om="http://www.opengis.net/om/2.0">
-          <gml:surfaceMember>
-            <gml:Polygon gml:id="polygon_urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7_1">
-              <gml:exterior>
-                <gml:LinearRing>
-                  <gml:posList>47.29778796 26.00330821 47.29784395 26.00300545 47.29852855 26.00098039 47.33176050 25.98961353 47.35564999 25.98157482 47.35572189 25.98204011 47.36693204 25.97820059 47.37260630 26.01455420 47.37197192 26.01658883 47.37098788 26.01863079 47.36976416 26.02036682 47.36834411 26.02173541 47.36677806 26.02268812 47.31293985 26.04698765 47.31114307 26.04751063 47.30931486 26.04748521 47.30753117 26.04691252 47.30586607 26.04581637 47.30438870 26.04424235 47.30409927 26.04377423 47.29778796 26.00330821</gml:posList>
-                </gml:LinearRing>
-              </gml:exterior>
-            </gml:Polygon>
-          </gml:surfaceMember>
-        </gml:MultiSurface>
-      </georss:where>
-      <link href="https://vhr18.pdas.prism.eox.at/ows?service=DSEO&amp;version=1.0.0&amp;request=GetProduct&amp;ProductURI=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" rel="enclosure"/>
-      <media:content url="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=463&amp;height=500&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511">
-        <media:category>QUICKLOOK</media:category>
-      </media:content>
-      <media:content url="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=92&amp;height=100&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511">
-        <media:category>THUMBNAIL</media:category>
-      </media:content>
-      <owc:offering code="http://www.opengis.net/spec/owc-atom/1.0/req/wms">
-        <owc:operation code="GetCapabilities" href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;request=GetCapabilities&amp;cql=identifier='urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7'" method="GET" type="application/xml"/>
-        <owc:operation code="GetMap" href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=463&amp;height=500&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511" method="GET" type="image/png"/>
-      </owc:offering>
-      <owc:offering code="http://www.opengis.net/spec/owc-atom/1.0/req/wcs">
-        <owc:operation code="GetCapabilities" href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=GetCapabilities" method="GET" type="application/xml"/>
-        <owc:operation code="DescribeCoverage" href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=DescribeCoverage&amp;coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage" method="GET" type="application/xml"/>
-        <owc:operation code="GetCoverage" href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=GetCoverage&amp;coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage" method="GET" type="image/tiff"/>
-      </owc:offering>
-      <summary type="html">
-        <![CDATA[<table><tr><td valign="top" width="10%"><a href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=463&amp;height=500&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511" target="_blank" title="View quicklook image"><img align="left" border="0" hspace="8" src="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=92&amp;height=100&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511"  /></a></td><td valign="top" width="90%"><table><tr valign="top"><td><b>Date </b></td><td>2018-08-11T08:14:55+00:00 / 2018-08-11T08:14:55+00:00</td></tr><tr valign="top"><td><b>Metadata</b></td><td><a href="https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" title="Atom format" target="_blank">ATOM</a></td></tr><tr valign="top"><td><b>Download</b></td><td><a href="https://vhr18.pdas.prism.eox.at/ows?service=DSEO&amp;version=1.0.0&amp;request=GetProduct&amp;ProductURI=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" title="Download" target="_blank">Package</a></td></tr></table></td></tr></table><h3>OGC cross links</h3><ul><li><b>WMS</b><ul><li><a href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;request=GetCapabilities&amp;cql=identifier=&#39;urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&#39;" target="_blank">GetCapabilities</a></li></ul><ul><li><a href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=463&amp;height=500&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511" target="_blank">GetMap</a></li></ul></li><li><b>WCS</b><ul><li><a href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=DescribeEOCoverageSet&amp;eoId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" target="_blank">DescribeEOCoverageSet</a></li><li><b>urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage</b><ul><li><a href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=DescribeCoverage&amp;coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage" target="_blank">DescribeCoverage</a></li><li><a href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=GetCoverage&amp;coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage" target="_blank">GetCoverage</a></li></ul></li></ul></li></ul><h3>Metadata</h3><table><tr><td>Cloud Cover</td><td>0.0</td></tr></table>]]>
-      </summary>
-    </entry>
-  </feed>
-
-Continue reading about the provided :ref:`viewing` services.
+Samples responses for each of the four URL endpoints are provided in the
+:ref:`samples_searching` section of the :ref:`sample_requests` chapter.
+
+Continue reading about the provided :ref:`downloading` services.
--- a/documentation/users-guide/viewing.rst
+++ b/documentation/users-guide/viewing.rst
@@ -164,4 +164,4 @@ dimension as shown in :numref:`fig_wms_qgis3`.

     *WMS loading in QGIS*

-Continue reading to learn about the provided :ref:`downloading` services.
+Continue reading to learn about the provided :ref:`searching` services.
--- a/documentation/users-guide/web-client.rst
+++ b/documentation/users-guide/web-client.rst
@@ -366,5 +366,5 @@ buttons on the right panel of the web client can be used.

   *Web Client - Download multiple products via WCS*

-The following chapters describe the services offered for :ref:`searching`,
-:ref:`viewing`, as well as :ref:`downloading`.
+The following chapters describe the services offered for :ref:`viewing`,
+:ref:`searching`, as well as :ref:`downloading`.