make html, при условии, что ты создал makefile. Нет, тогда man sphinx-build. Makefile, ЕМНИП, генерируется с помощью sphinx-quickstart.

А в ответ пустота

make html

А толку? В index.html «пусто». Страница есть, но там нет упоминания ни одного модуля, функции или класса. Я так понимаю sphinx создаёт HTML из *.rst, а в них ничего. Так что надо разобраться почему sphinx-apidoc ничего не пишет в rst.

Всё правильно он туда пишет. Тогда скидывай конфиг, как запускал и лог сборки.

sphinx-apidoc

Тогда скидывай конфиг, как запускал и лог сборки.

sphinx-apidoc запускается без конфига.

sphinx-apidoc -o docs ./

RTFM!

Задача sphinx-apidoc просканировать модули и создать rst файлы, содержащие директивы, необходимые для вот этого расширения: http://sphinx-doc.org/ext/autodoc.html

Так что с rst у тебя всё в порядке.

Создаёшь конфиг, подключаешь расширение autodoc и выполняешь make html или sphinx-build

Возможно потребуется что-то ещё. Лучше почитай документацию или загугли руководство, где всё уже до меня разжевали.

Ну вот что ему не так?

$ sphinx-build -b html -d _build/doctrees/ ./ _build/html/
Running Sphinx v1.1.3
loading pickled environment... not yet created
building [html]: targets for 5 source files that are out of date
updating environment: 5 added, 0 changed, 0 removed
usage: sphinx-build [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
   or: sphinx-build --help [cmd1 cmd2 ...]
   or: sphinx-build --help-commands
   or: sphinx-build cmd --help

error: option -b not recognized

Какого чёрта "-b not recognized"?

А без -b html что говорит? html используется по умолчанию.

Честно говоря, впервые с таким сталкиваюсь. Беглый гуглинг показал, что вероятно есть какой-то конфликтующий код, выполняющийся при импортировании, который следует обернуть в условие if __name__ == '__main__':

Python говно

А без -b html что говорит? html используется по умолчанию.

Без -b html говорит, что -d not recognized.

код...обернуть в условие if __name__ == '__main__':

Код скриптов обёрнут в это условие, код библиотечных модулей не имеет такой обёртки, но и не должен иметь (хотя может).

Честно говоря, впервые с таким сталкиваюсь.

Честно говоря, я тоже. Я кое как заставил этот кусок говна (sphinx) работать, сначала документировал Hello World складывая всё в корень, потом заставил работать с моим кодом, потом подобрал набор заклинаний для переноса документации в отдельную директорию, где ей и место. Но я совершенно не ожидал что столь необходимый инструмент для столь популярного языка окажется настолько кривым и дурно пахнущим, ошибки неожиданными, а сообщения об ошибках совершенно бесполезными. Меня не покидает мнение, что значительная часть пейтонистов говноеды.

Но в любом случае спасибо вам за помощь.

У большинства всё работает. Возможно имеет смысл отрепортить авторам сего поделия, может они что подскажут.

По поводу багов. Не сфинксом едины. В setuptools к примеру тоже порой странные баги возникают, которые фиксятся порядком указания зависимостей, например. Я очень удивился, что оно при поиске пакетов парсит html регулярками(!). Правда это в distutils вроде происходит, уже не помню, но сути не меняет.