From 9fedd1e7d0ac721464c9c3302dba4b09932286d9 Mon Sep 17 00:00:00 2001
From: ynerant <ynerant@crans.org>
Date: Thu, 11 Feb 2021 22:32:40 +0100
Subject: [PATCH] Documentation on documentation

Signed-off-by: ynerant <ynerant@crans.org>
---
 docs/documentation.rst | 37 +++++++++++++++++++++++++++++++++++++
 docs/index.rst         |  1 +
 2 files changed, 38 insertions(+)
 create mode 100644 docs/documentation.rst

diff --git a/docs/documentation.rst b/docs/documentation.rst
new file mode 100644
index 00000000..d1e182fd
--- /dev/null
+++ b/docs/documentation.rst
@@ -0,0 +1,37 @@
+Documentation
+=============
+
+La documentation est gérée grâce à Sphinx. Le thème est le thème officiel de
+ReadTheDocs ``sphinx-rtd-theme``.
+
+Générer localement la documentation
+-----------------------------------
+
+On commence par se rendre au bon endroit et installer les bonnes dépendances :
+
+.. code:: bash
+
+  cd docs
+  pip install -r requirements.txt
+
+La documentation se génère à partir d'appels à ``make``, selon le type de
+documentation voulue.
+
+Par exemple, ``make dirhtml`` construit la documentation web,
+``make latexpdf`` construit un livre PDF avec cette documentation.
+
+
+Documentation automatique
+-------------------------
+
+Ansible compile et déploie automatiquement la documentation du projet, dans
+le rôle ``8-docs``. Le rôle installe dans le bon environnement les dépendances
+nécessaires, puis appelle sphinx pour placer la documentation compilée dans
+``/var/www/documentation`` :
+
+.. code:: bash
+
+  /var/www/note_kfet/env/bin/sphinx-build -b dirhtml /var/www/note_kfet/docs/ /var/www/documentation/
+
+Ce dossier est exposé par ``nginx`` sur le chemin
+`/doc <https://note.crans.org/doc>`_.
diff --git a/docs/index.rst b/docs/index.rst
index ac17e171..d80ad515 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -12,4 +12,5 @@ Des informations complémentaires sont également disponibles sur le `Wiki Crans
    :caption: Développement de la NK20
 
    apps/index
+   documentation
    external_services/index
-- 
GitLab