在 reStructuredText 中插入相对链接
我正在记录一个包含 Python 组件和 JavaScript 组件的库。整个用户文档和 Python API 文档位于 reStructuredText 中，并使用 Sphinx 进行处理。 JavaScript API 位于 jsdoc 中，并使用 jsdoc-toolkit 进行处理。主要输出格式为 HTML。我是 reST、Sphinx 和 jsdoc 的新手。
我已经设置了一个构建系统，因此所有生成的 html 页面都被转储到一个目录树中。我现在需要在主页（从 reST 生成）中插入指向生成的 Javascript 文档的链接。这需要是相对链接，因为文档可能位于不同安装的不同位置。 reST 会自动解析完整的 URL，但我不知道如何让它插入相对链接。类似于 :ref: 和 :doc: 似乎没有帮助，因为他们希望目标是休息的。
有什么想法吗？
I am documenting a library that has a Python component and a JavaScript component. The overall user documentation, and the Python API documentation are in reStructuredText, processed with Sphinx. The JavaScript API is in jsdoc and is processed with jsdoc-toolkit. The principal output format will be HTML. I am new to reST, Sphinx and jsdoc.
I have set up a build system so all the generated html pages are dumped into a single directory tree. I now need to insert into the main page (generated from reST) a link to the generated Javascript documentation. This needs to be a relative link, since the docs may be located in different places on different installations. reST will automatically parse a full URL, but I can't figure out how to make it insert a relative link. Constructs like :ref: and :doc: don't seem to help, because they expect the target to be reST.
Any ideas?
如果你对这篇内容有疑问，欢迎到本站社区发帖提问 参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱，如果其他用户或者作者回复了您的评论，将不能在第一时间通知您！
发布评论
评论（1）
想通了。以下插入对文档
js/index.html的相对引用：Figured it out. The following inserts a relative reference to the document
js/index.html: