Files
StarPunk/docs/design/v2.17.0/2026-11-12-article-urls.md
T
PhilandClaude Opus 5.5 b7f8e1612c feat: articles at /article/<slug> with slugs from their titles (v2.17.0, ADR-077)
Articles (notes with a title) move from /note/<slug> to /article/<slug>;
the other prefix 301-redirects. New articles take their slug from the
title (mp-slug still wins; notes keep timestamp slugs). A Micropub update
that adds or removes a title answers 201 with the new Location.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 12:27:31 -07:00

1.5 KiB

v2.17.0: Article URLs and title slugs

Implements ADR-077. Follow-up to v2.16.0 (ADR-076): articles had /note/ URLs and timestamp slugs.

What changed

Area Change
URL helpers utils.post_path(slug, title) and post_url(slug, title); Note.permalink uses them, Note.endpoint (public.article/public.note) and Note.url (absolute) are new
Routes public.article at /article/<slug>; note and article share _permalink(slug, endpoint), which 301s to the other route when the post's type doesn't match. _note_was_deleted checks both URLs for hard-deleted posts
Slugs slug_utils.generate_title_slug(title, existing); create_note uses it for titled posts without custom_slug, else the timestamp slug
Micropub Location, q=source url via note.url; _note_from_url accepts /article/; update answers 201 + Location when a title is added or removed
Other URL builders Templates (note.url), webmention sending (post_url/note.url), crosspost permalink, backfeed target, notification links, search results (article_title from notes.title), MCP tools
Webmention receiving resolve_target_note accepts /note/ and /article/

Tests

tests/test_articles.py::TestArticleUrls: Micropub URL and slug, timestamp slugs for notes, redirects both ways, updates via the old URL, slug rules (accents, duplicates, reserved, mp-slug, emoji, long titles), 201 on adding/removing a title, 410 for a deleted article, webmention targets and homepage links, search result URLs.