Merge pull request #165 from ESA-APEx/guide_fixes

guides: updated structure

Author: JanssenBrm

.gitignore

@@ -15,3 +15,5 @@ venv*
 package-lock.json
 package.json
 node_modules
+
+**/*.quarto_ipynb

_quarto.yml

@@ -57,45 +57,51 @@ website:
           - href: propagation/enhancement.md
           - href: propagation/toolboxcloud.md
           - href: propagation/intercomparison.md
-      - section: Developer Guides
+      - section: Guides
         contents:
-          - section: Authentication
+          - section: Developer Guides
             contents:
-              - href: guides/account.md
-              - href: guides/token.md
-                text: Creating APEx single sign-on token
-          - section: openEO
+              - section: Authentication
+                contents:
+                  - href: guides/account.md
+                  - href: guides/token.md
+                    text: Creating APEx single sign-on token
+              - section: openEO
+                contents:
+                  - href: guides/udp_writer_guide.qmd
+                    text: Creating openEO based services
+                  - href: guides/upscaling_openeo.ipynb
+                    text: Upscaling openEO based services
+              - section: EOAP
+                contents:
+                  - href: guides/eoap_writer_guide.md
+                    text: Creating EOAP based services
+              - section: APEx Product Catalogue
+                contents:
+                  - href: guides/stac_catalog_ingest.ipynb
+                    text: Ingesting STAC metadata in APEx Product Catalogue
+                  - href: guides/catalog_openeo.ipynb
+                    text: Linking APEx Product Catalogue with an openEO service
+              - section: APEx Algorithm Services Catalogue
+                contents:
+                  - href: guides/algorithm_services_catalogue.qmd
+                  - href: guides/algorithm_services_catalogue_benchmarks.qmd
+              - href: guides/file_formats.qmd
+                text: File format recommendations
+          - section: Admin Guides
             contents:
-              - href: guides/udp_writer_guide.qmd
-                text: Creating openEO based services
-              - href: guides/upscaling_openeo.ipynb
-                text: Upscaling openEO based services
-          - section: EOAP
-            contents:
-              - href: guides/eoap_writer_guide.md
-                text: Creating EOAP based services
-          - section: APEx Product Catalogue
-            contents:
-              - href: guides/stac_catalog_ingest.ipynb
-                text: Ingesting STAC metadata in APEx Product Catalogue
-              - href: guides/catalog_openeo.ipynb
-                text: Linking APEx Product Catalogue with an openEO service
-          - section: APEx Algorithm Services Catalogue
-            contents:
-              - href: guides/algorithm_services_catalogue.qmd
-              - href: guides/algorithm_services_catalogue_benchmarks.qmd
-          - href: guides/file_formats.qmd
-            text: File format recommendations
-      - section: User Guides
-        contents:
-          - href: guides/custom_domain.md
-            text: Custom domains for your project environment
-          - href: guides/geospatial_explorer/index.qmd
-            contents:
-              - auto: guides/geospatial_explorer/tutorials/*.qmd
-          - href: guides/project_portal/index.qmd
+              - href: guides/custom_domain.md
+                text: Custom domains for your project environment
+              - href: guides/geospatial_explorer/index.qmd
+                contents:
+                  - auto: guides/geospatial_explorer/tutorials/*.qmd
+              - href: guides/project_portal/index.qmd
+                contents:
+                  - auto: guides/project_portal/tutorials/*.qmd
+
+          - section: Consumer Guides
             contents:
-              - auto: guides/project_portal/tutorials/*.qmd
+              - href: guides/geospatial_explorer/geospatial_explorer_guide.qmd
 
       - href: interoperability/index.md
         section: Interoperability and Compliance Guidelines

…/tutorials/geospatial_explorer_guide.qmd …l_explorer/geospatial_explorer_guide.qmdguides/geospatial_explorer/tutorials/geospatial_explorer_guide.qmd renamed to guides/geospatial_explorer/geospatial_explorer_guide.qmd guides/geospatial_explorer/tutorials/geospatial_explorer_guide.qmd renamed to guides/geospatial_explorer/geospatial_explorer_guide.qmd

@@ -2,14 +2,14 @@
 title: Using the Geospatial Explorer
 ---
 
-The [**APEx Geospatial Explorer**](../../../instantiation/geospatial_explorer.md) is a web map application with a configurable
+The [**APEx Geospatial Explorer**](../../instantiation/geospatial_explorer.md) is a web map application with a configurable
 user interface that can be used to showcase the results of ESA projects as interactive maps, tables and charts.  This user
 guide provides some general user guidance for a number of supported features.
 
 :::{.callout-note}
 Users should be aware that the configuration of any specific Geospatial Explorer page will determine
 what is available on a case by case basis.  Examples of instantiated versions of the Geospatial Explorer are
-listed [here](../../../instantiation/geospatial_explorer.md#examples) on the project overview page.
+listed [here](../../instantiation/geospatial_explorer.md#examples) on the project overview page.
 :::
 
 ## Navigating around the map
@@ -37,19 +37,19 @@ of your current cursor location at the bottom right.
 The left hand panel of the Geospatial Explorer is used to add data to the map.  Typically data is organised into
 **layer groups**.
 
-![Layer groups](../images/groups.jpg)
+![Layer groups](./images/groups.jpg)
 
 Clicking on a specific layer group expands the layers within that group and displays a brief description of what
 that layer comprises.
 
-![Expanded layer groups](../images/expanded.jpg)
+![Expanded layer groups](./images/expanded.jpg)
 
 To add the data on to the map, use the toggle button. Once a layer is toggled on the layer panel will expand to
 show you more information about the layer - for example, a legend to help you interpret the map.  If it has been
 configured you may also see an attribution link, which may link you out to a project page or metadata record about
 the layer.  The example below has been linked to the **World Cover** website.
 
-![Layer displayed with legend and attribution statement](../images/toggled-on.jpg)
+![Layer displayed with legend and attribution statement](./images/toggled-on.jpg)
 
 In some cases, according to how the explorer has been configured **switching one layer on may switch others off**.
 These *mutually exclusive* groups are often set up when it only makes sense to show one layer at a time, because
@@ -61,7 +61,7 @@ In some circumstances a layer may have been configured to include an **opacity**
 that allows you to change the level of opacity to make the layer partially transparent, allowing you to view other
 map layers (such as background mapping) beneath the layer.
 
-![Opacity slider](../images/opacity.jpg)
+![Opacity slider](./images/opacity.jpg)
 
 ## Layer "info" box
 
@@ -70,7 +70,7 @@ Demo](https://explorer.sef-food.apex.esa.int/)) clicking on the map drops a mark
 the *latitude, longitude* and *data value* at the marker location, allowing you to display the precise value of
 the data at that point.
 
-![Layer info box](../images/infobox.jpg)
+![Layer info box](./images/infobox.jpg)
 
 ## Split screen view
 
@@ -80,7 +80,7 @@ a future release it will be possible for you to choose your own pair of layers t
 When you are in a split screen mode, the slider at the bottom of the map allows you to "swipe" from left to right
 to compare the two layers with one another.
 
-![Split screen view](../images/splitscreen.jpg)
+![Split screen view](./images/splitscreen.jpg)
 
 ## Statistics
 
@@ -89,7 +89,7 @@ Statistical data can also be displayed in the Geospatial Explorer as tables, cha
 regional or local boundaries) or natural (e.g. river basins).  The statistics that are available will depend on
 what the administrator of the Geospatial Explorer has defined for you.
 
-![Statistics](../images/statistics.jpg)
+![Statistics](./images/statistics.jpg)
 
 To access these, simply *click on a polygon* to display the statistics panel and then select from the table,
 bar or pie chart options.

instantiation/geospatial_explorer.md

@@ -32,7 +32,7 @@ rendered in the Explorer.
 
 ## User Guide
 
-For a general overview of features, take a look at the [Geospatial Explorer User Guide](../guides/geospatial_explorer/tutorials/geospatial_explorer_guide.qmd)
+For a general overview of features, take a look at the [Geospatial Explorer User Guide](../guides/geospatial_explorer/geospatial_explorer_guide.qmd)
 
 ## Recommendations