[go: up one dir, main page]

Skip to content

Unwanted slash breaks URL generated from xref to page with same name as adjacent directory

We have a module set up as follows:

ROOT
-- pages
---- java
------ overview.adoc
---- python 
------ overview.adoc
---- java.adoc
---- python.adoc

python.adoc contains the following section:

[#_install]
== Install

`python/overview.adoc` contains the following xref:
```adoc
xref:python.adoc#_install[Installation]

The generated URL is https://{site_url}/{module}/python/#_install. For us, this is a broken link. It attempts to load CSS and JS from the wrong path resulting in an unstyled site. Our framework is based on the Antora Default UI. We use html_extension_style = drop.

The expected URL is https://{site_url}/{module}/python#_install.

Tested in Antora 3.1.4 and 3.2.0-alpha-2.

Edited by Alex Walker
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information