Вставить относительную ссылку в реструктуретеле
-
26-09-2019 - |
Вопрос
Я документирую библиотеку, которая имеет компонент Python и компонент JavaScript. Общая пользовательская документация и документация Python API находятся в реструктуретеле текст, обработанные с помощью SPHINX. API JavaScript находится в jsdoc и обрабатывается с jsdoc-toolkit. Основной выходной формат будет HTML. Я новый для отдыха, сфинкса и jsdoc.
Я настроил систему сборки, чтобы все сгенерированные страницы HTML сбрасываются в единое дерево каталога. Теперь мне нужно вставить на главную страницу (сгенерировано из покоя) ссылку на генерируемую документацию JavaScript. Это должно быть относительной ссылкой, поскольку документы могут быть расположены в разных местах на разных установках. Отдых будет автоматически разобрать полный URL, но я не могу понять, как сделать его вставить относительную ссылку. Строки вроде : Ref: и : Док: Не помогайте, потому что они ожидают, что цель будет отдыхать.
Любые идеи?
Решение
Догадаться. Следующие вставляют относительную ссылку на документ js/index.html
:
`Javascript API <js/index.html>`_