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