Prepend 'html_baseurl' to the href of each switching item in versions.html?

[hwhsu1231]

Problem Description

Hello, Conan Team.

I wonder whether it's possible to prepend html_baseurl to the href of each switching item in versions.html?

That is, replace this line:

<dd><a href="/{{ the_version }}/index.html">{{ the_version }}</a></dd> 

with:

<dd><a href="${{ html_baseurl }}/{{ the_version }}/index.html">{{ the_version }}</a></dd> 

If possible, how to pass and reference html_baseurl in versions.html?

[RubenRBS]

Hi @hwhsu1231 thanks for your request. I'd like to understand a bit better why you'd need to get the base url as part of the link? Why does the current relative behaviour not work in your case? Are you building locally? Or is this some issue with the current live page itself that you've identified? :)

If possible, how to pass and reference html_baseurl in versions.html?

You'd probably need to add the relevant variable to this dict to make it available in the html context if it's not there already: https://github.com/conan-io/docs/blob/2404156c29d1b91c564dbe1e2f208bba2a87e414/conf.py#L63C1-L63C13

[hwhsu1231]

Hello, @RubenRBS

Are you building locally?

Yes, I am. And if html_baseurl can be prepended to it, we might be able to experience the version switcher of Conan Documentation by running sphinx-build command with -D html_baseurl=<local/path> argument in the local build.

Otherwise, the hyperlinks when hovering those items will be something like these:

file:///2/index.html
file:///2.0/index.html