Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use Meta refresh instead of symlinks #1777

Closed
rikhuijzer opened this issue Mar 11, 2022 · 2 comments
Closed

Use Meta refresh instead of symlinks #1777

rikhuijzer opened this issue Mar 11, 2022 · 2 comments

Comments

@rikhuijzer
Copy link
Contributor

rikhuijzer commented Mar 11, 2022

Currently, Documenter uses two methods for redirecting:

  1. <meta http-equiv="refresh" content="0; url=./stable/"/> in index.html and
  2. A symlink for versions such as v4.0 -> v.4.0.1

So, this requires static site systems to support both ways to redirect.

Could we replace the symlinks (2) by http refresh (1) by default or is there a reason why both methods are used?

@fredrikekre
Copy link
Member

For 1., that is not really something that needs to be supported by the server side, right?

The reason for the symlinks is mostly that you want the URLs to be nice and "static"/independent of patches etc.

@rikhuijzer rikhuijzer changed the title Use refresh instead of symlinks Use Meta refresh instead of symlinks Mar 11, 2022
@rikhuijzer
Copy link
Contributor Author

For 1., that is not really something that needs to be supported by the server side, right?

You are right.

I've looked more into this and symlinks result in GitHub Pages returning a 301 Moved Permanently. Compared to the meta refresh, this is better for search engines since they may consider meta refresh as spam.

So, essentially. My idea is a bad idea. I'll close this

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants