Не удается заставить работать локальные шаблоны sphinx-apido c - PullRequest
0 голосов
/ 29 апреля 2020

Re: Использование sphinx-apidoc для автоматического создания ссылки API из строк документации через расширение autodoc ...

Я скопировал глобальный шаблон /site-packages/sphinx/templates/apidoc/package.rst_t в локальную папку, и сделал ерунду редактировать. Когда я создавал документы API, бессмысленное редактирование не было видно ie. локальные шаблоны, похоже, не перекрывают глобальные.

Вот мой локальный каталог docs/source:

|_ docs
   |_ source
      |_ templates
      |    package.rst_t
      |_ conf.py
      |_ index.rst

conf.py содержит эту директиву:

templates_path = ['templates']

Я создал документацию по API с помощью этой команды:

sphinx-apidoc -e -M -f --templatedir=./templates -o ./source/autodoc ../myproject

Кто-нибудь может увидеть, что идет не так?

...