Я документирую библиотеку, в которой есть компонент Python и компонент JavaScript.Вся пользовательская документация и документация по Python API находятся в reStructuredText, обработанном с помощью Sphinx.JavaScript API находится в jsdoc и обрабатывается с помощью jsdoc-toolkit.Основным форматом вывода будет HTML.Я новичок в reST, Sphinx и jsdoc.
Я настроил систему сборки, чтобы все сгенерированные html-страницы были сброшены в одно дерево каталогов.Теперь мне нужно вставить на главную страницу (сгенерированную из reST) ссылку на сгенерированную документацию по Javascript.Это должна быть относительная связь, так как документы могут находиться в разных местах на разных установках.reST автоматически проанализирует полный URL, но я не могу понять, как заставить его вставить относительную ссылку.Такие конструкции, как : ref: и : doc: , похоже, не помогают, поскольку они ожидают, что цель будет reST.
Есть идеи?