redesign 08 — syndication & perf (JSON feed, sitemap, OG) #13

Merged

michalvankodev merged 13 commits from redesign/08-syndication-perf into redesign/00-foundation 2026-09-09 14:56:20 +02:00

Conversation 0 Commits 13 Files changed 36 +3805 -89

michalvankodev commented 2026-08-21 14:37:51 +02:00

Owner

Copy link

What

Slice 8/9 of the selected redesign (base: #12). Syndication, metadata, performance.

• JSON Feed 1.1 at /feed.json — shares one build_feed_items() with RSS so they never drift: full content_html, absolute segment-aware URLs, RFC 3339 dates, images, tags.
• RSS full-text audit — broadcasts were mislinked under /blog/… in the feed (they live at /broadcasts/…); URLs are now segment-aware and enclosure URLs absolute. Two #[tokio::test]s assert full-text presence + absolute URLs for both feeds (audits real _posts/).
• sitemap.xml — generated from the post lists at render/export time (static pages + posts with lastmod); robots.txt references it.
• OG/Twitter completion per post — article:published_time (ISO 8601), article:tag, twitter:card=summary_large_image, twitter:image.
• Lazy-load — loading="lazy" decoding="async" on all content images (markdown pictures, thumbnails, cards, article covers); homepage hero eager + fetchpriority="high" (new param, test covers both paths).
• Cache policy scoped honestly — Caddyfile-preview: assets max-age=604800 + etag revalidation, HTML no-cache; the year-long immutable removed (filenames are size-suffixed, not hashed — returning visitors could hold stale assets). ⚠️ Production Caddy on katelyn needs the matching header change at deploy time.

Preview: https://redesign-08-syndication-perf.dev.michalvanko.dev — see /feed.json, /sitemap.xml, /robots.txt, any article's <head>.

## What Slice 8/9 of the selected redesign (base: #12). Syndication, metadata, performance. - **JSON Feed 1.1** at `/feed.json` — shares one `build_feed_items()` with RSS so they never drift: full `content_html`, absolute segment-aware URLs, RFC 3339 dates, images, tags. - **RSS full-text audit** — broadcasts were mislinked under `/blog/…` in the feed (they live at `/broadcasts/…`); URLs are now segment-aware and enclosure URLs absolute. Two `#[tokio::test]`s assert full-text presence + absolute URLs for both feeds (audits real `_posts/`). - **sitemap.xml** — generated from the post lists at render/export time (static pages + posts with `lastmod`); `robots.txt` references it. - **OG/Twitter completion per post** — `article:published_time` (ISO 8601), `article:tag`, `twitter:card=summary_large_image`, `twitter:image`. - **Lazy-load** — `loading="lazy" decoding="async"` on all content images (markdown pictures, thumbnails, cards, article covers); homepage hero eager + `fetchpriority="high"` (new param, test covers both paths). - **Cache policy scoped honestly** — `Caddyfile-preview`: assets `max-age=604800` + etag revalidation, HTML `no-cache`; the year-long `immutable` removed (filenames are size-suffixed, not hashed — returning visitors could hold stale assets). ⚠️ Production Caddy on katelyn needs the matching header change at deploy time. **Preview:** https://redesign-08-syndication-perf.dev.michalvanko.dev — see `/feed.json`, `/sitemap.xml`, `/robots.txt`, any article's `<head>`.

michalvankodev added 1 commit 2026-08-21 14:37:51 +02:00

redesign: syndication & perf — JSON feed, sitemap, OG/Twitter, lazy images ... d6430cb891

- JSON Feed 1.1 at /feed.json (serde_json) sharing one build_feed_items
  with RSS — items stay in sync: full content_html, absolute segment-
  aware URLs, RFC3339 dates, images, tags
- RSS audit: feed URLs absolute (broadcast posts were linked under
  /blog/ — segment-aware now), enclosure URLs absolute; tokio tests
  assert full-text body + absolute URLs for both feeds
- sitemap.xml generated from post lists at render/export time (47
  URLs: 6 static + posts w/ lastmod); robots.txt references it
- OG/Twitter completion per post: article:published_time (ISO 8601),
  article:tag, twitter:card summary_large_image, twitter:image
- Lazy-load: loading=lazy + decoding=async on all content images
  (markdown pictures, thumbnails, cards, covers); homepage hero is
  eager with fetchpriority=high (new bool param; test covers both)
- Caddyfile-preview cache policy honest about size-suffixed filenames:
  assets max-age=604800 + etag revalidation, HTML no-cache — immutable
  removed (unsafe without content hashing). NOTE: production Caddy on
  katelyn needs the matching header change at deploy

michalvankodev referenced this pull request 2026-08-21 14:40:14 +02:00

WIP: redesign 09 — a11y & print sweep (stack tip) #14

michalvankodev force-pushed redesign/08-syndication-perf from d6430cb891 to 17bc0bf735 2026-08-21 16:17:20 +02:00 Compare

michalvankodev force-pushed redesign/08-syndication-perf from 17bc0bf735 to 7969d0c587 2026-08-23 12:37:16 +02:00 Compare

michalvankodev force-pushed redesign/08-syndication-perf from 7969d0c587 to e360228b1c 2026-08-23 12:49:45 +02:00 Compare

michalvankodev force-pushed redesign/08-syndication-perf from e360228b1c to d886a653da 2026-08-23 12:58:06 +02:00 Compare

michalvankodev force-pushed redesign/08-syndication-perf from d886a653da to 499da590ea 2026-08-24 10:19:53 +02:00 Compare

michalvankodev changed target branch from redesign/07-components to redesign/00-foundation 2026-09-08 15:16:47 +02:00

michalvankodev force-pushed redesign/08-syndication-perf from 499da590ea to aad70e4681 2026-09-08 15:16:48 +02:00 Compare

michalvankodev added 5 commits 2026-09-09 10:31:30 +02:00

redesign: fix duplicated section opening in featured project plate 0b990bcab1

redesign: lazy-load post list thumbnails; fetchpriority stays hero-only 71e902b62e

feed: json feed icon + favicon; discoverable via head and footer links 0a97646678

ssg: fetch sitemap.xml explicitly (wget ignores robots.txt Sitemap:) 29d9b264bf

specs: decision record for absolute URLs in feed content 15a50f3378

michalvankodev added 1 commit 2026-09-09 12:58:40 +02:00

cards: og/twitter images always raster — og-default.png for svg or missing thumbnails ec2d7f29de

michalvankodev added 2 commits 2026-09-09 13:16:10 +02:00

cards: rasterize svg thumbnails through the image pipeline (resvg → 1200x630 png) a9c5226975

chore: track Cargo.lock — reproducible dep resolution for the server binary 5329a1cfe4

michalvankodev added 1 commit 2026-09-09 13:43:15 +02:00

cards: per-post descriptions — front-matter override with auto-excerpt fallback (og/twitter/meta + feed summary) 989eda4f58

michalvankodev added 1 commit 2026-09-09 14:15:51 +02:00

cache: no-cache for css (constant filename changes per deploy), 30d for versioned assets 40c4767f28

michalvankodev added 1 commit 2026-09-09 14:41:27 +02:00

cache: content-hashed css in prod exports (TARGET=PROD), immutable caching; dev keeps fixed name e94c96bb2c

michalvankodev added 1 commit 2026-09-09 14:54:28 +02:00

chore: gitignore hashed tailwind artifacts (styles/output.*.css) 1ff187f7f2

michalvankodev changed title from WIP: redesign 08 — syndication & perf (JSON feed, sitemap, OG) to redesign 08 — syndication & perf (JSON feed, sitemap, OG) 2026-09-09 14:56:19 +02:00

michalvankodev merged commit fc63e2b27a into redesign/00-foundation 2026-09-09 14:56:20 +02:00

michalvankodev referenced this pull request from a commit 2026-09-09 14:56:22 +02:00

Merge pull request 'redesign 08 — syndication & perf (JSON feed, sitemap, OG)' (#13) from redesign/08-syndication-perf into redesign/00-foundation

michalvankodev referenced this pull request 2026-09-11 18:42:06 +02:00

feed: absolute URLs in syndicated HTML (RSS + JSON Feed) #21

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

michalvankodev/michalvankodev-site!13

No description provided.