Skip to content

Add minimal alias layout page with OpenGraph data#1008

Open
dozro wants to merge 2 commits into
luizdepra:mainfrom
dozro:rye/alias
Open

Add minimal alias layout page with OpenGraph data#1008
dozro wants to merge 2 commits into
luizdepra:mainfrom
dozro:rye/alias

Conversation

@dozro

@dozro dozro commented Jun 18, 2026

Copy link
Copy Markdown

a minimal alias layout page for aliases including some basic opengraph data, for people sharing alias urls

Prerequisites

Put an x into the box(es) that apply:

  • This pull request fixes a bug.
  • This pull request adds a feature.
  • This pull request introduces breaking change.

Description

Motivation

Alias URLs can be useful as stable references that remain unchanged even when content is reorganized or moved between sections of a site.
In my case, blog and developer content generate permalinks independently, which makes it difficult to move content between those sections while preserving a stable URL.
Additionally, when sharing alias URLs on social media, link previews were missing because alias pages did not expose any Open Graph metadata (bc aliases are by default html redirects, and leave link preview crawlers often behind while a human clicking would still get where they would expect to go by the preview).
This PR adds support for a dedicated alias page layout and optional Open Graph metadata to improve the sharing experience for alias URLs.

Note: The page is minimal and without styling as a user should ideally never get stuck at that page. And it doesn't use the internal opengraph templates, bc they are a bit verbose and you'd want that page to load as quickly as possible (so users won't notice the redirect as much) and only have that opengraph data to show a better experience then a bare url would be, anyhow switching to the internal templates would be possible if wanted.

Changes

I added a simple, minimal alias layout, which has the optional ability to have opengraph data (controlled via the params.aliases config option, unsure actually if thats clean that way, if not lmk).

Issues Resolved

List any existing issues this pull request resolves.

Checklist

Put an x into the box(es) that apply:

General

  • Describe what changes are being made
  • Explain why and how the changes were necessary and implemented respectively
  • Reference issue with #<ISSUE_NO> if applicable

Resources

  • If you have changed any SCSS code, run make release to regenerate all CSS files

Contributors

  • Add yourself to CONTRIBUTORS.md if you aren't on it already

dozro added 2 commits June 18, 2026 14:05
a minimal alias layout page for aliases including some basic opengraph data, for people sharing alias urls
Alias pages are redirects and should not be classified as articles.
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.

1 participant