Bonjour à tous [Sphinx 1.1.3, Python 3.2]
je n'arrive pas à comprendre le fonctionnement d'autosummary avec toctree. D'après la documentation (*) les lignes suivantes :
.. autosummary::
:toctree: DIRNAME
sphinx.environment.BuildEnvironment
sphinx.util.relative_uri |
devraient dire à Sphinx que "(some) stub pages should be generated for the entries listed in this directive". Je devrais donc récupérer un lien vers un fichier décrivant sphinx.environment.BuildEnvironment, et un autre lien vers un fichier décrivant sphinx.util.relative_uri.
Or quand j'exécute ce code, j'ai le message d'erreur suivant : "WARNING : toctree references unknown document 'sphinx.util.relative_uri". Ce message indique que autosummary ne cherche pas à créer des pages associées à sphinx.util.relative_uri; au contraire, il cherche le fichier .rst portant le nom de sphinx.util.relative_uri. Par contre je suis sûr qu'il lit correctement les données associées aux fonctions sphinx.util.* puisqu'il affiche dans un tableau la docstring correspondante; simplement, je n'ai pas de lien vers un fichier associé à chaque fonction.
Est-ce moi qui comprend mal la doc' ?
Merci de m'aider !
(*) http://sphinx.pocoo.org/ext/autosu [...] utosummary
---------------
rule #1 : trust the python