Docs versioning tool is not building working relative links for ibis-project.org

[anjakefala]

E.g. https://ibis-project.org/backends/SQLite/#install linked to from here: https://ibis-project.org/docs/3.0.2/tutorial/01-Introduction-to-Ibis/.

Source code shown: https://github.com/ibis-project/ibis/pull/4038/files#diff-15dc5f0c70736230279998fc98d3472bfe89bed557277c4e5e5640e41898bbc1L26.

From chatting with @cpcloud, when built locally the links are built appropriately, but it is not working with the docs versioning tool being used to build the website in production.

List of links with the problem:
docs/tutorial/01-Introduction-to-Ibis.ipynb: "To start using Ibis, you need a Python environment with Ibis installed. Follow the installation instructions for SQLite to setup an environment.\n",

https://ibis-project.org/backends/SQLite/#install

docs/tutorial/04-More-Value-Expressions.ipynb: "The Ibis type system supports the most common data types used in analytics, including support for nested types like lists, structs, and maps.\n",

https://ibis-project.org/api/datatypes

[cpcloud]

I think it might be an issue with mkdocs-jupyter, since we do have relative links elsewhere in the documentation that work, e.g., here.

[anjakefala]

/take

[anjakefala]

I can confirm this bug is specifically the result of mkdocs-jupyter behaviour. I am still exploring this, but initial findings hint that this might be tricky to do: danielfrg/mkdocs-jupyter#27

[anjakefala]

For folks in the future:

mkdocs-jupyter cannot find relative links in upper directories with the
standard markdown syntax
(danielfrg/mkdocs-jupyter#27).

The solution is to use html <a> tag (e.g. Follow the <a href='../../backends/SQLite#install'>installation instructions for SQLite</a> to setup an environment.\n",)