Ошибка Sphinx: Неизвестный тип директивы "automodule" или "autoclass"

Мне нужно документировать мой проект Python с помощью Sphinx. Но я не могу использовать autodoc.

Когда я настраиваю свой проект, я выбираю вариант "расширение autodoc", но теперь, если я использую

.. autoclass:: Class

Я получаю сообщение об ошибке:

ERROR: Unknown directive type "autoclass"

Я настраиваю PYTHONPATH, и теперь это хорошо. Но у меня уже есть эта проблема.

Мой индексный файл:

.. ATOM documentation master file, created by
   sphinx-quickstart on Thu Nov 22 15:24:42 2012.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to ATOM documentation!
================================

Contents:

.. toctree::
   :maxdepth: 2

.. automodule:: atom

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

Мне нужно, чтобы кто-то сказал мне, как я могу исправить эту проблему.

Спасибо

Ответ 1

То же самое случилось со мной! Чтобы исправить это, перейдите к строке в conf.py, которая говорит что-то вроде этого:

extensions = ['sphinx.ext.todo', 'sphinx.ext.viewcode']

Вероятно, ваш взгляд будет выглядеть иначе. В любом случае, добавьте 'sphinx.ext.autodoc' в список. например.

extensions = ['sphinx.ext.todo', 'sphinx.ext.viewcode', 'sphinx.ext.autodoc']

Если это было:

extensions = []

то вы измените его на:

extensions = ['sphinx.ext.autodoc']

Источники: Документация Sphinx: ОШИБКА: Неизвестный тип директивы "program-output"