@jant/core 0.6.16 → 0.7.0

package/src/services/export-theme/layouts/_default/rss.xml

@@ -97,7 +97,16 @@
 {{- $selfUrl := .Permalink -}}
 {{- $now := now.UTC.Format "2006-01-02T15:04:05Z" -}}
 <?xml version="1.0" encoding="UTF-8"?>
-<feed xmlns="http://www.w3.org/2005/Atom">
+{{- /* Namespaces ride along only when something in them is emitted, the same
+     rule `lib/feed.ts` follows. */ -}}
+{{- $anyMedia := false -}}
+{{- range $posts -}}
+  {{- if .Params.media -}}{{- $anyMedia = true -}}{{- end -}}
+  {{- range .Pages -}}{{- if .Params.media -}}{{- $anyMedia = true -}}{{- end -}}{{- end -}}
+{{- end -}}
+{{- $jantNs := cond (gt (len $posts) 0) ` xmlns:jant="https://jant.me/ns"` "" -}}
+{{- $mediaNs := cond $anyMedia ` xmlns:media="http://search.yahoo.com/mrss/"` "" -}}
+<feed xmlns="http://www.w3.org/2005/Atom"{{ $jantNs | safeHTMLAttr }}{{ $mediaNs | safeHTMLAttr }}>
   <title>{{ $feedTitle | transform.XMLEscape }}</title>
   <subtitle>{{ $siteDescription | transform.XMLEscape }}</subtitle>
   <link href="{{ $siteBase | transform.XMLEscape }}" rel="alternate"/>
@@ -129,15 +138,82 @@
     {{- $summaryText = or (string (.Params.summary_text | default "")) (.Title | default "") (string (.Params.link_url | default "")) -}}
   {{- end -}}
   {{- if eq $summaryText "" -}}{{- $summaryText = printf "Post %s" (string (.Params.id | default "")) -}}{{- end -}}
+
+  {{- /* Whether the timeline cut the text of any post the entry's card shows.
+       Per post it is written into front matter by the exporter, which shares
+       the boundary with the served feed; Hugo's own summary rule would cut
+       somewhere else. Per entry the rule is `isEntryTruncated` in
+       `lib/feed.ts`: the root plus every reply the fold keeps — the first
+       THREAD_LEADING_REPLIES (2) and the last THREAD_TRAILING_REPLIES (3),
+       newest included — as `lib/thread-fold.ts` defines it. A thread of five
+       replies or fewer is shown whole; `first` and `last` clamp to the slice,
+       so the two windows simply overlap there. */ -}}
+  {{- $replies := (where $post.Pages "Params.visibility" "public").ByDate -}}
+  {{- $truncated := $post.Params.truncated | default false -}}
+  {{- range first 2 $replies -}}
+    {{- if .Params.truncated -}}{{- $truncated = true -}}{{- end -}}
+  {{- end -}}
+  {{- range last 3 $replies -}}
+    {{- if .Params.truncated -}}{{- $truncated = true -}}{{- end -}}
+  {{- end -}}
+
+  {{- /* Every attachment in the thread, each paired with the post that carries
+       it — a text attachment's page lives under its own post. */ -}}
+  {{- $entryMedia := slice -}}
+  {{- range ($post.Params.media | default slice) -}}
+    {{- $entryMedia = $entryMedia | append (dict "m" . "page" $permalink) -}}
+  {{- end -}}
+  {{- range $replies -}}
+    {{- $replyPermalink := .Permalink -}}
+    {{- range (.Params.media | default slice) -}}
+      {{- $entryMedia = $entryMedia | append (dict "m" . "page" $replyPermalink) -}}
+    {{- end -}}
+  {{- end -}}
   <entry>
     <title>{{ $entryTitle | transform.XMLEscape }}</title>
     <link href="{{ $alternate | transform.XMLEscape }}" rel="alternate"/>
     {{- if $isLink }}
     <link href="{{ $permalink | transform.XMLEscape }}" rel="related"/>
     {{- end }}
+    {{- /* Images carry no enclosure: the content already shows them full size
+         inside a link to the original, so one would only ask an attachment
+         shelf to list the picture again. */ -}}
+    {{- range $entryMedia }}
+    {{- $m := .m }}
+    {{- if ne (string ($m.kind | default "document")) "image" }}
+    <link rel="enclosure" type="{{ (string ($m.mime_type | default "application/octet-stream")) | transform.XMLEscape }}" href="{{ (string $m.src) | absURL | transform.XMLEscape }}"{{ with $m.size }} length="{{ . }}"{{ end }}{{ with $m.original_name }} title="{{ . | transform.XMLEscape }}"{{ end }}/>
+    {{- end }}
+    {{- end }}
     <id>{{ $permalink | transform.XMLEscape }}</id>
     <published>{{ $published }}</published>
     <updated>{{ $updated }}</updated>
+    <jant:format>{{ $format | transform.XMLEscape }}</jant:format>
+    {{- if $truncated }}
+    <jant:truncated/>
+    {{- end }}
+    {{- /* A collection is a label the author chose, which is what <category>
+         is for. `jant:page` carries the URL because a single collection lives
+         in the root URL namespace. */ -}}
+    {{- range ($post.Params.collections | default slice) }}
+    <category term="{{ (string .slug) | transform.XMLEscape }}" label="{{ (string (.title | default .slug)) | transform.XMLEscape }}" jant:page="{{ (printf "/%s/" (string .slug)) | absURL | transform.XMLEscape }}"/>
+    {{- end }}
+    {{- range $entryMedia }}
+    {{- $m := .m }}
+    {{- $kind := string ($m.kind | default "document") }}
+    {{- $medium := cond (or (eq $kind "image") (or (eq $kind "video") (eq $kind "audio"))) $kind "document" }}
+    {{- $fileUrl := (string $m.src) | absURL }}
+    {{- /* Where a click should land. Only emitted where it is not the file:
+         a text attachment's markdown would download or dump unstyled. */ -}}
+    {{- $pageUrl := $fileUrl }}
+    {{- if eq $kind "text" }}{{ $pageUrl = printf "%s/text/%s" (strings.TrimSuffix "/" .page) (string $m.id) }}{{ end }}
+    {{- $desc := string ($m.alt | default ($m.summary | default "")) }}
+    {{- $poster := string ($m.poster | default "") }}
+    <media:content url="{{ $fileUrl | transform.XMLEscape }}" type="{{ (string ($m.mime_type | default "application/octet-stream")) | transform.XMLEscape }}" medium="{{ $medium }}"{{ with $m.size }} fileSize="{{ . }}"{{ end }}{{ with $m.width }} width="{{ . }}"{{ end }}{{ with $m.height }} height="{{ . }}"{{ end }}{{ with $m.duration_seconds }} duration="{{ math.Round . }}"{{ end }}{{ if ne $pageUrl $fileUrl }} jant:page="{{ $pageUrl | transform.XMLEscape }}"{{ end }}>
+      {{- with $m.original_name }}<media:title type="plain">{{ . | transform.XMLEscape }}</media:title>{{ end }}
+      {{- if ne $desc "" }}<media:description type="plain">{{ $desc | transform.XMLEscape }}</media:description>{{ end }}
+      {{- if ne $poster "" }}<media:thumbnail url="{{ $poster | absURL | transform.XMLEscape }}"/>{{ end -}}
+    </media:content>
+    {{- end }}
     <summary type="text">{{ $summaryText | transform.XMLEscape }}</summary>
     <content type="html"><![CDATA[
 {{- partial "feed-post-content.xml" (dict "post" $post "permalink" $permalink "includeReplies" true) -}}

package/src/services/export-theme/layouts/partials/feed-post-content.xml

@@ -53,8 +53,23 @@
     {{- $sourceUrl := string ($post.Params.source_url | default "") -}}
     {{- $cite := "" -}}
     {{- if ne $sourceUrl "" -}}{{- $cite = printf ` cite=%q` $sourceUrl -}}{{- end -}}
-    {{- $block := printf "<blockquote%s><p>%s</p></blockquote>" $cite (transform.XMLEscape $quoteText) -}}
-    {{- $parts = $parts | append $block -}}
+    {{- /* Line breaks the author typed must survive as markup: the site
+         keeps them with `white-space: pre-line`, but feed readers strip
+         CSS. Blank lines split <p> blocks, single newlines become <br/>
+         (mirrors `renderPlainTextHtml` in `lib/feed.ts`). */ -}}
+    {{- $quoteBlocks := slice -}}
+    {{- range split (replaceRE `\r\n?` "\n" $quoteText) "\n\n" -}}
+      {{- $para := trim . " \t\n" -}}
+      {{- if ne $para "" -}}
+        {{- $lines := slice -}}
+        {{- range split $para "\n" -}}{{- $lines = $lines | append (transform.XMLEscape .) -}}{{- end -}}
+        {{- $quoteBlocks = $quoteBlocks | append (printf "<p>%s</p>" (delimit $lines "<br/>")) -}}
+      {{- end -}}
+    {{- end -}}
+    {{- if gt (len $quoteBlocks) 0 -}}
+      {{- $block := printf "<blockquote%s>%s</blockquote>" $cite (delimit $quoteBlocks "\n") -}}
+      {{- $parts = $parts | append $block -}}
+    {{- end -}}
     {{- /* Attribution line — prefer name, fall back to URL host or the
          raw URL itself (mirrors main site's extractDisplayDomain fallback
          chain in `lib/url.ts`). */ -}}
@@ -88,6 +103,94 @@
   {{- end -}}
 {{- end -}}
 
+{{- /* --- Attachments --- */ -}}
+{{- /* One container per post, marked `data-post-media` — the attribute the
+     site puts on its gallery strip, so a consumer styles the strip instead of
+     reassembling it from the Media RSS elements. In a thread this is also the
+     only surface that says which post an attachment belongs to. Mirrors
+     `renderMediaItem` in `packages/core/src/lib/feed.ts`. */ -}}
+{{- $mediaList := $post.Params.media | default slice -}}
+{{- if gt (len $mediaList) 0 -}}
+  {{- $items := slice -}}
+  {{- range $mediaList -}}
+    {{- $kind := string (.kind | default "document") -}}
+    {{- $mime := string (.mime_type | default "application/octet-stream") -}}
+    {{- /* `trim` wraps the index rather than piping into it: a Go template
+         pipe binds to the last argument, so `index … 0 | trim " "` would trim
+         the index instead of the result. */ -}}
+    {{- $mimeLabel := trim (index (split $mime ";") 0) " " -}}
+    {{- $src := (string .src) | absURL -}}
+    {{- $name := string (.original_name | default "") -}}
+    {{- $alt := string (.alt | default "") -}}
+    {{- /* Duration and size, in the shapes `formatFeedDuration` and
+         `formatFeedBytes` produce. */ -}}
+    {{- $metaParts := slice -}}
+    {{- with .duration_seconds -}}
+      {{- $total := int (math.Round .) -}}
+      {{- if gt $total 0 -}}
+        {{- $metaParts = $metaParts | append (printf "%d:%02d" (div $total 60) (mod $total 60)) -}}
+      {{- end -}}
+    {{- end -}}
+    {{- with .size -}}
+      {{- $b := int . -}}
+      {{- if gt $b 0 -}}
+        {{- if lt $b 1024 -}}
+          {{- $metaParts = $metaParts | append (printf "%d B" $b) -}}
+        {{- else if lt $b 1048576 -}}
+          {{- $metaParts = $metaParts | append (printf "%d KB" (int (math.Round (div (float $b) 1024.0)))) -}}
+        {{- else -}}
+          {{- $metaParts = $metaParts | append (printf "%.1f MB" (div (float $b) 1048576.0)) -}}
+        {{- end -}}
+      {{- end -}}
+    {{- end -}}
+    {{- $meta := delimit $metaParts " · " -}}
+    {{- $metaSuffix := "" -}}
+    {{- if ne $meta "" -}}{{- $metaSuffix = printf " (%s)" (transform.XMLEscape $meta) -}}{{- end -}}
+    {{- $dims := "" -}}
+    {{- if and .width .height -}}{{- $dims = printf ` width="%d" height="%d"` (int .width) (int .height) -}}{{- end -}}
+
+    {{- if eq $kind "image" -}}
+      {{- $caption := "" -}}
+      {{- if ne $alt "" -}}{{- $caption = printf "<figcaption>%s</figcaption>" (transform.XMLEscape $alt) -}}{{- end -}}
+      {{- /* `%q` is Go string quoting, not attribute escaping: a `"` or `\`
+           in the alt would leave the attribute malformed. URLs go through
+           `%q` because they never carry either; author text goes through
+           `transform.XMLEscape`, the same as the caption beside it. */ -}}
+      {{- $items = $items | append (printf `<figure><a href=%q><img src=%q alt="%s"%s/></a>%s</figure>` $src $src (transform.XMLEscape $alt) $dims $caption) -}}
+    {{- else if eq $kind "video" -}}
+      {{- /* A poster is written only when there is a real still; the pipeline
+           leaves nothing usable otherwise, and `<img src="clip.mp4">` was the
+           bug that taught us. The link sits outside the <video> so it survives
+           a sanitizer that drops the player with its children, and
+           `preload="none"` keeps a reader from pulling the whole file. */ -}}
+      {{- $posterAttr := "" -}}
+      {{- with .poster -}}{{- $posterAttr = printf ` poster=%q` ((string .) | absURL) -}}{{- end -}}
+      {{- $altSuffix := "" -}}
+      {{- if ne $alt "" -}}{{- $altSuffix = printf ": %s" (transform.XMLEscape $alt) -}}{{- end -}}
+      {{- $items = $items | append (printf `<figure><video controls preload="none"%s%s><source src=%q type=%q/></video><figcaption><a href=%q>▶ Watch video</a>%s%s</figcaption></figure>` $posterAttr $dims $src $mimeLabel $src $metaSuffix $altSuffix) -}}
+    {{- else if eq $kind "text" -}}
+      {{- /* Markdown a browser would download or dump unstyled, so the link
+           goes to the page that renders it. */ -}}
+      {{- $href := printf "%s/text/%s" (strings.TrimSuffix "/" $permalink) (string .id) -}}
+      {{- $label := printf "📎 [%s] %s" (transform.XMLEscape $mimeLabel) (transform.XMLEscape (or $name "Attached text")) -}}
+      {{- $textMeta := $metaSuffix -}}
+      {{- with .chars -}}
+        {{- if gt (int .) 0 -}}{{- $textMeta = printf " (%d chars)" (int .) -}}{{- end -}}
+      {{- end -}}
+      {{- $summarySuffix := "" -}}
+      {{- with .summary -}}
+        {{- if ne (string .) "" -}}{{- $summarySuffix = printf ": %s" (transform.XMLEscape (string .)) -}}{{- end -}}
+      {{- end -}}
+      {{- $items = $items | append (printf `<p><a href=%q>%s</a>%s%s</p>` $href $label $textMeta $summarySuffix) -}}
+    {{- else -}}
+      {{- $fallbackName := cond (eq $kind "audio") "Audio" "Attachment" -}}
+      {{- $label := printf "📎 [%s] %s" (transform.XMLEscape $mimeLabel) (transform.XMLEscape (or $name $fallbackName)) -}}
+      {{- $items = $items | append (printf `<p><a href=%q>%s</a>%s</p>` $src $label $metaSuffix) -}}
+    {{- end -}}
+  {{- end -}}
+  {{- $parts = $parts | append (printf "<div data-post-media>\n%s\n</div>" (delimit $items "\n")) -}}
+{{- end -}}
+
 {{- /* --- Star rating --- */ -}}
 {{- with $post.Params.rating -}}
   {{- $r := int . -}}

package/src/services/export-theme/layouts/partials/media-gallery.html

@@ -8,10 +8,14 @@
   `<jant-media-lightbox>` delegates clicks on those anchors.
 
   Layout: mirrors MediaGallery.tsx — one horizontal row with a computed
-  `rowHeight` (driven by the first visual's aspect ratio) so mixed sizes
-  align into a clean strip. Single-visual posts expand to their natural
-  aspect ratio (capped at 24rem / 85% width). Non-visual attachments
-  (audio/doc/text) use a 3:4 portrait card sized to the row height.
+  `rowHeight` so mixed sizes align into a clean strip. The opening visual
+  leads (320px / its ratio), the widest visual is held to 520px so a landscape
+  video never swallows the column, and the result is clamped to 240–384px —
+  384 being the same 24rem cap a lone visual gets, so a second attachment
+  never makes the first picture grow. Non-visual attachments (audio/doc/text)
+  do not enter that math; their 3:4 portrait cards are sized from its result.
+  Single-visual posts skip the strip and expand to their natural aspect ratio
+  (capped at 24rem / 85% width).
 
   Inline styles (not Tailwind utilities) because the exported theme ships
   no utility CSS — only tokens.css + main.css + theme.css + site-media.css.
@@ -27,8 +31,7 @@
   {{- $items := slice -}}
   {{- $lightbox := slice -}}
   {{- $lbIdx := 0 -}}
-  {{- $hasNonVisual := false -}}
-  {{- $firstRatio := 0.0 -}}
+  {{- $visualRatios := slice -}}
   {{- range $media -}}
     {{- $kind := .kind | default "file" -}}
     {{- $item := . -}}
@@ -46,13 +49,15 @@
       {{- $lightbox = $lightbox | append $lbEntry -}}
       {{- $items = $items | append (merge $item (dict "_kind" $kind "_lbIdx" $lbIdx)) -}}
       {{- $lbIdx = add $lbIdx 1 -}}
-      {{- /* Capture first visual's aspect ratio */ -}}
-      {{- if and (eq $firstRatio 0.0) $item.width $item.height (gt (float $item.width) 0.0) (gt (float $item.height) 0.0) -}}
-        {{- $firstRatio = div (float $item.width) (float $item.height) -}}
+      {{- /* Every visual's aspect ratio, in display order — 4:3 when unknown,
+             matching getMediaAspectRatio() in MediaGallery.tsx. */ -}}
+      {{- $ratio := 1.3333 -}}
+      {{- if and $item.width $item.height (gt (float $item.width) 0.0) (gt (float $item.height) 0.0) -}}
+        {{- $ratio = div (float $item.width) (float $item.height) -}}
       {{- end -}}
+      {{- $visualRatios = $visualRatios | append $ratio -}}
     {{- else -}}
       {{- $items = $items | append (merge $item (dict "_kind" $kind)) -}}
-      {{- $hasNonVisual = true -}}
     {{- end -}}
   {{- end -}}
 
@@ -62,14 +67,19 @@
   {{- $firstKind := $first._kind -}}
   {{- $singleVisual := and $single (or (eq $firstKind "image") (eq $firstKind "video")) -}}
 
-  {{- /* rowHeight — mirrors MediaGallery.tsx. 4/3 fallback when no visuals. */ -}}
-  {{- $rowMin := cond $hasNonVisual 220 280 -}}
-  {{- $rowMax := cond $hasNonVisual 300 440 -}}
-  {{- $rowHeight := cond $hasNonVisual 220 360 -}}
-  {{- if and (not $singleVisual) (gt $count 1) (gt $firstRatio 0.0) -}}
-    {{- $ratio := cond (lt $firstRatio 0.5) 0.5 $firstRatio -}}
-    {{- $computed := math.Round (div 320.0 $ratio) -}}
-    {{- $rowHeight = cond (gt $computed $rowMax) $rowMax (cond (lt $computed $rowMin) $rowMin (int $computed)) -}}
+  {{- /* rowHeight — mirrors getGalleryRowHeight() in MediaGallery.tsx. */ -}}
+  {{- $rowMin := 240 -}}
+  {{- $rowMax := 384 -}}
+  {{- $rowHeight := $rowMin -}}
+  {{- if $visualRatios -}}
+    {{- $widest := 0.0 -}}
+    {{- range $visualRatios -}}
+      {{- if gt . $widest }}{{ $widest = . }}{{ end -}}
+    {{- end -}}
+    {{- $byLead := div 320.0 (index $visualRatios 0) -}}
+    {{- $byWidestItem := div 520.0 $widest -}}
+    {{- $computed := math.Round (cond (lt $byWidestItem $byLead) $byWidestItem $byLead) -}}
+    {{- $rowHeight = cond (gt $computed (float $rowMax)) $rowMax (cond (lt $computed (float $rowMin)) $rowMin (int $computed)) -}}
   {{- end -}}
   {{- $docCardWidth := int (math.Round (mul (float $rowHeight) 0.75)) -}}
 
@@ -80,7 +90,7 @@
     <div data-post-media
       {{- if $lightbox }} data-lightbox-group="{{ $lightbox | jsonify }}"{{- end -}}
       {{- if not $singleVisual }} tabindex="0" role="group" aria-label="Media gallery"{{- end -}}
-      style="display: flex; gap: 0.5rem;
+      style="display: flex; gap: 0.75rem;
         {{- if not $singleVisual }} overflow-x: auto; scroll-behavior: smooth; scrollbar-width: none; -ms-overflow-style: none;{{- end }}">
       {{- range $items -}}
         {{- $k := ._kind -}}
@@ -130,10 +140,14 @@
           {{- else -}}
             {{- $videoWrapStyle = printf "%s display: block; flex-shrink: 0; width: %dpx; max-width: 85%%;" $videoWrapStyle $itemWidth -}}
           {{- end -}}
+          {{- /* Fit travels with the size, as in MediaGallery.tsx, and
+                 site-media.css sets none: a clip in a row is cropped to the
+                 row's height like the pictures beside it; a lone clip is
+                 letterboxed in case its frames disagree with the stored size. */ -}}
           {{- $videoStyle := cond $singleVisual
               (cond (and (gt (int (default 0 .width)) 0) (gt (int (default 0 .height)) 0))
-                (printf "display: block; width: 100%%; height: auto; aspect-ratio: %d/%d;" (int .width) (int .height))
-                "display: block; width: 100%; height: auto;")
+                (printf "display: block; width: 100%%; height: auto; aspect-ratio: %d/%d; object-fit: contain;" (int .width) (int .height))
+                "display: block; width: 100%; height: auto; object-fit: contain;")
               (printf "display: block; width: 100%%; height: %dpx; object-fit: cover;" $rowHeight) -}}
           {{- if $isShort -}}
             <div class="media-video-wrap media-video-wrap-short" style="{{ $videoWrapStyle | safeCSS }}">

package/src/services/export-theme/layouts/partials/pagination.html

@@ -2,26 +2,27 @@
 {{- $total := $paginator.TotalPages -}}
 {{- $current := $paginator.PageNumber -}}
 {{- if gt $total 1 -}}
-  {{- /* Mirror main site's getPageNumbers: always include 1, last, current,
-         and current±1. Insert 0 as an ellipsis marker for gaps. */ -}}
+  {{- /* Mirror main site's getPageNumbers: past seven pages, always seven
+         slots — 1, last, and a three-page window around the current page.
+         The second and second-to-last slots hold a page or 0 (an ellipsis
+         marker), so an ellipsis never stands in for a single page. */ -}}
   {{- $pages := slice -}}
   {{- if le $total 7 -}}
     {{- range seq 1 $total -}}
       {{- $pages = $pages | append . -}}
     {{- end -}}
   {{- else -}}
-    {{- $set := slice 1 $total $current -}}
-    {{- if gt $current 1 -}}{{- $set = $set | append (sub $current 1) -}}{{- end -}}
-    {{- if lt $current $total -}}{{- $set = $set | append (add $current 1) -}}{{- end -}}
-    {{- $sorted := sort (uniq $set) -}}
-    {{- $prev := 0 -}}
-    {{- range $i, $p := $sorted -}}
-      {{- if and (gt $i 0) (gt (sub $p $prev) 1) -}}
-        {{- $pages = $pages | append 0 -}}
-      {{- end -}}
-      {{- $pages = $pages | append $p -}}
-      {{- $prev = $p -}}
+    {{- $start := sub $current 1 -}}
+    {{- if lt $start 3 -}}{{- $start = 3 -}}{{- end -}}
+    {{- if gt $start (sub $total 4) -}}{{- $start = sub $total 4 -}}{{- end -}}
+    {{- $end := add $start 2 -}}
+    {{- $pages = $pages | append 1 -}}
+    {{- $pages = $pages | append (cond (eq $start 3) 2 0) -}}
+    {{- range seq $start $end -}}
+      {{- $pages = $pages | append . -}}
     {{- end -}}
+    {{- $pages = $pages | append (cond (eq $end (sub $total 2)) (sub $total 1) 0) -}}
+    {{- $pages = $pages | append $total -}}
   {{- end -}}
   <nav class="pagination" aria-label="Pagination">
     {{- if $paginator.HasPrev -}}

package/src/services/export-theme/layouts/partials/post-card.html

@@ -5,6 +5,10 @@
 {{- $collections := $post.Params.collections | default slice -}}
 {{- $slug := $post.Params.slug | default $post.Slug -}}
 {{- $linkUrl := $post.Params.link_url -}}
+{{- /* A reply is not rendered as a page (`build: render: never`), so its
+     `.RelPermalink` is empty. The exporter registers every reply slug as an
+     alias on the root, and that alias is the address a reply has. */ -}}
+{{- $permalink := $post.RelPermalink | default (printf "/%s/" $slug | relURL) -}}
 <article class="post-card post-card-{{ $format }}" data-format="{{ $format }}" data-slug="{{ $slug }}"
   {{- if $post.Params.pinned_at }} data-post-pinned{{ end -}}
   {{- if $post.Params.featured_at }} data-post-featured{{ end -}}
@@ -27,7 +31,7 @@
         <a href="{{ $linkUrl }}" rel="noopener noreferrer" target="_blank">{{ $post.Title }}</a>
       </h2>
     {{- else if $post.Title -}}
-      <h2 class="post-card-title post-card-link-title"><a href="{{ $post.RelPermalink }}">{{ $post.Title }}</a></h2>
+      <h2 class="post-card-title post-card-link-title"><a href="{{ $permalink }}">{{ $post.Title }}</a></h2>
     {{- end -}}
     {{- /* Prefer Hugo's rendered HTML body — preserves paragraphs, links,
          emphasis, lists. Falls back to the plain-text `summary_text` stored
@@ -73,7 +77,7 @@
     {{- end -}}
   {{- else -}}
     {{- with $post.Title -}}
-      <h2 class="post-card-title"><a href="{{ $post.RelPermalink }}">{{ . }}</a></h2>
+      <h2 class="post-card-title"><a href="{{ $permalink }}">{{ . }}</a></h2>
     {{- end -}}
     {{- /* Prefer Hugo's rendered HTML summary — preserves paragraphs, links,
          emphasis, lists. Falls back to the plain-text `summary_text` stored
@@ -85,7 +89,7 @@
     {{- end -}}
   {{- end -}}
 
-  {{ partial "media-gallery.html" (dict "media" $media "permalink" $post.RelPermalink) }}
+  {{ partial "media-gallery.html" (dict "media" $media "permalink" $permalink) }}
 
   <footer class="post-card-footer post-menu-footer" data-post-meta>
     <div class="post-footer-meta">
@@ -96,7 +100,7 @@
           </svg>
         </span>
       {{- end -}}
-      <a class="post-footer-link post-card-permalink" href="{{ $post.RelPermalink }}">
+      <a class="post-footer-link post-card-permalink" href="{{ $permalink }}">
         <time datetime="{{ $post.Date.Format "2006-01-02T15:04:05Z07:00" }}">
           {{ $post.Date.Format "Jan 2, 2006" }}
         </time>

package/src/services/export-theme/layouts/partials/reply.html

@@ -69,7 +69,8 @@
     </div>
   {{- end -}}
 
-  {{ partial "media-gallery.html" (dict "media" $media "permalink" $reply.RelPermalink) }}
+  {{- /* Replies are not rendered as pages, so the address is the reply's alias on the root. */ -}}
+  {{ partial "media-gallery.html" (dict "media" $media "permalink" ($reply.RelPermalink | default (printf "/%s/" $slug | relURL))) }}
 
   <footer class="reply-footer post-menu-footer" data-post-meta>
     <div class="post-footer-meta">

package/src/services/export-theme/layouts/partials/thread-preview.html

@@ -1,12 +1,17 @@
 {{- /*
   Thread preview partial.
 
-  Matches the main site's `ThreadPreview` component layout:
-    root post  (full card, as "context")
-    second reply (full card, as "context")  ← if distinct
-    "N more posts" gap pill ← if there are hidden middle replies
-    penultimate reply (full card, as "context") ← if distinct
-    latest reply (full card, as "hero")
+  Matches the main site's `ThreadPreview` component, and the fold both it and
+  the feed take from `lib/thread-fold.ts` (`foldThreadReplies`):
+    root post                                (full card, as "context")
+    the first THREAD_LEADING_REPLIES (2)     (full cards, as "context")
+    "N more posts" gap pill                  ← only when the fold hides any
+    the two before the newest reply          (full cards, as "context")
+    newest reply                             (full card, as "hero")
+
+  The trailing window is THREAD_TRAILING_REPLIES (3) with the hero inside it.
+  On a short thread the windows overlap, so each list drops whatever an
+  earlier one already shows, hero first — the same order the site dedupes in.
 
   Each entry is wrapped in a `.thread-item` so the rail dot markers
   line up the same way the main site does via `.thread-item::before`.
@@ -20,29 +25,34 @@
 {{- if eq $replyCount 0 -}}
   {{ partial "post-card.html" $root }}
 {{- else -}}
-  {{- /* First-in / last-in replies, with overlap handled below. */ -}}
   {{- $latest := index $replies (sub $replyCount 1) -}}
-  {{- $second := index $replies 0 -}}
-  {{- $penultimate := cond (gt $replyCount 2) (index $replies (sub $replyCount 2)) false -}}
-
-  {{- $renderSecond := ne $second.File.UniqueID $latest.File.UniqueID -}}
-  {{- $renderPenultimate := and $penultimate (ne $penultimate.File.UniqueID $latest.File.UniqueID) -}}
-  {{- if $penultimate -}}
-    {{- if eq $penultimate.File.UniqueID $second.File.UniqueID -}}
-      {{- $renderPenultimate = false -}}
+  {{- $leading := slice -}}
+  {{- range first 2 $replies -}}
+    {{- if ne .File.UniqueID $latest.File.UniqueID -}}
+      {{- $leading = $leading | append . -}}
+    {{- end -}}
+  {{- end -}}
+  {{- $trailing := slice -}}
+  {{- range last 3 $replies -}}
+    {{- $reply := . -}}
+    {{- $shown := eq $reply.File.UniqueID $latest.File.UniqueID -}}
+    {{- range $leading -}}
+      {{- if eq .File.UniqueID $reply.File.UniqueID -}}{{- $shown = true -}}{{- end -}}
     {{- end -}}
+    {{- if not $shown -}}{{- $trailing = $trailing | append $reply -}}{{- end -}}
   {{- end -}}
 
-  {{- /* Count of context posts actually rendered above the hero (second
-       + penultimate when distinct from latest and each other). The
-       remainder of replies is the "hidden middle" count. Mirrors
-       `getThreadPreviewState` in thread-preview-state.ts. */ -}}
-  {{- $visibleContextReplies := 0 -}}
-  {{- if $renderSecond -}}{{- $visibleContextReplies = add $visibleContextReplies 1 -}}{{- end -}}
-  {{- if $renderPenultimate -}}{{- $visibleContextReplies = add $visibleContextReplies 1 -}}{{- end -}}
-  {{- /* Total replies rendered = visibleContextReplies + 1 (hero). */ -}}
-  {{- $hiddenCount := sub $replyCount (add $visibleContextReplies 1) -}}
-  {{- if lt $hiddenCount 0 -}}{{- $hiddenCount = 0 -}}{{- end -}}
+  {{- /* Whatever neither window shows is the hidden middle. It is never
+       negative: the three lists are disjoint and all drawn from $replies. */ -}}
+  {{- $hiddenCount := sub $replyCount (add (add (len $leading) (len $trailing)) 1) -}}
+  {{- /* The gap leads to the first hidden reply, as the site's does. A fold
+       only hides anything once both windows are full, so that reply sits
+       right after the leading window. Replies are not rendered as pages
+       (`build: render: never`), so their `.RelPermalink` is empty; the
+       exporter registers every reply slug as an alias on the root, and
+       that is the address a reply has. */ -}}
+  {{- $gapHref := $root.RelPermalink -}}
+  {{- if gt $hiddenCount 0 -}}{{- $gapHref = printf "/%s/" (index $replies 2).Slug | relURL -}}{{- end -}}
 
   {{- $slug := $root.Params.slug | default $root.Slug -}}
   <article class="thread-preview" data-slug="{{ $slug }}" data-reply-count="{{ $replyCount }}">
@@ -51,23 +61,23 @@
         {{ partial "post-card.html" $root }}
       </div>
 
-      {{- if $renderSecond -}}
+      {{- range $leading -}}
         <div class="thread-item thread-item-context">
-          {{ partial "post-card.html" $second }}
+          {{ partial "post-card.html" . }}
         </div>
       {{- end -}}
 
       {{- if gt $hiddenCount 0 -}}
         <div class="thread-item thread-item-gap">
-          <a class="thread-preview-gap" href="{{ $root.RelPermalink }}">
+          <a class="thread-preview-gap" href="{{ $gapHref }}">
             {{ $hiddenCount }} more {{ if eq $hiddenCount 1 }}post{{ else }}posts{{ end }}
           </a>
         </div>
       {{- end -}}
 
-      {{- if $renderPenultimate -}}
+      {{- range $trailing -}}
         <div class="thread-item thread-item-context">
-          {{ partial "post-card.html" $penultimate }}
+          {{ partial "post-card.html" . }}
         </div>
       {{- end -}}
     </div>

package/src/services/export-theme/styles/main.css

@@ -36,6 +36,13 @@ body {
   background-color: var(--site-page-bg);
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
+  /* Every text node in an exported page is authored content, and authored text
+     can contain a run with no break opportunity — a long URL, an ID, a word
+     typed without spaces. Such a run does not wrap on its own and spills past
+     the content column across the page. `break-word` splits it only when it
+     cannot fit a line by itself, so ordinary text keeps its natural line breaks
+     and intrinsic sizing is unaffected. */
+  overflow-wrap: break-word;
 }
 
 img,
@@ -1067,6 +1074,11 @@ hr.feed-divider {
   align-items: center;
   gap: 0.45rem;
   flex-wrap: wrap;
+  /* The name and source are flex items, which refuse to shrink below their
+     min-content width. The inherited `break-word` leaves min-content at the
+     longest word and the item still overflows; `anywhere` also shrinks
+     min-content, which is what lets the row wrap. */
+  overflow-wrap: anywhere;
   margin-top: 0.95rem;
   color: var(--site-text-secondary);
   font-family: var(--font-ui);
@@ -1998,7 +2010,7 @@ hr.feed-divider {
 .pagination {
   display: flex;
   align-items: center;
-  justify-content: center;
+  justify-content: flex-start;
   flex-wrap: wrap;
   gap: 1rem;
   padding: 1.5rem 0;