Python Sphinx exclude patterns

这一生的挚爱 提交于 2020-01-30 04:19:06

问题


I'm generating documentation with Sphinx for project with structure like this :

+ project
|
+- docs
|
+- tests
|
+- workflow -+- definitions -+- <some folders>
             | 
             +- <rest of the project>

I want to exclude tests, and workflow/definition from documentation.

I tried exclude pattern in docs/conf.py

exclude_patterns = ['**/workflow/definitions', 'workflow/definitions', '*workflow/definitions', 'workflow/definitions*', 'workflow/definitions/*', 'workflow/definitions/*.*']

But even though workflow/definitions are still automatically generated.

Could someone show me correct exclude pattern how to ignore 'definitions' folder ?


回答1:


exclude_patterns can be used to exclude source files (reStructuredText files) from processing by sphinx-build.

exclude_patterns has no effect when using sphinx-apidoc to generate reStructuredText files from Python modules (but you can tell sphinx-apidoc that certain pathnames should be excluded from the generation).




回答2:


Docs for exclude_patterns indicate that 'workflow/definitions' should ignore that directory, assuming that the source files all end with .rst.

You can configure the source file suffices as a list:

source_suffix = ['.rst', '.txt']


来源:https://stackoverflow.com/questions/43801615/python-sphinx-exclude-patterns

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!