Я использую Sphinx для документирования веб-сервиса, который будет развернут на разных серверах. Документация заполнена примерами URL-адресов, которые пользователь может щелкнуть, и они должны просто работать. Моя проблема заключается в том, что корень хоста, порта и развертывания будет отличаться, и документация должна быть сгенерирована для каждого развертывания.
Я попытался определить такие подстановки следующим образом:
|base_url|/path
.. |base_url| replace:: http://localhost:8080
Но сгенерированный HTML не то, что я хочу (не содержит "/path" в сгенерированной ссылке):
<a href="#" onclick="location.href='http://localhost:8080'; return false;">http://localhost:8080</a>/path
Кто-нибудь знает, как обойти это?