Créer des documents différents à partir des mêmes sources ReST (texte conditionnel)

1. Installez Sphinx, et make :

   $ sudo apt install python-sphinx make

2. Créez un projet Sphinx en appliquant tous les choix par défaut :

   $ sphinx-quickstart

3. Ajoutez le contenu suivant au fichier index.rst en respectant bien les indentations :

   .. only:: electrician
   
   .. admonition:: Danger pour les électriciens
   
     Risque d'électrocution
   
     Ne touchez pas les fils électriques.
   
   .. only:: plumber
   
   .. admonition:: Danger pour les plombiers
   
     Risque de noyade
   
     Ne plongez pas dans la piscine.

4. Pour masquer ou non le contenu destiné aux électriciens ou aux plombiers, commentez ou non les lignes suivantes du fichier de configuration conf.py :

   tags.add('electrician')
   tags.add('plumber')

5. Générez votre contenu :

   $ make html

6. Ouvrez le fichier _build/html/index.html sous un navigateur pour visualiser votre contenu.