我正在为某个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窗体doc和表doc都包含从源文件生成的文档,并使用
..::指令。
如何在一般文档中创建到表单和表文档的链接?
也许我需要重组什么?
我已经读过一些关于狮身人面像的文章,但到目前为止,我已经找到了一些例子,这些例子只显示了如何链接到
通过在sphinx项目的conf.py文件中指定URL,Python标准库文档如下所示:
intersphinx_mapping = {'python': ('http://docs.python.org/3.2', None)}我不知道如何用标准库以外的东西来创建这样的东西,我想
指定其位置的相对路径,而不是URL -有什么想法吗?
发布于 2012-10-08 01:21:10
intersphinx (在您的示例‘http://docs.python.org/3.2'中)中的位置实际上可以是指向目录的任何URI或路径,其中有一个名为objects.inv的文件,该文件由HTML创建,包含名称和链接的注册中心。尝试使用‘./forms/_build/html’之类的东西。
https://stackoverflow.com/questions/11685896
复制相似问题