documentation: move markdown syntax documentation and move helper for counting lines

doc/index.rst

@@ -38,6 +38,7 @@ Bienvenue sur la documentation du Sith de l'AE
 	:maxdepth: 2
 	:caption: Divers
 
+	misc/md_syntax
 	misc/helpers
 
 Documentations complémentaires
@@ -68,8 +69,6 @@ Git
 * `Livre sur Git <http://www.git-scm.com/book/fr/v2>`__
 
 
-
-
 Documents téléchargeables
 -------------------------
 

doc/misc/helpers.rst

@@ -1,8 +1,17 @@
 Commandes utiles
 ================
 
-* Appliquer le header de licence sur tout le projet
+Appliquer le header de licence sur tout le projet
+-------------------------------------------------
 
 .. code-block:: bash
 
     for f in $(find . -name "*.py" ! -path "*migration*" ! -path "./env/*" ! -path "./doc/*"); do cat ./doc/header "$f" > /tmp/temp && mv /tmp/temp "$f"; done
+
+Compter le nombre de lignes de code
+-----------------------------------
+
+.. code-block:: bash
+
+  sudo apt install cloc
+  cloc --exclude-dir=doc,env .

doc/misc/md_syntax.rst

@@ -0,0 +1,20 @@
+Syntaxe markdown utilisée dans le site
+======================================
+
+.. note::
+
+	Si vous faites une mise à jour sur le parseur markdown, il est bon de documenter cette mise à jour dans la page de référence *doc/SYNTAX.md*. Mettre à jour ce fichier vas casser les tests si vous ne mettez pas à jour le fichier *doc/SYNTAX.md* qui lui correspond juste après. Pour mettre à jour ce fichier il suffit d'utiliser la commande
+
+	::
+
+		./manage.py markdown > doc/SYNTAX.html
+
+.. warning::
+
+	Le rendu de cette aide est fait via Sphinx, il peut représenter quelques différences avec la réalité. Il est possible de télécharger juste en dessous les versions brutes.
+
+* :download:`Fichier d'aide en markdown <../SYNTAX.md>`
+* :download:`Fichier d'aide rendu en HTML <../SYNTAX.html>`
+
+.. raw:: html
+	:file: ../SYNTAX.html