Вставить относительную ссылку в reStructuredText

Я документирую библиотеку, в которой есть компонент Python и компонент JavaScript. Вся пользовательская документация и документация по Python API находятся в reStructuredText, обработанном с помощью Sphinx. JavaScript API находится в jsdoc и обрабатывается с помощью jsdoc-toolkit. Основным форматом вывода будет HTML. Я новичок в reST, Sphinx и jsdoc.

Я настроил систему сборки, чтобы все сгенерированные html-страницы были сброшены в одно дерево каталогов. Теперь мне нужно вставить на главную страницу (сгенерированную из reST) ссылку на сгенерированную документацию по Javascript. Это должна быть относительная ссылка, поскольку документы могут находиться в разных местах на разных установках. reST автоматически проанализирует полный URL, но я не могу понять, как заставить его вставить относительную ссылку. Такие конструкции, как : ref: и : doc: , похоже, не помогают, потому что они ожидают, что цель будет reST.

Есть идеи?

28
задан Don Kirkby 7 October 2010 в 00:09
поделиться