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