Sphinx¶
Reviewe deine Sphinx-Docs dort, wo sie gelesen werden: auf den gebauten HTML-Seiten. Die deciwa-Erweiterung für Sphinx fügt jeder Seite das Review-Overlay hinzu und kennt die Elemente jeder Seite – Abschnitte, Absätze, Listenpunkte, Tabellenzeilen, Codeblöcke, Hinweise, Bilder und jedes Sphinx-Needs-Objekt über seine ID.
Zwei Arten, es zu betreiben¶
Mit |
Offline |
|
|---|---|---|
Wer |
das Team, das an den Docs arbeitet |
alle mit den gebauten Seiten – auch eine öffentliche Demo |
Feedback wird gespeichert |
in |
im Browser, exportiert als eine Datei |
Neu bauen bei Änderungen |
automatisch, die Seite lädt neu |
dein eigener Build |
KI und CLI sehen Feedback |
sofort |
nach |
Diese Docs mit dem Review-Overlay.¶
Seiten¶
Installation – die Erweiterung und die CLI
Konfiguration – Optionen in
conf.pyund.deciwa/config.tomlWorkflow – ausliefern, reviewen, arbeiten, neu bauen; Offline-Review und Export