Dan*_*nes 28 documentation restructuredtext jsdoc
我正在记录一个包含Python组件和JavaScript组件的库.整个用户文档和Python API文档位于reStructuredText中,使用Sphinx进行处理.JavaScript API位于jsdoc中,并使用jsdoc-toolkit进行处理.主要输出格式为HTML.我是reST,Sphinx和jsdoc的新手.
我已经建立了一个构建系统,因此所有生成的html页面都被转储到一个目录树中.我现在需要在主页面(从reST生成)中插入生成的Javascript文档的链接.这需要是一个相对链接,因为文档可能位于不同安装的不同位置.reST将自动解析完整的URL,但我无法弄清楚如何使其插入相对链接.构造如:ref:和:doc:似乎没有帮助,因为他们希望目标是reST.
有任何想法吗？
Dan*_*nes 40
弄清楚了.以下插入对文档的相对引用js/index.html:
`Javascript API <js/index.html>`_
| 归档时间： |
|
| 查看次数： |
5572 次 |
| 最近记录： |