Hi Volkan,

On Sun, 21 Apr 2024 at 20:19, Volkan Yazıcı <vol...@yazi.ci> wrote:
>
> I have a couple of questions Piotr:
>
>    1. Could you show us the Antora configuration option you mentioned
>    and how we can use it to achieve what you propose?

There are `:relfileprefix:` and `:relfilesuffix:` attributes[1] that
can be used to achieve that effect.
The Antora website[2] itself hides the extensions of the files.

>    2. Are you suggesting that all `foo.html` pages should be converted to
>    `foo/`?

Initially I thought about `foo` (i.e. keep `foo.html` as file name and
use mod_negotiate), but `foo/` (i.e. putting the HTML in
`foo/index.html`) seems to be a more widespread practice.

The usual argument for using `foo` instead of `foo.html` is that it
hides the technology used to generate the site. While for `foo.php`
and `foo.jsp` this makes sense, for `foo.html` I find this argument
bogus, since websites will always use HTML as output format.

On the other hand there is another advantage for using `foo` instead
of `foo.html`: if in the future you create subpages `foo/bar` and
`foo/baz`, their URLs will be obtained by simply appending a word to
their "parent" URL.

Piotr

[1] 
https://docs.asciidoctor.org/asciidoc/latest/macros/inter-document-xref/#mapping-references-to-a-different-structure
[2] https://docs.antora.org/antora/latest/page/page-links/

Reply via email to