add trailing slash before anchors

[rimrul]

Changes

Modify the links that contain anchors to include a slash before the anchor to avoid the redirect.

Context

With Hugo and GitHub Pages there is a redirect for all folders to have a trailing slash that breaks anchors.

[rimrul]

Maybe these should be converted to relative links in the process, instead of making them absolute again.
Also these are technically broken with this change since the absolute links still point to the rails site.

[dscho]

With Hugo and GitHub Pages there is a redirect for all folders to have a trailing slash that breaks anchors.

I wonder if it would work if we added "slash-less" aliases to the target pages...

[dscho]

I wonder if it would work if we added "slash-less" aliases to the target pages...

Ah, probably not because the .html file with the redirect would not preserve the anchor. That would require some Javascript hackery which Hugo's aliases: feature most likely does not provide.

A hack that seems to work over here is to add this step to the GitHub workflow:

find public -name \*.html -exec grep -Zl '<meta http-equiv="refresh"' {} \; |
xargs -0r sed -i '/<\/html>/i\
  <script>\
    window.location.replace(`${document.title}${window.location.hash}`)\
  </script>'

What do you think @rimrul?

[dscho]

Oh, I think I found something: https://gohugo.io/getting-started/configuration/#uglyurls. We may want to do that, and then also ensure that /docs.html is the actual file (I verified that the .html-less URL resolves to the .html file, see e.g. https://dscho.github.io/scalar) and /docs/index.html is just a redirect.

What do you think @rimrul?

[rimrul]

Oh, I think I found something: https://gohugo.io/getting-started/configuration/#uglyurls. We may want to do that, and then also ensure that /docs.html is the actual file (I verified that the .html-less URL resolves to the .html file, see e.g. https://dscho.github.io/scalar) and /docs/index.html is just a redirect.

What do you think @rimrul?

That should work. I came across that setting, but read that as having to use the .html URLs. Seeing https://dscho.github.io/scalar, that's probably not the case.

[dscho]

Oh, I think I found something: https://gohugo.io/getting-started/configuration/#uglyurls. We may want to do that, and then also ensure that /docs.html is the actual file (I verified that the .html-less URL resolves to the .html file, see e.g. https://dscho.github.io/scalar) and /docs/index.html is just a redirect.
What do you think @rimrul?

That should work. I came across that setting, but read that as having to use the .html URLs. Seeing https://dscho.github.io/scalar, that's probably not the case.

I believe that this is working on https://dscho.github.io/git-scm.com/ now.