我正在记录一个包含 Python 组件和 JavaScript 组件的库。整个用户文档和 Python API 文档都在 reStructuredText 中,使用 Sphinx 处理。JavaScript API 位于 jsdoc 中,并使用 jsdoc-toolkit 进行处理。主要输出格式为 HTML。我是 reST、Sphinx 和 jsdoc 的新手。
我已经建立了一个构建系统,所以所有生成的 html 页面都被转储到一个目录树中。我现在需要在主页(从 reST 生成)中插入指向生成的 Javascript 文档的链接。这需要是一个相对链接,因为文档可能位于不同安装的不同位置。reST 会自动解析一个完整的 URL,但我不知道如何让它插入一个相对链接。:ref:和:doc:之类的构造似乎没有帮助,因为它们希望目标是 reST。
有任何想法吗?