4

我正在为一些 python 项目编写文档。我在连接两个或更多文档时遇到问题 - 我有三个 Sphinx 项目（文档），我希望能够在一般文档中添加指向详细文档的链接。

我有这样一个项目结构：

project/
|     doc/                          # this is my general doc
|     |    source/                  # sphinx general doc .rst files are here
|     |     build/
|     |    _static/
|     |    _templates/
|     |    CVS/
|
|
|     forms/
|     |    doc/
|     |    |    source/             # sphinx forms doc .rst files are here
|     |    |     build/
|     |    |    _static/
|     |    |    _templates/
|     |    |    CVS/    
|     |     
|     |    src/                     # forms source .py files are here
|
|     tables/
|     |    doc/
|     |    |    source/             # sphinx tables doc .rst files are here
|     |    |     build/
|     |    |    _static/
|     |    |    _templates/
|     |    |    CVS/    
|     |     
|     |    src/                     # tables source .py files are here

Forms doc 和 Tables doc 都包含从源文件生成的文档，使用

.. automodule::指令。

如何在我的常规文档中创建指向表单和表格文档的链接？

也许我需要重组一些东西？

我已经阅读了一些关于 intersphinx 的内容，但到目前为止，我发现的示例仅显示如何链接到

通过在 sphinx 项目的 conf.py 文件中指定 URL 来编写 Python 标准库文档，如下所示：

intersphinx_mapping = {'python': ('http://docs.python.org/3.2', None)}

我不知道如何用不同于标准库的东西来创建这样的东西，我想

通过相对路径而不是 URL指定其位置- 有什么想法吗？

4

1 回答 1

3

intersphinx 配置中的位置（在您的示例中为“http://docs.python.org/3.2”）实际上可以是任何 URI 或目录的路径，其中有一个名为 objects.inv 的文件，该文件由 HTML 创建builder 并包含名称和链接的注册表。尝试使用类似“../forms/_build/html”的东西。

于 2012-10-08T01:21:10.803 回答