Skip to content

Commit 8eb9966

Browse files
author
Alessio Fabiani
authored
Merge new docs to master (GeoNode#4513)
* removed step in geonode authentication the folder /data/geoserver-data/geonodeAuthProvider is not more present * Clean docs * Clean docs requirements * Update conf to use rst suffix * Update readthedocs configuration * Add draft ToC skeleton * Usage section structure and new account creation * [New Docs] GeoNode Core > Ubuntu 18.04 * Fix typo * Fix Typos and verbal repitition * Minor correction for GeoNode#4445 Usage TOC structure * Fixed Typo * added settings and fixed typos * Update index.rst Integrated requested changes as commented in the PR * Fixing typos - Interacting with users and groups section * Fixing typos, Data section added * Added info for data ordering * Added prepositions for search ... search for * [New Docs] GeoNode Core Docker up and running (GeoNode#4453) * [New Docs] GeoNode Core Docker up and running * Fixed typos * code highlighted admin / admin * - Finalizing docker guide * - Minor improvements / Adding geonode-project Dosker * Some improvements of syntax * Remove sudo from docker related commands * added list of settings, added explanations, removed contrib settings * ASYNC is false by default * managing documents section * Fixing typos * Fixed typos * Minor improvements * Fixed Typos * Added contributing to translation * Added further descriptions. * Add section for docker install on centos * Added further descriptions to settings * - Minor improvements to install section * Usage docs - Managing Layers section * fixed typos * Fixed typos * Fixed typos * Fixed typos * Added section for styles * Formated lines Default+Env; Added descriptions * address WORKON_HOME variable abuse and unneeded .bashrc tweak * Latest descriptions added. * delete tutorials * Checked Geonode Core installation steps, explicited some steps aboud virtalenvironment * add some create map docs * Added some tips on project install * add docs on map creation * Fixed Typos. * doc fixes to map create * more proper pygdal version filtering * doubled package name removed * warning typo fixed * Doc, Add a permissions section under basic * improved docker documetation, mostly image/container specification * fix 'mkvirtualenv' related documentation * Fixed Typos, finished definitions. * Removed obsolete vars Some vars became obsolete with PR GeoNode@e94244e#diff-e83ce43c45d749c5ff3ee38e4fef0a07L261 I've removed those. * Django 1.11.21 * Django 1.11.21
1 parent fdeed56 commit 8eb9966

File tree

1,522 files changed

+5703
-292082
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,522 files changed

+5703
-292082
lines changed

‎.readthedocs.yml

+19-1
Original file line numberDiff line numberDiff line change
@@ -1 +1,19 @@
1-
requirements_file: ./requirements_docs.txt
1+
# .readthedocs.yml
2+
# Read the Docs configuration file
3+
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
4+
5+
# Required
6+
version: 2
7+
8+
# Build documentation in the docs/ directory with Sphinx
9+
sphinx:
10+
configuration: docs/conf.py
11+
12+
# Optionally build your docs in additional formats such as PDF and ePub
13+
formats: all
14+
15+
# Optionally set the version of Python and requirements required to build your docs
16+
python:
17+
version: 3.7
18+
install:
19+
- requirements: ./requirements_docs.txt

‎docs/about.txt

-67
This file was deleted.

‎docs/about/index.rst

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
What is GeoNode
2+
===============
3+
4+
Current Version and Features
5+
============================
6+
7+
Get in touch with the community
8+
===============================

‎docs/admin/async/index.rst

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
Supervisord and Systemd
2+
=======================
3+
4+
Celery
5+
======
6+
7+
Rabbitmq and Redis
8+
==================

‎docs/admin/index.rst

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
GeoNode Management Commands
2+
===========================
3+
4+
GeoNode Upgrade from older versions
5+
===================================
6+
7+
.. toctree::
8+
:caption: GeoNode Upgrade from older versions
9+
:maxdepth: 3
10+
11+
upgrade/index
12+
13+
GeoNode Async Signals
14+
=====================
15+
16+
.. toctree::
17+
:caption: GeoNode Async Signals
18+
:maxdepth: 3
19+
20+
async/index

‎docs/admin/upgrade/index.rst

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
Upgrade from 2.8.x
2+
==================
3+
4+
Upgrade from 2.7.x
5+
==================
6+
7+
Upgrade from 2.6.x
8+
==================
9+
10+
Upgrade from 2.4.x
11+
==================

‎docs/advanced/components/index.rst

+23
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
Overview
2+
========
3+
4+
Django
5+
======
6+
7+
WebServers
8+
==========
9+
10+
Apache
11+
------
12+
13+
NGINX
14+
-----
15+
16+
GeoServer
17+
=========
18+
19+
Databases
20+
=========
21+
22+
Security with OAuth2
23+
====================

‎docs/advanced/contrib/index.rst

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
GeoSites
2+
========
3+
4+
GeoTiffio
5+
=========
6+
7+
Datastore_shards
8+
================
9+
10+
WorldMap
11+
========

‎docs/advanced/hardening/index.rst

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
Publish on HTTPS
2+
================
3+
4+
OAuth2 Fixtures Update and Base URL Migration
5+
=============================================
6+
7+
GeoNode Security Subsystem
8+
==========================
9+
10+
OAuth2 Tokens and Sessions
11+
==========================

‎docs/advanced/index.rst

+44
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
GeoNode Components and Architecture
2+
===================================
3+
4+
.. toctree::
5+
:caption: GeoNode Components and Architecture
6+
:maxdepth: 3
7+
8+
components/index
9+
10+
Hardening GeoNode
11+
=================
12+
13+
.. toctree::
14+
:caption: Hardening GeoNode
15+
:maxdepth: 3
16+
17+
hardening/index
18+
19+
Social Login
20+
============
21+
22+
.. toctree::
23+
:caption: Social Login
24+
:maxdepth: 3
25+
26+
social/index
27+
28+
LDAP Configuration
29+
==================
30+
31+
.. toctree::
32+
:caption: LDAP Configuration
33+
:maxdepth: 3
34+
35+
ldap/index
36+
37+
GeoNode Django Contrib Apps
38+
===========================
39+
40+
.. toctree::
41+
:caption: GeoNode Django Contrib Apps
42+
:maxdepth: 3
43+
44+
contrib/index

‎docs/advanced/ldap/index.rst

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
Library Dependencies
2+
====================
3+
4+
Installation
5+
============
6+
7+
Configure
8+
=========

‎docs/advanced/social/index.rst

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
Overview
2+
========
3+
4+
Configuration
5+
=============
6+
7+
Linkedin
8+
========
9+
10+
Facebook
11+
========

‎docs/basic/index.rst

+28
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
GeoNode Settings
2+
================
3+
4+
:ref:`settings`
5+
6+
.. toctree::
7+
:hidden:
8+
:maxdepth: 3
9+
10+
settings/index
11+
12+
Customise the Look and Feel
13+
===========================
14+
15+
.. toctree::
16+
:caption: Installation
17+
:maxdepth: 3
18+
19+
theme/index
20+
21+
GeoNode permissions
22+
===================
23+
24+
.. toctree::
25+
:caption: Permissions
26+
:maxdepth: 3
27+
28+
permissions/index

‎docs/basic/permissions/img/add_to_shopping_cart.png

232 KB
Loading

‎docs/basic/permissions/img/change_layer_permissions.png

240 KB
Loading

‎docs/basic/permissions/img/resource_permissions_dialogue.png

150 KB
Loading

‎docs/basic/permissions/img/shopping_cart_permissions.png

204 KB
Loading

‎docs/basic/permissions/index.rst

+64
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
.. _permissions:
2+
3+
===========
4+
Permissions
5+
===========
6+
7+
| Permissions in GeoNode are set per resource, where a resource can be a layer, a map, a document or a service. The way the permissions are set is the same for all of them.
8+
9+
.. warning::
10+
11+
GeoNode has a set of default permissions that are applied on resource creation **when** you don't explicitly declare them.
12+
This is particularly relevant when creating and saving a map, where you won't have the possibility to set the its permissions during the creation phase.
13+
GeoNode can be tuned to make sure that by default the new created resource are not public, this can be done by changing two settings, see `Default view permissions <../settings/index.html#default-anonymous-view-permission>`_ and `Default download permissions <../settings/index.html#default-anonymous-download-permission>`_
14+
15+
Single Resource permissions
16+
---------------------------
17+
18+
| Resource permissions can be generally set from the *resource detail* page. The following figure shows how to open the dialog to set permissions on a layer, the same concept applies to documents and maps.
19+
20+
.. figure:: img/change_layer_permissions.png
21+
:align: center
22+
:width: 500
23+
24+
*Change Layer Permissions*
25+
26+
| The dialog for setting the permission allow a granular selection of each permission type to be applied for users and/or groups, each permission type is grouped in tabs that are expanded on click.
27+
| The text boxes have an autosuggest feature to help the compilation of user names and groups, it starts upon typing.
28+
29+
.. figure:: img/resource_permissions_dialogue.png
30+
:align: center
31+
:width: 500
32+
33+
*Resource Permission Dialogue*
34+
35+
You can set the following types of permissions:
36+
37+
* *View* allows to view the layer;
38+
* *Download* allows to download the layer;
39+
* *Change Metadata* allows to change the layer metadata;
40+
* *Edit Data* allows to change attributes and properties of the layers features;
41+
* *Edit Style* allows to change the layer style;
42+
* *Manage* allows to update, delete, change permissions, publish and unpublish the layer.
43+
44+
.. warning:: When assigning permissions to a group, all the group members will have those permissions. Be careful in case of editing permissions.
45+
46+
Bulk permissions
47+
----------------
48+
49+
| GeoNode offers the possibility to set permissions in bulk, this can be done in any *list* page.
50+
| In order to set bulk permissions you have first to fill the *shopping cart* with the resources you are interested with by clicking the :guilabel:`+` button on the resource snippet.
51+
52+
.. figure:: img/add_to_shopping_cart.png
53+
:align: center
54+
:width: 500
55+
56+
*Add Resource To Shopping Cart*
57+
58+
| Once happy with the selection you can click the :guilabel:`Set Permissions` button under the shopping cart to open the permissions dialogue that will apply the chosen permission to all selected resources.
59+
60+
.. figure:: img/shopping_cart_permissions.png
61+
:align: center
62+
:width: 500
63+
64+
*Sopping Cart Permissions*

0 commit comments

Comments
 (0)