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>
1.5 KiB
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.