С Sphinx для Python, как можно избежать того, чтобы все имена методов/функций отсортировались по алфавиту в HTML? Я хочу сохранить их в том же порядке, что и в исходном коде.Python - Как НЕ сортировать выход Sphinx в алфавитном порядке
От sphinx.ext.autodoc documentation:
autodoc_member_order
Это значение выбирает, если автоматически документированные члены сортируются в алфавитном порядке (значение 'алфавитный'), по типу члена (значение 'GROUPWISE') или по заказу источника (значение 'bysource'). Значение по умолчанию - в алфавитном порядке.
Обратите внимание, что для исходного кода модуль должен быть модулем Python с доступным исходным кодом.
Так где-то в файле conf.py, говоря:
autodoc_member_order = 'bysource'
Спасибо @James. Я скучаю по этому. –
Если Sphinx не может найти ваш исходный код, убедитесь, что у вас есть путь, включенный в 'conf.py' через' sys.path.insert (0, os.path.abspath ('путь/в/источник') '. В моем случае этот путь был неправильным, но Sphinx не дал ошибку, потому что модуль был также локально установлен и может быть импортирован без проблем, хотя Sphinx не смог найти исходный код. – eatcrayons