Merge pull request #5173 from csgis/master

[Fixes #5172] Add docs for thesaurus and fix management command

docs/admin/index.rst

@@ -48,3 +48,11 @@ GeoNode Async Signals
     :maxdepth: 3
 
     async/index
+
+GeoNode add a thesaurus
+=======================
+
+.. toctree::
+    :maxdepth: 3
+
+    thesaurus/index

docs/admin/thesaurus/index.rst

@@ -0,0 +1,63 @@
+Loading a thesaurus
+===================
+
+You can add a thesaurus into you GeoNode using the ``load_thesaurus`` command:
+
+.. code-block:: shell
+
+    python manage.py load_thesaurus --help
+
+    -d, --dry-run         Only parse and print the thesaurus file, without perform insertion in the DB.
+    --name=NAME           Identifier name for the thesaurus in this GeoNode instance.
+    --file=FILE           Full path to a thesaurus in RDF format.
+
+In order add the inspire-themes thesaurus into a geonode instance, download it as file ``inspire-theme.rdf``  with the command:
+
+.. code-block:: shell
+
+    wget -O inspire-theme.rdf https://raw.githubusercontent.com/geonetwork/core-geonetwork/master/web/src/test/resources/thesaurus/external/thesauri/theme/httpinspireeceuropaeutheme-theme.rdf
+
+and then issue the command:
+
+.. code-block:: shell
+
+    python manage.py load_thesaurus --file inspire-theme.rdf --name inspire_themes
+
+The ``name`` is the identifier you'll use to refer to this thesaurus in your GeoNode instance.
+
+
+If you only want to make sure that a thesaurus file will be properly parsed, give the ``--dry-run`` parameter, so that nothing wil be added to the DB.
+
+*Note*: if the ``name`` starts with the string ``fake``, the file will not be accessed at all, and some test keywords will be added to a fake new thesaurus. In this case the ``dry-run`` param will not be used.
+
+
+Configure a thesaurus in GeoNode
+================================
+
+After you loaded a thesaurus into GeoNode, it should be configured in the ``settings.py`` file (or in the ``local_settings``) in this way:
+
+.. code-block:: shell
+
+    THESAURUS = {'name':'THESAURUS NAME', 'required':True|False, 'filter':True|False,}
+
+- ``name``: (mandatory string) the identifier you used in the ``load_thesaurus`` commands.
+- ``required``: (optional boolean) if ``True``, a keyword of this thesaurus is mandatory to complete the metadata. *Currently not implemented.*
+- ``filter``: (optional boolean) if ``True``, a faceted list of keywords of this thesaurus will be presented on the search page.
+
+So, in order to set up the INSPIRE themes thesaurus you may set the THESAURUS value as:
+
+.. code-block:: shell
+
+    THESAURUS = {'name': 'inspire_themes', 'required': True, 'filter': True}
+
+Apply a thesaurus to a resource
+===============================
+
+After you've finished the setup you should find a new input widget in each resource metadata wizard allowing you to choose a thesaurus for your resource.
+
+After applying a thesaurus to resources those should be listed in the filter section in GeoNodes resource list views.
+
+.. figure:: ./img/thesaurus_filter.png
+    :align: center
+    :width: 350px
+    :alt: thesauarus

geonode/base/management/commands/load_thesaurus.py

@@ -91,7 +91,7 @@ def load_thesaurus(self, input_file, name, store):
             raise CommandError("ConceptScheme not found in file")
 
         title = scheme.find('dc:title', ns).text
-        descr = scheme.find('dc:description', ns).text
+        descr = scheme.find('dc:description', ns).text if scheme.find('dc:description', ns) else title
         date_issued = scheme.find('dcterms:issued', ns).text
 
         print 'Thesaurus "{}" issued on {}'.format(title, date_issued)