Files
StarPunk/docs/design/v2.8.0/2026-11-03-microformats2-review.md
PhilandClaude Opus 5.5 438465592c feat: Microformats2 review fixes (v2.8.0)
- Responses as u-comment/u-like/u-repost/u-bookmark/u-mention h-cites
  with author h-cards; source's own url and published (migration 014)
- dt-* and Micropub published in RFC 3339 UTC
- Title only for a real Markdown heading (hashtag notes stay notes)
- Ignore webmentions from a note's own syndicated copies
- Micropub/IndieAuth links independent of Webmention; rel=me/rel=author
- Representative h-card and authorship algorithm (starpunk/mf2_utils.py)
- Tag/likes h-feeds get url and author; previews get u-uid

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 09:36:49 -07:00

2.5 KiB

v2.8.0: Microformats2 review

Review of StarPunk's published and consumed microformats against microformats2, h-entry, h-card, h-feed, h-cite, representative h-card parsing, the authorship spec and Post Type Discovery. Every page type was rendered, parsed with mf2py and checked with mf2util.

Posts (h-entry) were largely correct: no implied names, PTD right for note/article/reply/like/repost/photo, author h-card, u-url/u-uid, p-category, u-syndication.

Fixes

# Problem Fix
1 Replies were unattached h-cite children with a plain-text author u-comment h-cite, p-author h-card (u-url on an inner link, u-photo, p-name), e-content (templates/partials/responses.html)
2 Likes/reposts/bookmarks/mentions had no mf2 u-like / u-repost / u-bookmark / u-mention h-cites; faces past 8 are hidden, not omitted
3 dt-* naive, with microseconds iso_utc filter/helper: RFC 3339 UTC Z, no fraction; Micropub q=source too
4 #hashtag first line = title; bare # = slug title split_title requires an ATX heading (#{1,6} + space); templates use Note.has_title
5 Note's own syndicated copy shown as a mention Worker rejects a source whose url/uid (or URL) is one of the note's syndications.remote_url as invalid
6 Micropub/IndieAuth links gated on WEBMENTION_ENABLED Only rel=webmention is gated
7 No rel=me on a fresh install rel=me and rel=author to author.url or author.me or ADMIN_ME, always
8 Author discovery guessed h-cards mf2_utils.representative_hcard (uid+url, rel=me, single h-card); parsed with the URL after redirects
9 Webmention entry/author/time mf2_utils.responding_entry (entry whose in-reply-to/like-of/... or content refers to the target), entry_author (author property as h-card/URL/name, parent h-feed author, rel=author, representative h-card), source_post_url and source_published stored (migration 014)

Also: tag and likes h-feeds have u-url and p-author; previews have u-uid.

Not done

  • Reply-context h-cite does not carry the cached author h-card, name or published time.
  • Photo alt falls back to "Image" when a photo-only post has no caption.
  • Person tags (p-category h-card) are not supported.
  • Existing webmentions keep NULL source details until they are re-validated.

Tests

tests/test_microformats_v280.py. tests/test_microformats.py test_no_relme_without_author became test_relme_to_admin_me_without_author.