Ich versuche, mit Sphinx ein Projekt mit mehr als 5.000 Zeilen in Python zu dokumentieren. Es hat ungefähr 7 Basismodule. Soweit ich weiß, muss ich für die Verwendung von Autodoc für jede Datei in meinem Projekt folgenden Code schreiben: .. automodule:: mods.set.tests :members:...
Sphinx generiert standardmäßig keine Dokumente für __init __ (self). Ich habe folgendes versucht: .. automodule:: mymodule :members: und ..autoclass:: MyClass :members: Wenn Sie in conf.py Folgendes festlegen, wird nur die __init __ (selbst) docstring an die Klasse docstring angehängt ( die...
Ich versuche mit Sphinx zu beginnen und habe unerbittliche Probleme. Befehl: docs/sphinx-quickstart Ich beantworte alle Fragen und alles funktioniert gut. Befehl: docs/ls Alles sieht normal aus. Ergebnis:build Makefile source Befehl: sphinx-build -d build/doctrees source build/html Es...
Ich verwende Sphinx und das Autodoc-Plugin, um API-Dokumentation für meine Python-Module zu generieren. Ich kann zwar sehen, wie bestimmte Parameter gut dokumentiert werden, aber ich kann kein Beispiel dafür finden, wie ein **kwargsParameter dokumentiert wird. Hat jemand ein gutes Beispiel für...
Ich muss mein Python-Projekt mit Sphinx dokumentieren. Aber ich kann nicht verwenden autodoc. Wenn ich mein Projekt konfiguriere, wähle ich die Option "Erweiterung autodoc", aber jetzt, wenn ich benutze .. autoclass:: Class Ich erhalte eine Fehlermeldung: ERROR: Unknown directive type "autoclass"...
Ich habe eine ganze Weile im Internet nach dem besten Weg gesucht, Rückrufe mit jsdoc richtig zu dokumentieren, aber leider habe ich noch keinen großartigen gefunden. Hier ist meine Frage: Ich schreibe eine Node.js-Bibliothek für Entwickler. Diese Bibliothek bietet mehrere Klassen, Funktionen und...