Вопросы с тегом «autodoc»

6
Автодок Сфинкса не достаточно автоматический
Я пытаюсь использовать Sphinx для документирования проекта на 5000 строк в Python. Имеет около 7 базовых модулей. Насколько я знаю, чтобы использовать autodoc, мне нужно написать такой код для каждого файла в моем проекте: .. automodule:: mods.set.tests :members: :show-inheritance: Это слишком утомительно, потому что у меня много файлов. Было бы …

5
Как использовать автодок Sphinx для документирования метода __init __ (self) класса?
По умолчанию Sphinx не создает документы для __init __ (self). Я пробовал следующее: .. automodule:: mymodule :members: и ..autoclass:: MyClass :members: В conf.py установка следующего только добавляет строку документации __init __ (self) в строку документации класса ( документация Sphinx autodoc, похоже, согласна с тем, что это ожидаемое поведение, но ничего …

7
Ошибка sphinx-build - autodoc не может импортировать / найти модуль
Я пытаюсь начать работать со Sphinx, но у меня постоянные проблемы. Команда: docs/sphinx-quickstart Отвечаю на все вопросы и все работает нормально. Команда: docs/ls Все нормально выглядит. Результат:build Makefile source Команда: sphinx-build -d build/doctrees source build/html Вроде работает. Мне удалось открыть файл index.html и увидеть «оболочку» того, что я хочу. Когда …

7
Как правильно задокументировать параметр ** kwargs?
Я использую sphinx и плагин autodoc для создания документации API для моих модулей Python. Хотя я вижу, как красиво документировать определенные параметры, я не могу найти пример того, как документировать **kwargsпараметр. Есть ли у кого-нибудь хороший пример четкого способа их документировать?
Используя наш сайт, вы подтверждаете, что прочитали и поняли нашу Политику в отношении файлов cookie и Политику конфиденциальности.
Licensed under cc by-sa 3.0 with attribution required.