Sphinx autosummary "toctree contient des références à inexistants document" mises en garde

j'essaie de créer automatiquement des Docs api pour une grosse base de code python en utilisant Sphinx.

j'ai essayé d'utiliser build_modules.py et sphinx-apidoc. Avec l'un ou l'autre, je peux obtenir des rst docs créés avec succès dans mon répertoire de sortie pour les paquets et les modules de haut niveau.

cependant, quand je construis en utilisant

make html

il donne des milliers d'erreurs de ce type:

<autosummary>:None: WARNING: toctree contains reference to nonexisting document 'rstDocs/src.Example1.class1.method1'

pour chaque une seule classe et méthode dans la base de données. Avec quelques expérimentations, je pense que j'ai découvert que les directives autosummary/autoclass sont en train de créer des toctrees qui s'attendent à ce qu'il y ait des fichiers rst pour chaque classe et chaque méthode.

mis à part les Avertissements, la documentation semble bien fonctionner, mais je voudrais m'en débarrasser et je pense que j'ai peut-être mal configuré quelque chose.

j'ai aussi essayé de nipype/outils à peu près à la même effet.

j'ai modifié apigen.py et build_modref_templates.py pour créer des entailles rst pour chacun de ces documents" manquants", avec autoclass/autofunction/automethods selon le cas. Cependant, la construction prend beaucoup de temps (10 minutes) et finit par s'écraser à cause d'erreurs de mémoire sur la dernière étape de construction.

voici un exemple de fichier RST de module qui crée tous les Avertissements:

src Package
===========

:mod:`src` Package
------------------

.. automodule:: src.__init__
    :members:
    :undoc-members:
    :show-inheritance:

:mod:`Example1` Module
------------------------------------

.. automodule:: src.Example1
    :members:
    :undoc-members:
    :show-inheritance:

:mod:`Example2` Module
------------------

.. automodule:: src.Example2
    :members:
    :undoc-members:
    :show-inheritance:

Merci pour tout conseil sur la façon de faire ces avertissements résoudre! Je voudrais rester à l'écart de toute solution qui implique de modifier les fichiers site-package de sphinx.