我正在记录一个包含Python组件和JavaScript组件的库。整个用户文档和pythonapi文档都在structuredText中,由Sphinx处理。JavaScript API在jsdoc中,由jsdoc工具箱处理。主要输出格式为HTML。我是新来休息的,斯芬克斯和jsdoc。
我已经建立了一个构建系统,所有生成的html页面都被转储到一个目录树中。我现在需要在主页(由reST生成)中插入一个指向生成的Javascript文档的链接。这需要一个相对的链接,因为文档可能位于不同安装的不同位置。reST会自动解析一个完整的URL,但我不知道如何让它插入一个相对链接。构造像
:ref:
和
:doc:
