My project has some external HTML files that are put in place as a separate 
build step and I would like to add a link to them in my toctree. Currently 
I have this, and it works fine, but it assumes a static URL and therefore 
when testing the site on another host/port the URLs are incorrect...

.. toctree::
   :caption: Reference
   :hidden:

   Dylan Reference Manual <https://opendylan.org/books/drm/>
   Package Docs <package/index>
   Open Dylan Libraries <library-reference/index>
   All Documentation <documentation/index>
   Full Index <genindex>

So instead of <https://opendylan.org/books/drm/> I would like to use 
something like <${base-url}/books/drm/> where the current base URL is 
substituted.

Simply using </books/drm/> doesn't work; I get "WARNING: toctree contains 
reference to nonexisting document 'books/drm'" and the link is omitted from 
the output.

As always, I feel like I'm missing something obvious.  Is there a way to do 
this?

Thanks.

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/c4546b42-d80e-4275-b928-7d65c913d89cn%40googlegroups.com.

Reply via email to