This project explores how microformats work by building a series of prototypes.
Goals:
- ✓
Understand how adding semantic HTML classes can make a page function as both a human-readable webpage and a machine-readable feed. - » Launch new MF/Atom feed and redirect old RSS
- » Create new post types for photos
- » Expand post types even more (likes, reviews, etc)
- » Set up outgoing webmentions
-
root/
- ├─ microformats-explained.md
- ├─ mainfeed/
- │ ├─ atom-granary.xml
- │ ├─ rss-current-deminified.xml
- │ ├─ rss-current-granary.xml
- │ ├─ rss-current-trimmed.xml
- │ ├─ rss-simplified-example.xml
- │ ├─ comparison-notes.md
- │ └─ static.html
- └─ photos/
- ├─ album-feed.html
- ├─ combined-feed.html
- └─ photo-feed.html
Next:
- ✓
Make a working static page with full content posts and microformats - ✓
Test conversion to Atom with Granary - Prepare main feed prototype for deployment:
- Compare all data points in the prototype Atom feed against the current live RSS feed, ensuring each value matches exactly
- Goal: Switching from RSS to Atom should not trigger duplicate/new posts for existing entries in any feed readers (invisible transition)
-
Areas to check:
- For channel/feed level, check the id and url
- For each post, ensure guid to Atom ID matches exactly
- RSS link to Atom link
- Title
- Link
- Dates and timezones
- Summary/Description
- Content (make sure it is escaped/CDATA/whatever is needed)
- Author
- Category
- Once things look good, copy to root level or new /feed folder
- Test again, this time with a live URL
- Light research of 307 redirects, then implement and test across several readers
- Redirect live RSS to new Atom feed
Later:
- Swap out static html page for a dynamic .astro one that accepts both MD and MDX files, like the /writing and /drafts indexes.
- Add feed-specific content like links to email and socials
Later/maybe:
- Be able to publish .astro pages with a content preview, not full post
- Photo feed prototypes with h-feed and u-photo microformats
- YouTube/video feed prototype
- Explore pragmatic benefts of
rel="author"andu-authormicroformats (beyond just ritualistic hygiene)