à un projet:
* La documentation de référence du code (documentation des modules, classes et APIs);
*... r Python capable d'extraire les **docstrings** du code afin de produire une documentation de référence e... ment activables.
===== Installer Sphinx =====
<code bash>
# Création d'un environnement virtuel Pytho... te
# Installation de Sphinx
pip install sphinx
</code>
===== Initialiser le répertoire de travail ===
Python et make pour construire la documentation:
<code bash>
sudo apt install build-essential python3 python3-pip python3-venv
</code>
Créer et activer l'environnement virtuel du pro... e [[https://docs.readthedocs.io|read the docs]]
<code bash>
cd my_app
source app_env/bin/activate
pip3 install sphinx sphinx_rtd_theme
</code>
Le script **sphinx-quickstart** assiste l'utili
En bas du fichier de configuration, ajouter le code suivant :
<code python>
# Rendre disponibles certaines variables pour les pages de documentation
varia... s[x]}", variables_to_export))
del frozen_locals
</code>
Dans les fichier sources .rst, on utilisera la
