Сфинкс: Неизвестный тип директивы "toctree". ошибка в Pycharm, но index.html работает - PullRequest
Новая
       36

Сфинкс: Неизвестный тип директивы "toctree". ошибка в Pycharm, но index.html работает

0 голосов
/ 03 ноября 2018

При работе в Pycharm, режим предварительного просмотра документа, который я создаю в sphinx, показывает: 

System Message: ERROR/3 (<stdin>, line 9)

Unknown directive type "toctree".

..toctree::
  :maxdepth: 2

  file1
  file2

Я включил расширение 'autodoc' в мой файл conf.py. Когда я открываю файл /build/index.html, он работает нормально. Мой вопрос, таким образом: как я могу удалить эту ошибку из режима предварительного просмотра pycharm, чтобы я мог предварительно просмотреть свой документ, не открывая постоянно файл /build/index.html?

1 Ответ

0 голосов
/ 08 августа 2019

Sphinx построен поверх библиотеки Docutils. Директива toctree работает со Sphinx, но не распознается Docutils.

Предварительный просмотрщик PyCharm не использует Sphinx (по крайней мере, в бесплатной версии сообщества); скорее всего, он использует rst2html.py от Docutils.

Эта ветка списка рассылки имеет примерно ту же ошибку: https://mail.python.org/pipermail/python-list/2008-June/493826.html.

...