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
Кто-нибудь может увидеть, что идет не так?