From f52307fe435a1d60fa3042b798fa25c0204e7b01 Mon Sep 17 00:00:00 2001
From: Guillaume AGNIERAY <dev@agnieray.net>
Date: Sun, 29 Sep 2019 09:11:16 +0200
Subject: [PATCH 6/9] Update About page content ; fixes #1307

---
 source/about.rst | 116 ++++++++++++++++++++++++++---------------------
 1 file changed, 65 insertions(+), 51 deletions(-)

diff --git a/source/about.rst b/source/about.rst
index 6e6cac1..5626898 100644
--- a/source/about.rst
+++ b/source/about.rst
@@ -6,76 +6,90 @@
 À propos de la Documentation de Galette
 ***************************************
 
-La documentation de `Galette <http://galette.eu>`_, distribuée sous `Licence Creative Commons Paternité - Partage à l'Identique 3.0 non transposé <http://creativecommons.org/licenses/by-sa/3.0/>`_, est rédigée avec la syntaxe `reStructuredText <http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html>`_ et est construite avec `Sphinx <http://sphinx.pocoo.org>`_.
+La documentation de `Galette <https://galette.eu>`_, distribuée sous `Licence Creative Commons Paternité - Partage à l'Identique 3.0 non transposé <https://creativecommons.org/licenses/by-sa/3.0/>`_, est rédigée avec la syntaxe `reStructuredText <http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html>`_ et est construite avec `Sphinx <https://www.sphinx-doc.org>`_.
 
 Récupération des sources
 ========================
 
-Les sources de la documentation sont sous `gestionnaire de versions Git <http://fr.wikipedia.org/wiki/Git>`_ chez `Tuxfamily <http://tuxfamily.net>`_ (grand merci à eux !), vous pouvez au choix :
+Les sources de la documentation sont gérées dans un dépôt `Git <https://fr.wikipedia.org/wiki/Git>`_ hébergé chez `Tuxfamily <https://www.tuxfamily.org>`_ (grand merci à eux !), vous pouvez au choix :
 
-* `parcourir le dépôt Git de galette <http://git.tuxfamily.org/galette/galettedoc>`_,
+* `parcourir le dépôt Git de la documentation de galette <https://git.tuxfamily.org/galette/galettedoc.git>`_,
 * récupérer les sources de la documentation de Galette :
 
   * si vous possédez un compte chez Tuxfamily et que vous faites partie du projet Galette :
 
-  .. code-block:: raw
+  ::
 
      $ git clone ssh://VOTREUSER@git.tuxfamily.org/gitroot/galette/galettedoc.git
 
   * en tant qu'utilisateur anonyme :
 
-  .. code-block:: raw
+  ::
 
      $ git clone git://git.tuxfamily.org/gitroot/galette/galettedoc.git
 
 
-Sphinx permet de construire la documentation sous plusieurs formats depuis les mêmes sources. La documentation de galette est ainsi distribuée en modes texte, HTML et PDF. La version HTML est consultable telle quelle hors-ligne :-)
+Sphinx permet de construire la documentation sous plusieurs formats depuis les mêmes sources. La documentation de Galette est ainsi distribuée aux formats HTML, PDF et EPUB. La version HTML est consultable telle quelle hors-ligne :-)
 
 Construire la documentation
 ===========================
 
-Une fois les sources récupérées, vous pourrez construire la documentation. Toutefois, vous aurez préalablement besoin d'installer au minimum Sphinx sur votre machine, et éventuellement `rst2pdf <http://rst2pdf.googlecode.com/>`_ (si vous souhaitez construire la version PDF).
-
-Depuis le dossier de la documentation, la liste des possibilités peut être affichés en tapant simplement ``make`` :
-
-.. code-block:: raw
-
-   $ make
-   Please use `make <target>' where <target> is one of
-     html       to make standalone HTML files
-     dirhtml    to make HTML files named index.html in directories
-     singlehtml to make a single large HTML file
-     pickle     to make pickle files
-     json       to make JSON files
-     htmlhelp   to make HTML files and a HTML help project
-     qthelp     to make HTML files and a qthelp project
-     devhelp    to make HTML files and a Devhelp project
-     epub       to make an epub
-     latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-     latexpdf   to make LaTeX files and run them through pdflatex
-     text       to make text files
-     man        to make manual pages
-     changes    to make an overview of all changed/added/deprecated items
-     linkcheck  to check all external links for integrity
-     doctest    to run all doctests embedded in the documentation (if enabled)
-
-Pour construire les versions texte, PDF et HTML, on entrera donc :
-
-.. code-block:: raw
-
-   $ make html pdf text
-   sphinx-build -b html -d build/doctrees -D latex_paper_size=a4  source build/html
-   Making output directory...
-   Running Sphinx v1.0.7
-   loading translations [fr]... done
-   loading pickled environment... not yet created
-   building [html]: targets for 17 source files that are out of date
-   [...]
-   Build finished. The HTML pages are in build/html.
-   sphinx-build -b pdf -d build/doctrees -D latex_paper_size=a4  source build/pdf
-   [...]
-   Build finished. The PDF files are in build/pdf.
-   sphinx-build -b text -d build/doctrees -D latex_paper_size=a4  source build/text
-   [...]
-   Build finished. The text files are in build/text.
-
+Une fois les sources récupérées, vous pourrez construire la documentation. Toutefois, vous aurez préalablement besoin d'installer sur votre machine :
+
+* `le logiciel Sphinx <https://www.sphinx-doc.org/en/master/usage/installation.html>`_ pour générer les versions HTML et EPUB,
+* un environnement TeX/LaTeX complet pour générer la version PDF (`TeX Live <https://www.tug.org/texlive/>`_, `MacTEx <https://www.tug.org/mactex/>`_, `MikTeX <https://miktex.org/>`_).
+
+Pour construire la documentation, il faut se placer à la racine du projet (dans le dossier ``galettedoc`` si vous avez cloné le dépôt Git) :
+
+::
+
+   $ git clone git://git.tuxfamily.org/gitroot/galette/galettedoc.git
+     Clonage dans 'galettedoc'...
+     [...]
+     Réception d'objets: 100% (4209/4209), 10.62 MiB | 840.00 KiB/s, fait.
+     Résolution des deltas: 100% (2658/2658), fait.
+
+::
+
+   $ cd galettedoc
+
+Puis il faut lancer la commande ``make`` suivie de la (ou les) version(s) à contruire (``html``, ``epub``, ``latexpdf``). Ainsi, pour construire la documentation dans les trois formats prévus, on lancera la commande :
+
+::
+
+   $ make html epub latexpdf
+     sphinx-build -b html -d build/doctrees  source build/html
+     Running Sphinx v1.8.4
+     loading translations [fr]... done
+     making output directory...
+     building [mo]: targets for 0 po files that are out of date
+     building [html]: targets for 41 source files that are out of date
+     [...]
+     Build finished. The HTML pages are in build/html.
+     sphinx-build -b epub -d build/doctrees  source build/epub
+     Running Sphinx v1.8.4
+     loading translations [fr]... done
+     making output directory...
+     loading pickled environment... done
+     building [mo]: targets for 0 po files that are out of date
+     building [epub]: targets for 41 source files that are out of date
+     [...]
+     Build finished. The epub file is in build/epub.
+     sphinx-build -b latex -d build/doctrees  source build/latex
+     Running Sphinx v1.8.4
+     loading translations [fr]... done
+     making output directory...
+     loading pickled environment... done
+     building [mo]: targets for 0 po files that are out of date
+     building [latex]: all documents
+     [...]
+     Running LaTeX files through pdflatex...
+     [...]
+     pdflatex finished; the PDF files are in build/latex.
+
+Comment Contribuer ?
+====================
+
+`Un gestionnaire de bogues dédié à la documentation <https://bugs.galette.eu/projects/documentation-galette>`_ vous permet de nous signaler tout problème que vous auriez rencontré et aussi nous soummettre les corrections ou autres améliorations que vous souhaiteriez voir intégrer au projet.
+
+Les contributions pour la documentation suivent :doc:`le même modèle que pour le code de Galette <development/contributor>`.
-- 
2.20.1

