wikinotes

Outils pour utilisateurs

Outils du site

Piste : • variables_environnement • relation_one-to-many • relation_many-to-many
dev:python:frameworks:flask:integrer-documentation-sphinx-dans-application-flask

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
dev:python:frameworks:flask:integrer-documentation-sphinx-dans-application-flask [2025/09/20 11:56] – yoanndev:python:frameworks:flask:integrer-documentation-sphinx-dans-application-flask [2025/10/05 10:33] (Version actuelle) – yoann
Ligne 8: Ligne 8:
 [[dev:python:sphinx:introduction|Sphinx]] permet de générer de la documentation dans différents formats. Ici on souhaite produire de la documentation au format HTML et la servir via l'application Flask. [[dev:python:sphinx:introduction|Sphinx]] permet de générer de la documentation dans différents formats. Ici on souhaite produire de la documentation au format HTML et la servir via l'application Flask.
  
-Pour que Flask soit en mesure de servir les fichiers, on configurera Sphinx qu'il génère les fichiers de documentation dans un sous-répertoire du dossier ''./static'' de l'application Flask.+Pour que Flask soit en mesure de servir les fichiers, on configurera Sphinx pour qu'il génère les fichiers de documentation dans un sous-répertoire du dossier ''./static'' de l'application Flask.
  
  
Ligne 16: Ligne 16:
 pip install sphinx sphinx_rtd_theme pip install sphinx sphinx_rtd_theme
 </code> </code>
 +
 +A la racine du projet, exécuter le script **sphinx-quickstart** :
 +<code bash>
 +sphinx-quickstart
 +</code>
 +
 +Le script fonctionne en mode interactif et propose de choisir des options :
 +  * A la question "Séparer les répertoires source et de sortie" réponse "y"
 +
 +Le script initialise l'arborescence nécessaire au bon fonctionnement de Sphinx notamment les dossiers ''source'' et ''build''.
 +
 +Dans notre cas le dossier par défaut ''./build'' ne sera pas utilisé, on le supprime :
 +<code bash>
 +rmdir build/
 +</code>
 +
 +Sphinx crée par défaut un dossier nommé "source" pour regrouper les fichiers sources permettant de produire  la documentation. Pour éviter toute confusion avec les sources de l'application Flask, on préfère ici le renommer "docs" :
 +
 +<code bash>
 +mv source docs
 +</code>
 +
 +Dans le fichier ''Makefile'' à la racine du projet, modifier les valeurs des variables **SOURCEDIR** et **BUILDDIR** :
 +
 +<file>
 +SOURCEDIR     = docs
 +BUILDDIR      = app/static/docs
 +
 +</file>
 +
 +On peut maintenant générer la documentation depuis la racine du projet :
 +
 +<code bash>
 +make html
 +</code>
 +
  
  
dev/python/frameworks/flask/integrer-documentation-sphinx-dans-application-flask.1758369382.txt.gz · Dernière modification : 2025/09/20 11:56 de yoann

Outils de la page

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : GNU Free Documentation License 1.3
GNU Free Documentation License 1.3 Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki