Pytania oznaczone «python-sphinx»

Sphinx to narzędzie ułatwiające tworzenie inteligentnej i pięknej dokumentacji. Sphinx nadaje się szczególnie do dokumentacji Pythona, ale jest to narzędzie ogólnego przeznaczenia, którego można użyć do dokumentowania wszystkiego.

149
Sphinx autodoc nie jest wystarczająco automatyczny

Próbuję użyć Sphinx do udokumentowania ponad 5000 liniowego projektu w Pythonie. Posiada około 7 modułów bazowych. O ile wiem, aby korzystać z autodoc, muszę napisać taki kod dla każdego pliku w moim projekcie: .. automodule:: mods.set.tests :members: :show-inheritance: Jest to zbyt uciążliwe,...

87
Link do metody klasy w docstringu języka Python

Chcę dodać link do metody w mojej klasie z poziomu dokumentacji innej metody tej samej klasy. Chcę, aby link działał w sfinksie, a preferencyjnie również w Spyder i innych Python IDE. Wypróbowałem kilka opcji i znalazłem tylko jedną, która działa, ale jest uciążliwa. Załóżmy, że następująca...