Re: Canonicalization of URLs on our website

2024-05-08 Thread Ralph Goers
The IDE lets you view the page you are editing but generally it doesn’t show you the nav or the rest of the site. I am also not confident that everything will be styled exactly the same as it will appear in the browser. So, in short, the IDE is great for editing but I like to do my reviews on a

Re: Canonicalization of URLs on our website

2024-05-08 Thread Piotr P. Karwasz
Hi Volkan, On Wed, 8 May 2024 at 14:57, Volkan Yazıcı wrote: > In my opinion, > >- Being able to view `target/site` with just using my browser and >nothing else is super convenient. The development experience is much >smoother. If we use a non-default `html_extension_style`, you can

Re: Canonicalization of URLs on our website

2024-05-08 Thread Ralph Goers
Volkan, I completely agree with you. I prefer to review my site changes either in target/site or by doing a deploy to a local directly. In both cases I use the file protocol to view it. Ralph > On May 8, 2024, at 5:55 AM, Volkan Yazıcı wrote: > > All non-default `html_extension_style` option

Re: Canonicalization of URLs on our website

2024-05-08 Thread Volkan Yazıcı
All non-default `html_extension_style` options require to run a web server. In my opinion, - Being able to view `target/site` with just using my browser and nothing else is super convenient. The development experience is much smoother. - None of the advantages you cited for switching

Re: Canonicalization of URLs on our website

2024-05-08 Thread Piotr P. Karwasz
Hi all, On Sun, 21 Apr 2024 at 20:19, Volkan Yazıcı wrote: >1. Could you show us the Antora configuration option you mentioned >and how we can use it to achieve what you propose? I found the perfect Antora setting: `html_extension_style`[1]. The option I am proposing corresponds to the

Re: Canonicalization of URLs on our website

2024-04-22 Thread Piotr P. Karwasz
Hi Volkan, On Sun, 21 Apr 2024 at 20:19, Volkan Yazıcı 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]

Re: Canonicalization of URLs on our website

2024-04-21 Thread Ralph Goers
I have always viewed index.html as a special case. When navigating to the root of a site - l.a.o/log4j/2.x/ - should be sufficient as it should default to index.html. However, the “real” url includes index.html. Other pages should always be whatever.html IMO. Ralph > On Apr 20, 2024, at 1:17

Re: Canonicalization of URLs on our website

2024-04-21 Thread Volkan Yazıcı
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? 2. Are you suggesting that all `foo.html` pages should be converted to `foo/`? On Sat, Apr 20, 2024 at 10:17 PM Piotr P. Karwasz

Re: Canonicalization of URLs on our website

2024-04-20 Thread Piotr P. Karwasz
Hi Gary, On Sun, 21 Apr 2024 at 00:02, Gary Gregory wrote: > > I agree with Piotr. I prefer the simplest solution, pointing to > `index.html`, no guessing required. Personally I prefer the shortest one: * no www, * no `index.html`, * no `.html`. Piotr

Re: Canonicalization of URLs on our website

2024-04-20 Thread Gary Gregory
I agree with Piotr. I prefer the simplest solution, pointing to `index.html`, no guessing required. Gary On Sat, Apr 20, 2024 at 4:17 PM Piotr P. Karwasz wrote: > > Hi, > > I scanned our https://logging.apache.org/ website and found out that > the internal hyperlinks between our pages are not co

Canonicalization of URLs on our website

2024-04-20 Thread Piotr P. Karwasz
Hi, I scanned our https://logging.apache.org/ website and found out that the internal hyperlinks between our pages are not consistent. For example links to: https://logging.apache.org/log4j/2.x/ might appear in hyperlinks with an URI path of: * `/log4j/2.x` (which causes a 301 HTTP redirect), *