Ich verwende die Erweiterungen "sphinx api-doc" und "autosummary", um eine API für eine Bibliothek zu dokumentieren, und kann den Zweck von @ nicht wirklich verstehegenerated/ Option unten:

.. autosummary::
   :nosignatures:
   :toctree: generated/

   module.function_1
   module.function_2
   ...

Ich habe gesehen, das ist die Sphinx-Dokumentation und in Bibliotheken wie Pandas. Ich verwende toctree und meine API wird automatisch generiert, aber ich verstehe nicht, was generiert wird. Ich sehe keinen Ordner mit dem Namen "Erzeugt" und weiß nicht, was der Vorteil / Zweck davon ist.

Vielen Dan