Une documentation sur le module RTD?

Question

Nous avons un ensemble de modules Ansible sur GitHub (https://github.com/zhmcclient/zhmc-ansible-modules) et pouvons générer une documentation HTML à partir de Sphinx. Toutefois, le processus de génération inclut une étape où un outil documentationgenerator d'Ansible est exécuté pour générer des fichiers .rst à partir de la source du module Python.

Nous avons mis en place un projet RTD pour cela (http://zhmc-ansible-modules.readthedocs.io/), mais cette étape supplémentaire n'est pas exécutée ici, bien sûr.

-> Comment pouvons-nous obtenir cette étape supplémentaire dans le processus de construction qui fonctionne sur RTD?

Answer 1

RTD ne prend pas en charge les étapes intermédiaires dans son processus de construction. Vous devez fournir des fichiers source dans votre référentiel prêts à être rendus. Voir RTD Build Process.