📝 new theme for readthedocs, logos, favicon, etc.

- use book theme
- add subsection to menu
- add logo for dark and light mode
- add a favicon
- remove download button
- add section description on index page

7 files changed, 52 insertions, 82 deletions

diff --git a/docs/fr/source/_static/favicon.png b/docs/fr/source/_static/favicon.png
new file mode 100644
index 000000000..c4b51a45e
--- /dev/null
+++ b/docs/fr/source/_static/favicon.png
diff --git a/docs/fr/source/_static/logo-ishtar-dark.png b/docs/fr/source/_static/logo-ishtar-dark.png
new file mode 100644
index 000000000..e79ba96a8
--- /dev/null
+++ b/docs/fr/source/_static/logo-ishtar-dark.png
diff --git a/docs/fr/source/_static/logo-ishtar-light.png b/docs/fr/source/_static/logo-ishtar-light.png
new file mode 100755
index 000000000..d81121346
--- /dev/null
+++ b/docs/fr/source/_static/logo-ishtar-light.png
diff --git a/docs/fr/source/conf.py b/docs/fr/source/conf.py
index 93595d225..f2a8f8d6d 100644
--- a/docs/fr/source/conf.py
+++ b/docs/fr/source/conf.py
@@ -102,12 +102,20 @@ pygments_style = 'sphinx'
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #html_theme = 'default'
-html_theme = "sphinx_rtd_theme"
+#html_theme = "sphinx_rtd_theme"
+html_theme = "sphinx_book_theme"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 #html_theme_options = {}
+html_theme_options = {
+    "use_download_button": False,
+    "logo": {
+        "image_light": "_static/logo-ishtar-light.png",
+        "image_dark": "_static/logo-ishtar-dark.png",
+    }
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = []
@@ -126,7 +134,7 @@ html_theme = "sphinx_rtd_theme"
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-#html_favicon = None
+html_favicon = "_static/favicon.png"
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
@@ -229,5 +237,5 @@ man_pages = [
 
 
 def setup(app):
-   app.add_stylesheet('css/custom.css')
+   app.add_css_file('css/custom.css')
 
diff --git a/docs/fr/source/index.rst b/docs/fr/source/index.rst
index f2c56a0d6..2a28391c7 100644
--- a/docs/fr/source/index.rst
+++ b/docs/fr/source/index.rst
@@ -1,24 +1,53 @@
-.. Ishtar documentation master file, created by
-   sphinx-quickstart on Wed Oct 12 01:01:02 2011.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
+Documentation d'Ishtar
+======================
 
-Bienvenue dans la documentation d'Ishtar !
-==========================================
+Utilisation d'Ishtar
+--------------------
 
-Contents:
+Les sections suivantes décrivent les principes généraux du logiciel et explicitent son fonctionnement.
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
+   :caption: Utilisation
 
    principes
    utilisateur
+
+Installation/configuration
+--------------------------
+
+Les sections suivantes décrivent le paramétrage et l'installation du logiciel. Le paramétrage dit « applicatif » concerne les utilisateurs de l'application disposant d'un profil administrateur. Ce paramétrage se fait au sein de l'application.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Installation/configuration
+
    administrateur-applicatif
    administrateur-serveur
+
+Annexes pour l'utilisateur
+--------------------------
+
+Ces annexes sont à destination des utilisateurs ou des administrateurs applicatifs de l'application.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Annexes pour l'utilisateur
+
    annexe-1-permission-action
    annexe-2-ex-flux-ope
    annexe-3-doc-normes
    annexe-4-champs
+
+Annexes techniques
+------------------
+
+Ces annexes sont à destination de l'administrateur serveur ou concernent des usages avancés pour les administrateurs applicatifs.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Annexes techniques
+
    annexe-tech-1-insee-communes
    annexe-tech-2-ign-communes
    annexe-tech-3-variables-gen
diff --git a/docs/fr/source/utilisateur.rst b/docs/fr/source/utilisateur.rst
index c3659117b..c34d08f63 100644
--- a/docs/fr/source/utilisateur.rst
+++ b/docs/fr/source/utilisateur.rst
@@ -1,8 +1,8 @@
 .. -*- coding: utf-8 -*-
 
-===========
-Utilisateur
-===========
+========================
+Documentation utilisateur
+========================
 
 :Auteur: Étienne Loks
 :Date: 2018-10-02
diff --git a/requirements_rtd.txt b/requirements_rtd.txt
index f6d70f5a8..b5b1f127f 100644
--- a/requirements_rtd.txt
+++ b/requirements_rtd.txt
@@ -1,69 +1,2 @@
-# six>=1.9 -> dépendance supprimée
-
-# gdal==2.4.0
-# 3.2
-
-fiona==1.8.18
-pyproj==3.0.0
-
-# psycopg2-binary==2.8.6 -> no db for readthedocs
-# old 2.7.7
-
-django-registration==3.2
-django==2.2.24
-
-Pillow==8.1.2
-# old 5.4.1
-
-WeasyPrint==0.42.3
-html5lib==1.1
-# old 1.0.1
-pyqrcode==1.2.1
-
-pypng==0.0.20
-# old 0.0.19
-
-xmltodict==0.12
-# old 0.11
-
-requests==2.25
-# old 2.21
-
-# python-memcached==1.59  ## production
-# celery==4.2.1  ## not mandatory
-# 5.0.0
-
-djangorestframework==3.12
-# old 3.9
-
-pytidylib==0.3.2
-lxml==4.6.3
-# old 4.3.2
-MarkupSafe==1.1.1  # force this version for Jinja 2.11
-Jinja2==2.11
-# old 2.10
-django-extra-views==0.13.0
-# old 0.12
-beautifulsoup4==4.9.3
-# old 4.7.1
-markdown==3.3.4
-# old 3.0.1
-django-compressor==2.4
-# old 2.2
-
-django-formtools==2.2
-
-secretary==0.2.19
-unidecode
-# 1.2
-
--e git+https://github.com/jazzband/django-simple-history.git@2.7.0#egg=django-simple-history
-
-django-extensions==3.0.3
-
 sphinx_rtd_theme
-# old 2.1.4
-
-# django-debug-toolbar==3.2.4
-
-django-axes==5.4.3
+sphinx-book-theme