Python: ¿Cómo puedo definir en la esfinge qué archivos y directorios .rst deben usarse?

¿Cómo puedo definir en la esfinge qué archivos y directorios .rst deben usarse?

Quiero incluir un generador de documentación automático en mi script de prueba / construcción / documentación. sphinx-quickstart se ejecutó en mi área de trabajo y creó un archivo index.rst. Como sphinx utiliza archivos de texto reestructurados para la documentación, navegué por el área de trabajo y los creé manualmente con sphinx-autogen . Resultó en el archivo task.rst (ver más abajo).

Cuando uso ‘make html’ obtengo varias advertencias:

ADVERTENCIA : firma inválida para automodule (u’tasks / add_to_config ‘)

ADVERTENCIA : autodoc no puede importar / encontrar el módulo ‘tasks.add_to_config’, informó un error: “No hay un módulo llamado wl_build.tasks”, verifique su ortografía y sys.path

    ADVERTENCIA : no sé qué módulo importar para autodocumentar u’tasks / add_to_config ‘(intente colocar un “módulo” o una directiva “currentmodule” en el documento, o dar un nombre de módulo explícito)

    Mi index.rst

    Welcome to build's documentation! ==================================== Contents: .. toctree:: :maxdepth: 2 .. automodule:: tasks/add_to_config :members: .. automodule:: tasks/build_egg :members: 

    tareas.rst

     tasks Package ============= :mod:`tasks` Package -------------------- .. automodule:: tasks.__init__ :members: :undoc-members: :show-inheritance: :mod:`add_to_config` Module --------------------------- .. automodule:: tasks.add_to_config :members: :undoc-members: :show-inheritance: :mod:`build_egg` Module ----------------------- .. automodule:: tasks.build_egg :members: :undoc-members: :show-inheritance: 

    Intente reemplazar los caracteres / en su archivo index.rst con puntos ( . )

    Me gusta esto:

     Welcome to build's documentation! ==================================== Contents: .. toctree:: :maxdepth: 2 .. automodule:: tasks.add_to_config :members: .. automodule:: tasks.build_egg :members: 

    A ver si eso ayuda.

    Si Sphinx aún no puede encontrar el código para documentar, entonces probablemente deba modificar su PYTHONPATH o alterar sys.path en su archivo conf.py para ayudar a Sphinx a encontrar lo que está buscando.