Skip to content

Comments

Fix 404s on outbound biojulia.dev links #36

Merged
kescobo merged 1 commit intomainfrom
2026-01-28-fix-deployment-links-2
Jan 29, 2026
Merged

Fix 404s on outbound biojulia.dev links #36
kescobo merged 1 commit intomainfrom
2026-01-28-fix-deployment-links-2

Conversation

@danielle-pinto
Copy link
Collaborator

@danielle-pinto danielle-pinto commented Jan 29, 2026

Clicking links from https://biojulia.dev/dev/ to other sites hosted on the same domain (e.g. https://biojulia.dev/BioTutorials/dev/, https://biojulia.dev/TwoBit.jl/stable/) shows a 404 page until a refresh. This happens because the VitePress client router navigates to these links within the https://biojulia.dev/dev. However, these links don't have the /dev at the end of their URL (this is just added to the biojulia website during deployment)

This PR updates the external “feature card” links on the homepage (docs/src/index.md) to use target="_blank" and rel="noopener noreferrer", bypassing the VitePress router and ensuring the browser performs a real navigation. This makes sure that a new webpage is opened, rather than just navigating within https://biojulia.dev/dev/ . rel="noopener noreferrer" also prevents window.opener access for security. This prevents a user from clicking back. This isn't inherently related to the problem, but this is a common pattern that people use.

The old solution that was merged in (rel="external") didn't work. While this tells VitePress that the website is an external website, this is a piece of metadata. It doesn't tell Vitepress to change how it handles opening the link.

Copy link
Member

@kescobo kescobo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm getting real "get a TUI to 60fps" vibes here...

https://youtu.be/LvW1HTSLPEk?si=dUJWFk3UB-hwkCvN

(This is not a criticism of you)

@kescobo kescobo merged commit 30c9587 into main Jan 29, 2026
2 checks passed
@kescobo
Copy link
Member

kescobo commented Jan 29, 2026

Hey, it works!

@danielle-pinto danielle-pinto deleted the 2026-01-28-fix-deployment-links-2 branch January 29, 2026 17:53
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

Successfully merging this pull request may close these issues.

2 participants