尚未找到有关如何正确使用 intersphinx 的详细信息。我想组合不同项目(API 后端)中的多个 sphinx 文档,我的结构是:
Projects
├── main_api_name
│ └── docs
│ └── source
│ └── ...
│ └── index.rst
│ └── main_api_name.rst
│ └── build
│ └── lib
│ └── <python files>
├── api_name1
│ └── docs
│ └── source
│ └── ...
│ └── index.rst
│ └── api_name1.rst
│ └── build
│ └── lib
│ └── <python files>
├──
目录中所有项目的所有 sphinx 文档(无论是否生成)Projects我想存储在main_api_name项目中。我在项目中的 index.rst 与:
###########################################
Main API documentation
###########################################
********
Contents
********
.. toctree::
:maxdepth: 2
main_api_name
main_api_name.rst 和 api_name1 和其他看起来像:
<main_api_name>
=============================================
Access actions
##############
.. autoclass:: lib.api_access_actions.API
:members:
Access profiles
###############
.. autoclass:: lib.api_access_profiles.API
:members:
...
总结以上所有内容:我只想将它们组合在一个 sphinx 文档中