Skip to content

Commit 7027b18

Browse files
authored
Update and enhance the deegree quickstart and overview (#885)
* #407 - Update and enhance the deegree quickstart and overview for OSGeoLive 17.0 and deegree 3.6.0-pre2
1 parent 619a727 commit 7027b18

File tree

11 files changed

+238
-144
lines changed

11 files changed

+238
-144
lines changed
Loading
Loading
Loading
Loading
Loading

doc/overview/deegree_overview.rst

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
:Author: Johannes Wilden
22
:Author: Markus Schneider
33
:Author: Danilo Bretschneider
4-
:Auhtor: Julian Zilz
4+
:Author: Julian Zilz
55
:Reviewer: Cameron Shorter, Jirotech
66
:Reviewer: Angelos Tzotsos, OSGeo
7-
:Version: osgeolive15.0
7+
:Version: osgeolive17.0
88
:License: Creative Commons Attribution 3.0 Unported (CC BY 3.0)
99

1010
@LOGO_deegree@
@@ -18,7 +18,7 @@ About
1818
--------------------------------------------------------------------------------
1919

2020

21-
deegree provides geospatial webservices based upon |OGC| and `INSPIRE Network Services <https://inspire.ec.europa.eu>`_
21+
deegree provides geospatial webservices based upon |OGC| and `INSPIRE Network Services <https://inspire.ec.europa.eu>`__
2222
specifications. deegree supports:
2323

2424
* |WFS|: Serves vector data from geospatial data
@@ -35,10 +35,10 @@ Core Features
3535
**WFS**
3636

3737
* Implements WFS standards 1.0.0, 1.1.0 and 2.0.0
38-
* Official OGC reference implementation for WFS 1.1.0 (Basic and Transactional) and WFS 2.0.0 (Basic)
38+
* Official OGC reference implementation for WFS 1.0.0 (Transactional), 1.1.0 (Basic and Transactional) and WFS 2.0.0 (Basic)
3939
* Fully transactional (even for rich data models)
4040
* Supports KVP, XML and SOAP requests
41-
* GML 2/3.0/3.1/3.2 output/input
41+
* Supports GML 2, 3.0, 3.1, and 3.2 for both output and input
4242
* Support for GetGmlObject requests and XLinks
4343
* High performance and excellent scalability
4444
* On-the-fly coordinate transformation
@@ -67,7 +67,7 @@ Core Features
6767
**WMTS**
6868

6969
* Implements Basic WMTS standard 1.0.0 (KVP)
70-
* Official OGC reference implementation for WMS 1.0.0
70+
* Official OGC reference implementation for WMTS 1.0.0
7171
* High performance and excellent scalability
7272
* Supports different backends, such as GeoTIFF, remote WMS or file system tile image hierarchies
7373
* Supports on-the-fly caching (using EHCache)
@@ -80,7 +80,7 @@ Core Features
8080
* Supports KVP, XML and SOAP requests
8181
* High performance and excellent scalability
8282
* ISO Metadata Application Profile 1.0.0
83-
* Pluggable and modular dataaccess layer allows to add support for new APs and backends
83+
* Pluggable and modular data access layer allows to add support for new APs and backends
8484
* Modular inspector architecture allows to validate records to be inserted against various criteria
8585
* Standard inspectors: schema validity, identifier integrity, INSPIRE requirements
8686
* Handles all defined queryable properties (for Dublin Core as well as ISO profile)
@@ -105,7 +105,7 @@ Implemented Standards
105105

106106
* |WFS| 1.0.0, 1.1.0 and 2.0.0
107107
* |WMS| 1.1.1 and 1.3.0
108-
* |WMTS| 1.1.0
108+
* |WMTS| 1.0.0
109109
* |CSW| 2.0.2
110110
* |WPS| 1.0.0
111111
* |GML| 2.12, 3.0.1, 3.1.1 and 3.2.1
@@ -130,6 +130,6 @@ Details
130130
@QUICKSTART_deegree@
131131

132132
.. presentation-note
133-
deegree is another robust application which has claimed the title of supporting the most comprehensive set of OGC
134-
Web Services in free and open source software, ranging from a transactional Web Feature Service to three-dimensional
135-
data display in a Web Terrain Service and many more!
133+
deegree is another robust application which has claimed the title of supporting the most comprehensive set of OGC
134+
Web Services in free and open source software, ranging from a transactional Web Feature Service to executing
135+
geospatial processes with a Web Processing Service and many more!

doc/quickstart/deegree_quickstart.rst

Lines changed: 45 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
:Author: Torsten Friebe
44
:Author: Julian Zilz
55
:Reviewer: Felicity Brand (Google Season of Docs 2019)
6-
:Version: osgeolive15.0
6+
:Version: osgeolive17.0
77
:License: Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
88

99
@LOGO_deegree@
@@ -17,65 +17,81 @@
1717
********************************************************************************
1818

1919
*deegree* is open source software for spatial data infrastructures and the
20-
geospatial web. *deegree* is a Java application for serving maps (and vector data) for other clients to show.
20+
geospatial web. *deegree* is a Java application for serving maps (and vector data) for other clients to visualize.
2121

2222
Available components are:
2323

24-
* Web-Services: WFS, WMS, WMTS, CSW, WPS
24+
* Web services: WFS, WMS, WMTS, CSW, WPS
2525

26-
*deegree 3* is the new generation of the deegree Java framework for GIS
27-
applications and OGC-service implementations.
26+
*deegree 3.6.0-pre2* is the newest pre-release version of the deegree Java framework for GIS applications and OGC-service implementations.
2827
It can be used to build web-based geospatial-data-infrastructures (GDI).
2928

30-
.. contents:: Contents
29+
.. contents:: **Contents**
3130
:local:
3231

33-
Start deegree 3 webservices
32+
Start deegree webservices
3433
===========================
3534

3635
Choose |menu_deegree-Start|.
3736
The application will take a few moments to start up.
3837

39-
Firefox opens the *deegree 3 services console*. (You can also open this manually by pointing your browser to http://localhost:8033).
40-
This is a simple web-based GUI for editing the configuration files of the *deegree workspace*.
38+
Firefox opens the *deegree webservices administration console*. Alternatively, you can also open this manually by pointing your browser to http://localhost:8080/deegree.
39+
The administration console is a simple web-based GUI for editing the configuration files of the activated *deegree workspace*.
4140

4241
Load a workspace
4342
================
4443

45-
*deegree 3* uses configurations conformant to all *deegree 3* based webservices. Those configurations are stored in the workspace.
44+
*deegree* uses configurations conformant to all *deegree* based webservices. Those configurations are stored in the workspace.
4645

4746
#. To manage the included and ready-to-use workspaces, click *'workspaces'* on the left side. You are now in the workspace management of the running *deegree* instance.
48-
You can see which workspace is currently active (only one can be active at a time) workspace, inactive locally available workspaces and offical workspaces which can be imported if you have a internet connection.
49-
#. Press start on the *deegree-workspace-utah-light*.
47+
You can see which workspace is currently active (only one can be active at a time) workspace, inactive locally available workspaces and official workspaces which can be imported if you have a internet connection.
48+
#. Press start on the *deegree-workspace-utah-light* workspace.
5049

51-
The demo workspace contains a web mapping setup based on data from the state of Utah.
52-
It contains a WMS configuration (1.3.0 and 1.1.1) consisting of vector layers and a variety of render styles.
53-
Additionally, a WFS (2.0.0, 1.1.0 and 1.0.0) is configured that allows to access the raw vector data, backed by shapefiles, in GML format.
50+
* The demo workspace contains a web mapping setup based on data from the state of Utah. It contains a WMS configuration (1.3.0 and 1.1.1) consisting of vector layers and a variety of render styles. Additionally, a WFS (2.0.0, 1.1.0 and 1.0.0) is configured that allows to access the raw vector data, backed by shapefiles, in GML format.
5451

55-
.. tip::
56-
For additional configuration examples including raster data,
57-
you can import the workspace *deegree-workspace-utah* through the workspace management (internet connection is required).
52+
.. image:: /images/projects/deegree/deegree_workspace.png
53+
:scale: 70 %
54+
:alt: deegree workspaces management
5855

59-
View a map
56+
**Tip:**
57+
For additional configuration examples including raster data, you can import the workspace *deegree-workspace-utah* through the workspace management (internet connection is required).
58+
59+
Visualize the data
6060
==========
6161

62-
#. Click on *'see layers'* to open a simple map-client. The service is configured to visualize the data and a basemap (rendered by `OpenStreetMap <https://www.openstreetmap.org/>`_).
62+
#. Click on *'web services'* to display all the preconfigured web services (WFS and WMS).
63+
64+
.. image:: /images/projects/deegree/deegree_webservices.png
65+
:scale: 70 %
66+
:alt: deegree web services
67+
68+
#. Click on the *'Capabilities'* button of the preconfigured WMS. The GetCapabilities document of the WMS will open in a new tab.
6369

64-
#. Click on the **+** on the right side to open a layer tree showing all available layers. You can activate the a variety of layers served by the deegree WMS here.
70+
.. image:: /images/projects/deegree/deegree_capabilities.png
71+
:scale: 70 %
72+
:alt: deegree WMS capabilities
6573

66-
.. tip::
67-
The map client is based on `OpenLayers <https://openlayers.org/>`_.
68-
You can pan through the map holding the left mouse button and drag the map.
69-
Zooming is possible via mouse wheel or the navigation elements on the left side.
74+
#. Use the GetCapabilities request URL to add the WMS to for example :doc:`QGIS <qgis_overview>`. Once added, you can choose of a variety of layers served by the deegree WMS here.
75+
76+
.. image:: /images/projects/deegree/deegree_wms_qgis.png
77+
:scale: 70 %
78+
:alt: deegree WMS in QGIS
7079

7180
What next?
7281
==========
7382

74-
This was just a short introduction to the features of deegree 3.
75-
There is more information in the demo installations and on the deegree website.
83+
This was a brief introduction to deegree's core features.
84+
Further information and comprehensive documentation of all functionalities are available on the deegree website.
7685

7786
* deegree website - Available here: https://www.deegree.org
7887

79-
* deegree documentation - Available here: https://www.deegree.org/documentation/
88+
* deegree documentation - Available here: https://www.deegree.org/documentation
89+
90+
* deegree workshop (INSPIRE) - Available here: https://github.com/lat-lon/deegree-workshop
91+
92+
* deegree Soildata Assimilation Guidance https://ejpsoil.github.io/soildata-assimilation-guidance/cookbook/deegree.html
8093

81-
* deegree docker images - Available here: https://hub.docker.com/r/deegree/deegree3-docker/
94+
* deegree docker images - Available here:
95+
* deegree webservices - https://hub.docker.com/r/deegree/deegree3-docker
96+
* deegree OGC API - https://hub.docker.com/r/deegree/deegree-ogcapi
97+

locale/en/LC_MESSAGES/overview/deegree_overview.po

Lines changed: 20 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: OSGeoLive 17.0.0\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2024-08-17 15:05-0600\n"
11+
"POT-Creation-Date: 2024-11-18 16:56+0000\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language: en\n"
@@ -17,7 +17,7 @@ msgstr ""
1717
"MIME-Version: 1.0\n"
1818
"Content-Type: text/plain; charset=utf-8\n"
1919
"Content-Transfer-Encoding: 8bit\n"
20-
"Generated-By: Babel 2.14.0\n"
20+
"Generated-By: Babel 2.16.0\n"
2121

2222
#: ../../build/doc/overview/deegree_overview.rst:21
2323
msgid "deegree"
@@ -30,8 +30,8 @@ msgstr ""
3030
#: ../../build/doc/overview/deegree_overview.rst:27
3131
msgid ""
3232
"deegree provides geospatial webservices based upon |OGC| and `INSPIRE "
33-
"Network Services <https://inspire.ec.europa.eu>`_ specifications. deegree"
34-
" supports:"
33+
"Network Services <https://inspire.ec.europa.eu>`__ specifications. "
34+
"deegree supports:"
3535
msgstr ""
3636

3737
#: ../../build/doc/overview/deegree_overview.rst:30
@@ -71,8 +71,8 @@ msgstr ""
7171

7272
#: ../../build/doc/overview/deegree_overview.rst:48
7373
msgid ""
74-
"Official OGC reference implementation for WFS 1.1.0 (Basic and "
75-
"Transactional) and WFS 2.0.0 (Basic)"
74+
"Official OGC reference implementation for WFS 1.0.0 (Transactional), "
75+
"1.1.0 (Basic and Transactional) and WFS 2.0.0 (Basic)"
7676
msgstr ""
7777

7878
#: ../../build/doc/overview/deegree_overview.rst:49
@@ -86,7 +86,7 @@ msgid "Supports KVP, XML and SOAP requests"
8686
msgstr ""
8787

8888
#: ../../build/doc/overview/deegree_overview.rst:51
89-
msgid "GML 2/3.0/3.1/3.2 output/input"
89+
msgid "Supports GML 2, 3.0, 3.1, and 3.2 for both output and input"
9090
msgstr ""
9191

9292
#: ../../build/doc/overview/deegree_overview.rst:52
@@ -199,7 +199,7 @@ msgid "Implements Basic WMTS standard 1.0.0 (KVP)"
199199
msgstr ""
200200

201201
#: ../../build/doc/overview/deegree_overview.rst:80
202-
msgid "Official OGC reference implementation for WMS 1.0.0"
202+
msgid "Official OGC reference implementation for WMTS 1.0.0"
203203
msgstr ""
204204

205205
#: ../../build/doc/overview/deegree_overview.rst:82
@@ -234,8 +234,8 @@ msgstr ""
234234

235235
#: ../../build/doc/overview/deegree_overview.rst:93
236236
msgid ""
237-
"Pluggable and modular dataaccess layer allows to add support for new APs "
238-
"and backends"
237+
"Pluggable and modular data access layer allows to add support for new APs"
238+
" and backends"
239239
msgstr ""
240240

241241
#: ../../build/doc/overview/deegree_overview.rst:94
@@ -319,7 +319,7 @@ msgid "|WMS| 1.1.1 and 1.3.0"
319319
msgstr ""
320320

321321
#: ../../build/doc/overview/deegree_overview.rst:118
322-
msgid "|WMTS| 1.1.0"
322+
msgid "|WMTS| 1.0.0"
323323
msgstr ""
324324

325325
#: ../../build/doc/overview/deegree_overview.rst:119
@@ -370,6 +370,15 @@ msgstr ""
370370
msgid ":doc:`Quickstart documentation <../quickstart/deegree_quickstart>`"
371371
msgstr ""
372372

373+
#: ../../build/doc/overview/deegree_overview.rst:148
374+
msgid ""
375+
"deegree is another robust application which has claimed the title of "
376+
"supporting the most comprehensive set of OGC Web Services in free and "
377+
"open source software, ranging from a transactional Web Feature Service to"
378+
" executing geospatial processes with a Web Processing Service and many "
379+
"more!"
380+
msgstr ""
381+
373382
#: ../../build/doc/<rst_epilog>:13
374383
msgid "vmdk"
375384
msgstr ""

0 commit comments

Comments
 (0)