@aitrien/motifspec 1.13.0 → 1.13.2

package/layouts/_markup/render-codeblock.html

@@ -1,18 +1,18 @@
-{{- /* code-block.md: header bar (language, optional file, copy button revealed by codex.js) around Chroma's
-       classed output. Breakout when a line is longer than the prose measure (size.measure.prose, in characters),
-       as code-block.md asks. Use {file="path"} for a path. */ -}}
-{{- $lang := .Type | default "text" -}}
-{{- $measure := (index (partialCached "motifspec/tokens.html" "tokens") "size.measure.prose").value | replaceRE `[^0-9]` "" | int -}}
-{{- $long := false -}}
-{{- range split .Inner "\n" }}{{ if gt (strings.RuneCount .) $measure }}{{ $long = true }}{{ end }}{{ end -}}
-{{- $result := transform.HighlightCodeBlock . -}}
-<figure class="cx-code{{ if $long }} cx-code--breakout{{ end }}">
-  <figcaption class="cx-code__bar">
-    <span>{{ $lang }}</span>
-    {{- with .Attributes.file }}
-    <span class="cx-code__file">{{ . }}</span>
-    {{- end }}
-    <button class="cx-code__copy" type="button" hidden><svg class="cx-icon cx-icon--sm" aria-hidden="true" focusable="false"><use data-copy-icon href="#cx-icon-content-copy"></use></svg><span class="cx-code__copy-label">Copy</span></button>
-  </figcaption>
-  {{ replaceRE ` file="[^"]*"` "" (string $result.Wrapped) 1 | safeHTML }}
-</figure>
+{{- /* code-block.md: header bar (language, optional file, copy button revealed by codex.js) around Chroma's
+       classed output. Breakout when a line is longer than the prose measure (size.measure.prose, in characters),
+       as code-block.md asks. Use {file="path"} for a path. */ -}}
+{{- $lang := .Type | default "text" -}}
+{{- $measure := (index (partialCached "motifspec/tokens.html" "tokens") "size.measure.prose").value | replaceRE `[^0-9]` "" | int -}}
+{{- $long := false -}}
+{{- range split .Inner "\n" }}{{ if gt (strings.RuneCount .) $measure }}{{ $long = true }}{{ end }}{{ end -}}
+{{- $result := transform.HighlightCodeBlock . -}}
+<figure class="cx-code{{ if $long }} cx-code--breakout{{ end }}">
+  <figcaption class="cx-code__bar">
+    <span>{{ $lang }}</span>
+    {{- with .Attributes.file }}
+    <span class="cx-code__file">{{ . }}</span>
+    {{- end }}
+    <button class="cx-code__copy" type="button" hidden><svg class="cx-icon cx-icon--sm" aria-hidden="true" focusable="false"><use data-copy-icon href="#cx-icon-content-copy"></use></svg><span class="cx-code__copy-label">Copy</span></button>
+  </figcaption>
+  {{ replaceRE ` file="[^"]*"` "" (string $result.Wrapped) 1 | safeHTML }}
+</figure>

package/layouts/_markup/render-heading.html

@@ -1,2 +1,2 @@
-{{- /* heading-anchor.md: every heading gets an id; h2s get the "#" anchor after a space. */ -}}
-<h{{ .Level }} id="{{ .Anchor }}">{{ .Text }}{{ if eq .Level 2 }} <a class="cx-anchor" href="#{{ .Anchor }}" aria-label="Link to {{ .PlainText }}">#</a>{{ end }}</h{{ .Level }}>
+{{- /* heading-anchor.md: every heading gets an id; h2s get the "#" anchor after a space. */ -}}
+<h{{ .Level }} id="{{ .Anchor }}">{{ .Text }}{{ if eq .Level 2 }} <a class="cx-anchor" href="#{{ .Anchor }}" aria-label="Link to {{ .PlainText }}">#</a>{{ end }}</h{{ .Level }}>

package/layouts/_markup/render-image.html

@@ -1,14 +1,14 @@
-{{- /* figure.md. A standalone image becomes a numbered figure: ![alt](file "caption"). On a page with a `hero` in front matter,
-       the hero is Plate 1, so content plates start at 2. Inline images stay plain. Alt text is required.
-       {width="prose"} on the line after a figure keeps it to the prose measure instead of breaking out. */ -}}
-{{- $img := .Page.Resources.Get .Destination -}}
-{{- if not $img }}{{ errorf "content/%s: image %q is not in the page bundle." .Page.File.Path .Destination }}{{ end -}}
-{{- if not .PlainText }}{{ errorf "content/%s: image %q has no alt text. Describe what the image shows (figure.md)." .Page.File.Path .Destination }}{{ end -}}
-{{- if .IsBlock -}}
-  {{- if not .Title }}{{ errorf "content/%s: figure %q has no caption. Add one as the image title: ![alt](file \"what to notice\")." .Page.File.Path .Destination }}{{ end -}}
-  {{- $first := cond (isset .Page.Params "hero") 2 1 -}}
-  {{- partial "motifspec/figure.html" (dict "image" $img "alt" .PlainText "caption" (.Title | markdownify) "plate" (add .Ordinal $first) "prose" (eq (index .Attributes "width") "prose")) -}}
-{{- else -}}
-  {{- $s := $img.Process "webp" -}}
-  <img src="{{ $s.RelPermalink }}" alt="{{ .PlainText }}" width="{{ $s.Width }}" height="{{ $s.Height }}" loading="lazy" decoding="async">
-{{- end -}}
+{{- /* figure.md. A standalone image becomes a numbered figure: ![alt](file "caption"). On a page with a `hero` in front matter,
+       the hero is Plate 1, so content plates start at 2. Inline images stay plain. Alt text is required.
+       {width="prose"} on the line after a figure keeps it to the prose measure instead of breaking out. */ -}}
+{{- $img := .Page.Resources.Get .Destination -}}
+{{- if not $img }}{{ errorf "content/%s: image %q is not in the page bundle." .Page.File.Path .Destination }}{{ end -}}
+{{- if not .PlainText }}{{ errorf "content/%s: image %q has no alt text. Describe what the image shows (figure.md)." .Page.File.Path .Destination }}{{ end -}}
+{{- if .IsBlock -}}
+  {{- if not .Title }}{{ errorf "content/%s: figure %q has no caption. Add one as the image title: ![alt](file \"what to notice\")." .Page.File.Path .Destination }}{{ end -}}
+  {{- $first := cond (isset .Page.Params "hero") 2 1 -}}
+  {{- partial "motifspec/figure.html" (dict "image" $img "alt" .PlainText "caption" (.Title | markdownify) "plate" (add .Ordinal $first) "prose" (eq (index .Attributes "width") "prose")) -}}
+{{- else -}}
+  {{- $s := $img.Process "webp" -}}
+  <img src="{{ $s.RelPermalink }}" alt="{{ .PlainText }}" width="{{ $s.Width }}" height="{{ $s.Height }}" loading="lazy" decoding="async">
+{{- end -}}

package/layouts/_markup/render-link.html

@@ -1,14 +1,14 @@
-{{- /* Links in prose. Internal page links are resolved (a broken one fails the build); links that leave the
-       site get the arrow-outward icon after their text (site-footer.md, icon.md). */ -}}
-{{- $dest := .Destination -}}
-{{- $u := urls.Parse $dest -}}
-{{- $external := and $u.Host (ne $u.Host (urls.Parse site.BaseURL).Host) -}}
-{{- if and (not $u.Scheme) (not $u.Host) $u.Path -}}
-  {{- with or (.Page.GetPage $u.Path) (site.GetPage $u.Path) -}}
-    {{- $dest = printf "%s%s" .RelPermalink (cond (ne $u.Fragment "") (printf "#%s" $u.Fragment) "") -}}
-  {{- else -}}
-    {{- with $.Page.Resources.Get $u.Path }}{{ $dest = .RelPermalink }}{{ else }}{{ if not (hasPrefix $u.Path "/") }}{{ errorf "content/%s: link %q does not resolve to a page or bundle file." $.Page.File.Path $.Destination }}{{ end }}{{ end -}}
-  {{- end -}}
-{{- end -}}
-<a href="{{ $dest | safeURL }}"{{ with .Title }} title="{{ . }}"{{ end }}{{ if $external }} rel="noopener"{{ end }}>{{ .Text }}{{ if $external }}<svg class="cx-icon cx-icon--sm" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-outward"></use></svg>{{ end }}</a>
-{{- /* chomp */ -}}
+{{- /* Links in prose. Internal page links are resolved (a broken one fails the build); links that leave the
+       site get the arrow-outward icon after their text (site-footer.md, icon.md). */ -}}
+{{- $dest := .Destination -}}
+{{- $u := urls.Parse $dest -}}
+{{- $external := and $u.Host (ne $u.Host (urls.Parse site.BaseURL).Host) -}}
+{{- if and (not $u.Scheme) (not $u.Host) $u.Path -}}
+  {{- with or (.Page.GetPage $u.Path) (site.GetPage $u.Path) -}}
+    {{- $dest = printf "%s%s" .RelPermalink (cond (ne $u.Fragment "") (printf "#%s" $u.Fragment) "") -}}
+  {{- else -}}
+    {{- with $.Page.Resources.Get $u.Path }}{{ $dest = .RelPermalink }}{{ else }}{{ if not (hasPrefix $u.Path "/") }}{{ errorf "content/%s: link %q does not resolve to a page or bundle file." $.Page.File.Path $.Destination }}{{ end }}{{ end -}}
+  {{- end -}}
+{{- end -}}
+<a href="{{ $dest | safeURL }}"{{ with .Title }} title="{{ . }}"{{ end }}{{ if $external }} rel="noopener"{{ end }}>{{ .Text }}{{ if $external }}<svg class="cx-icon cx-icon--sm" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-outward"></use></svg>{{ end }}</a>
+{{- /* chomp */ -}}

package/layouts/_markup/render-table.html

@@ -1,31 +1,31 @@
-{{- /* data-table.md: a focusable region named by its caption ({caption="…"} after the table; " | " becomes a
-       separator), the first cell of each row as a row header, numeric or right-aligned columns marked is-num,
-       and breakout above four columns. */ -}}
-{{- $file := printf "content/%s" .Page.File.Path -}}
-{{- $caption := .Attributes.caption -}}
-{{- if not $caption }}{{ errorf "%s: table %d has no caption. Add {caption=\"…\"} on the line after it (data-table.md)." $file (add .Ordinal 1) }}{{ end -}}
-{{- $id := printf "tbl-%s-%d" (.Page.File.ContentBaseName | urlize) .Ordinal -}}
-{{- $cols := 0 }}{{ range first 1 .THead }}{{ $cols = len . }}{{ end -}}
-{{- $num := slice -}}
-{{- range $c := seq 0 (sub $cols 1) -}}
-  {{- $isNum := true -}}
-  {{- range $.TBody }}{{ $cell := index . $c }}{{ if not (findRE `^[-+−]?[0-9][0-9.,]*(\s?[%×x])?$` (string $cell.Text | plainify | strings.TrimSpace)) }}{{ $isNum = false }}{{ end }}{{ end -}}
-  {{- range first 1 $.THead }}{{ if eq (index . $c).Alignment "right" }}{{ $isNum = true }}{{ end }}{{ end -}}
-  {{- $num = $num | append (and $isNum (gt $c 0)) -}}
-{{- end }}
-<div class="cx-table{{ if gt $cols 4 }} cx-table--breakout{{ end }}" role="region" aria-labelledby="{{ $id }}" tabindex="0">
-  <table>
-    <caption id="{{ $id }}">{{ replace (string $caption) " | " ` <span class="cx-sep" aria-hidden="true">|</span> ` | safeHTML }}</caption>
-    <thead>
-      {{- range .THead }}
-      <tr>{{ range $i, $c := . }}<th scope="col"{{ if index $num $i }} class="is-num"{{ end }}>{{ $c.Text }}</th>{{ end }}</tr>
-      {{- end }}
-    </thead>
-    <tbody>
-      {{- range .TBody }}
-      <tr>{{ range $i, $c := . }}{{ if eq $i 0 }}<th scope="row">{{ $c.Text }}</th>{{ else }}<td{{ if index $num $i }} class="is-num"{{ end }}>{{ $c.Text }}</td>{{ end }}{{ end }}</tr>
-      {{- end }}
-    </tbody>
-  </table>
-</div>
-{{- /* chomp */ -}}
+{{- /* data-table.md: a focusable region named by its caption ({caption="…"} after the table; " | " becomes a
+       separator), the first cell of each row as a row header, numeric or right-aligned columns marked is-num,
+       and breakout above four columns. */ -}}
+{{- $file := printf "content/%s" .Page.File.Path -}}
+{{- $caption := .Attributes.caption -}}
+{{- if not $caption }}{{ errorf "%s: table %d has no caption. Add {caption=\"…\"} on the line after it (data-table.md)." $file (add .Ordinal 1) }}{{ end -}}
+{{- $id := printf "tbl-%s-%d" (.Page.File.ContentBaseName | urlize) .Ordinal -}}
+{{- $cols := 0 }}{{ range first 1 .THead }}{{ $cols = len . }}{{ end -}}
+{{- $num := slice -}}
+{{- range $c := seq 0 (sub $cols 1) -}}
+  {{- $isNum := true -}}
+  {{- range $.TBody }}{{ $cell := index . $c }}{{ if not (findRE `^[-+−]?[0-9][0-9.,]*(\s?[%×x])?$` (string $cell.Text | plainify | strings.TrimSpace)) }}{{ $isNum = false }}{{ end }}{{ end -}}
+  {{- range first 1 $.THead }}{{ if eq (index . $c).Alignment "right" }}{{ $isNum = true }}{{ end }}{{ end -}}
+  {{- $num = $num | append (and $isNum (gt $c 0)) -}}
+{{- end }}
+<div class="cx-table{{ if gt $cols 4 }} cx-table--breakout{{ end }}" role="region" aria-labelledby="{{ $id }}" tabindex="0">
+  <table>
+    <caption id="{{ $id }}">{{ replace (string $caption) " | " ` <span class="cx-sep" aria-hidden="true">|</span> ` | safeHTML }}</caption>
+    <thead>
+      {{- range .THead }}
+      <tr>{{ range $i, $c := . }}<th scope="col"{{ if index $num $i }} class="is-num"{{ end }}>{{ $c.Text }}</th>{{ end }}</tr>
+      {{- end }}
+    </thead>
+    <tbody>
+      {{- range .TBody }}
+      <tr>{{ range $i, $c := . }}{{ if eq $i 0 }}<th scope="row">{{ $c.Text }}</th>{{ else }}<td{{ if index $num $i }} class="is-num"{{ end }}>{{ $c.Text }}</td>{{ end }}{{ end }}</tr>
+      {{- end }}
+    </tbody>
+  </table>
+</div>
+{{- /* chomp */ -}}

package/layouts/_partials/motifspec/accession/id.html

@@ -1,2 +1,2 @@
-{{- /* accession-label.md, compact form for meta lines: number, date, reading time. Context: a page. */ -}}
-<p class="cx-id"><span class="cx-id__no">{{ .Params.accession }}</span><time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "2006-01-02" }}</time><span>{{ .ReadingTime }} min read</span></p>
+{{- /* accession-label.md, compact form for meta lines: number, date, reading time. Context: a page. */ -}}
+<p class="cx-id"><span class="cx-id__no">{{ .Params.accession }}</span><time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "2006-01-02" }}</time><span>{{ .ReadingTime }} min read</span></p>

package/layouts/_partials/motifspec/accession/label.html

@@ -1,18 +1,18 @@
-{{- /* accession-label.md, full form: number first, then date, then everything else.
-       Context: dict "page" and "variant": "lead" (above the title; role and stack are __detail fields, which a phone
-       hides) or "card" (after the article; the full label, shown only on a phone). */ -}}
-{{- $p := .page -}}
-{{- $lead := eq .variant "lead" -}}
-<dl class="cx-label cx-label--{{ .variant }}" aria-label="Accession label">
-  <div class="cx-label__id"><dt>No.</dt><dd>{{ $p.Params.accession }}</dd></div>
-  <div><dt>Filed</dt><dd><time datetime="{{ $p.Date.Format "2006-01-02" }}">{{ $p.Date.Format "2006-01-02" }}</time></dd></div>
-  {{- with $p.Params.role }}
-  <div{{ if $lead }} class="cx-label__detail"{{ end }}><dt>Role</dt><dd>{{ . }}</dd></div>
-  {{- end }}
-  {{- with $p.Params.stack }}
-  <div{{ if $lead }} class="cx-label__detail"{{ end }}><dt>Stack</dt><dd>{{ range $i, $s := . }}{{ if $i }} <span class="cx-sep" aria-hidden="true">|</span> {{ end }}{{ $s }}{{ end }}</dd></div>
-  {{- end }}
-  {{- with $p.Params.status }}
-  <div><dt>Status</dt><dd>{{ partial "motifspec/accession/status.html" . }}</dd></div>
-  {{- end }}
-</dl>
+{{- /* accession-label.md, full form: number first, then date, then everything else.
+       Context: dict "page" and "variant": "lead" (above the title; role and stack are __detail fields, which a phone
+       hides) or "card" (after the article; the full label, shown only on a phone). */ -}}
+{{- $p := .page -}}
+{{- $lead := eq .variant "lead" -}}
+<dl class="cx-label cx-label--{{ .variant }}" aria-label="Accession label">
+  <div class="cx-label__id"><dt>No.</dt><dd>{{ $p.Params.accession }}</dd></div>
+  <div><dt>Filed</dt><dd><time datetime="{{ $p.Date.Format "2006-01-02" }}">{{ $p.Date.Format "2006-01-02" }}</time></dd></div>
+  {{- with $p.Params.role }}
+  <div{{ if $lead }} class="cx-label__detail"{{ end }}><dt>Role</dt><dd>{{ . }}</dd></div>
+  {{- end }}
+  {{- with $p.Params.stack }}
+  <div{{ if $lead }} class="cx-label__detail"{{ end }}><dt>Stack</dt><dd>{{ range $i, $s := . }}{{ if $i }} <span class="cx-sep" aria-hidden="true">|</span> {{ end }}{{ $s }}{{ end }}</dd></div>
+  {{- end }}
+  {{- with $p.Params.status }}
+  <div><dt>Status</dt><dd>{{ partial "motifspec/accession/status.html" . }}</dd></div>
+  {{- end }}
+</dl>

package/layouts/_partials/motifspec/accession/status.html

@@ -1,2 +1,2 @@
-{{- /* cx-status: a dot plus a word, never colour alone. Context: live | building | archived. */ -}}
-<span class="cx-status cx-status--{{ . }}">{{ . | strings.FirstUpper }}</span>
+{{- /* cx-status: a dot plus a word, never colour alone. Context: live | building | archived. */ -}}
+<span class="cx-status cx-status--{{ . }}">{{ . | strings.FirstUpper }}</span>

package/layouts/_partials/motifspec/article.html

@@ -1,24 +1,24 @@
-{{- /* The cx-article layout: TOC before the main column in the DOM, then prose ending in the flower end mark.
-       Context: dict "page" "toc" (always | auto). auto shows the TOC when the content has three or more h2s
-       (table-of-contents.md); a case study passes always. */ -}}
-{{- $p := .page -}}
-{{- $h2s := partial "motifspec/h2s.html" $p -}}
-{{- $toc := or (eq .toc "always") (ge (len $h2s) 3) -}}
-{{- if and (eq .toc "always") (lt (len $h2s) 1) }}{{ errorf "content/%s: toc \"always\" needs h2 sections to list (table-of-contents.md)." $p.File.Path }}{{ end -}}
-{{- /* ornament.md: the flower ("g") goes after the last sentence, so the content must end with a paragraph. */ -}}
-{{- $content := $p.Content | strings.TrimSpace -}}
-{{- if gt (len (findRE `class="cx-callout[ "]` $content)) 2 }}{{ errorf "content/%s: more than two callouts in one article; they lose force when repeated (callout.md)." $p.File.Path }}{{ end -}}
-{{- $endMark := `<span class="cx-end-mark" aria-hidden="true">g</span></p>` -}}
-{{- if strings.HasSuffix $content "</p>" -}}
-  {{- $content = printf "%s%s" (strings.TrimSuffix "</p>" $content) $endMark -}}
-{{- else -}}
-  {{- warnf "content/%s: the article should end with a paragraph so the end mark follows the last sentence." $p.File.Path -}}
-{{- end }}
-<div class="cx-article">
-  {{- if $toc }}
-  {{ partial "motifspec/table-of-contents.html" $p }}
-  {{- end }}
-  <div class="cx-article__main cx-prose">
-    {{ $content | safeHTML }}
-  </div>
-</div>
+{{- /* The cx-article layout: TOC before the main column in the DOM, then prose ending in the flower end mark.
+       Context: dict "page" "toc" (always | auto). auto shows the TOC when the content has three or more h2s
+       (table-of-contents.md); a case study passes always. */ -}}
+{{- $p := .page -}}
+{{- $h2s := partial "motifspec/h2s.html" $p -}}
+{{- $toc := or (eq .toc "always") (ge (len $h2s) 3) -}}
+{{- if and (eq .toc "always") (lt (len $h2s) 1) }}{{ errorf "content/%s: toc \"always\" needs h2 sections to list (table-of-contents.md)." $p.File.Path }}{{ end -}}
+{{- /* ornament.md: the flower ("g") goes after the last sentence, so the content must end with a paragraph. */ -}}
+{{- $content := $p.Content | strings.TrimSpace -}}
+{{- if gt (len (findRE `class="cx-callout[ "]` $content)) 2 }}{{ errorf "content/%s: more than two callouts in one article; they lose force when repeated (callout.md)." $p.File.Path }}{{ end -}}
+{{- $endMark := `<span class="cx-end-mark" aria-hidden="true">g</span></p>` -}}
+{{- if strings.HasSuffix $content "</p>" -}}
+  {{- $content = printf "%s%s" (strings.TrimSuffix "</p>" $content) $endMark -}}
+{{- else -}}
+  {{- warnf "content/%s: the article should end with a paragraph so the end mark follows the last sentence." $p.File.Path -}}
+{{- end }}
+<div class="cx-article">
+  {{- if $toc }}
+  {{ partial "motifspec/table-of-contents.html" $p }}
+  {{- end }}
+  <div class="cx-article__main cx-prose">
+    {{ $content | safeHTML }}
+  </div>
+</div>

package/layouts/_partials/motifspec/back-link.html

@@ -1,2 +1,2 @@
-{{- /* button-and-link.md, back link. Context: dict "href" "label". */ -}}
-<a class="cx-back" href="{{ .href }}"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>{{ .label }}</a>
+{{- /* button-and-link.md, back link. Context: dict "href" "label". */ -}}
+<a class="cx-back" href="{{ .href }}"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>{{ .label }}</a>

package/layouts/_partials/motifspec/body-end.html

@@ -1,5 +1,5 @@
-{{- /* docs/hugo.md. Call last inside <body>: drifts the backdrop and reveals the header's pause control. Without it
-       the contours stay still. */ -}}
-{{- with resources.Get "motifspec/plate.js" | minify | fingerprint }}
-<script src="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous" defer></script>
-{{- end }}
+{{- /* docs/hugo.md. Call last inside <body>: drifts the backdrop and reveals the header's pause control. Without it
+       the contours stay still. */ -}}
+{{- with resources.Get "motifspec/plate.js" | minify | fingerprint }}
+<script src="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous" defer></script>
+{{- end }}

package/layouts/_partials/motifspec/body-start.html

@@ -1,5 +1,5 @@
-{{- /* docs/hugo.md. Call first inside <body class="cx-backdrop-page">: the contour backdrop (backdrop.md), the icon
-       sprite (icon.md), once, before anything that uses it, and the skip link to <main id="main">. */ -}}
-{{ with resources.Get "motifspec/backdrop.html" }}{{ .Content | safeHTML }}{{ else }}{{ errorf "motifspec/backdrop.html is missing: is the MotifSpec module imported?" }}{{ end }}
-<div hidden>{{ with resources.Get "motifspec/icons.svg" }}{{ .Content | safeHTML }}{{ end }}</div>
-<a class="cx-skip-link" href="#main">Skip to content</a>
+{{- /* docs/hugo.md. Call first inside <body class="cx-backdrop-page">: the contour backdrop (backdrop.md), the icon
+       sprite (icon.md), once, before anything that uses it, and the skip link to <main id="main">. */ -}}
+{{ with resources.Get "motifspec/backdrop.html" }}{{ .Content | safeHTML }}{{ else }}{{ errorf "motifspec/backdrop.html is missing: is the MotifSpec module imported?" }}{{ end }}
+<div hidden>{{ with resources.Get "motifspec/icons.svg" }}{{ .Content | safeHTML }}{{ end }}</div>
+<a class="cx-skip-link" href="#main">Skip to content</a>

package/layouts/_partials/motifspec/figure.html

@@ -1,14 +1,14 @@
-{{- /* figure.md for a raster image from the page bundle: WebP at two widths, explicit width and height, and a
-       numbered plate in the caption. Context: dict "image" (resource) "alt" "caption" (HTML) "plate" (number)
-       "eager" (true for the case-study hero, the likely largest paint) "prose" (true to keep the figure to the prose
-       measure instead of breaking out, for a supporting image). */ -}}
-{{- $img := .image -}}
-{{- $w := cond (gt $img.Width 1600) 1600 $img.Width -}}
-{{- $large := $img.Process (printf "resize %dx webp" $w) -}}
-{{- $small := $img.Process (printf "resize %dx webp" (div $w 2)) -}}
-<figure class="cx-figure{{ if not .prose }} cx-figure--breakout{{ end }}">
-  <div class="cx-figure__frame">
-    <img src="{{ $large.RelPermalink }}" srcset="{{ $small.RelPermalink }} {{ $small.Width }}w, {{ $large.RelPermalink }} {{ $large.Width }}w" alt="{{ .alt }}" width="{{ $large.Width }}" height="{{ $large.Height }}"{{ if .eager }} fetchpriority="high"{{ else }} loading="lazy"{{ end }} decoding="async">
-  </div>
-  <figcaption><span class="cx-figure__plate">Plate {{ .plate }}</span>{{ .caption }}</figcaption>
-</figure>
+{{- /* figure.md for a raster image from the page bundle: WebP at two widths, explicit width and height, and a
+       numbered plate in the caption. Context: dict "image" (resource) "alt" "caption" (HTML) "plate" (number)
+       "eager" (true for the case-study hero, the likely largest paint) "prose" (true to keep the figure to the prose
+       measure instead of breaking out, for a supporting image). */ -}}
+{{- $img := .image -}}
+{{- $w := cond (gt $img.Width 1600) 1600 $img.Width -}}
+{{- $large := $img.Process (printf "resize %dx webp" $w) -}}
+{{- $small := $img.Process (printf "resize %dx webp" (div $w 2)) -}}
+<figure class="cx-figure{{ if not .prose }} cx-figure--breakout{{ end }}">
+  <div class="cx-figure__frame">
+    <img src="{{ $large.RelPermalink }}" srcset="{{ $small.RelPermalink }} {{ $small.Width }}w, {{ $large.RelPermalink }} {{ $large.Width }}w" alt="{{ .alt }}" width="{{ $large.Width }}" height="{{ $large.Height }}"{{ if .eager }} fetchpriority="high"{{ else }} loading="lazy"{{ end }} decoding="async">
+  </div>
+  <figcaption><span class="cx-figure__plate">Plate {{ .plate }}</span>{{ .caption }}</figcaption>
+</figure>

package/layouts/_partials/motifspec/filed-under.html

@@ -1,5 +1,5 @@
-{{- /* The "Filed under" tags after an article (docs/templates.md, tag.md). Context: a page. */ -}}
-<div class="cx-stack">
-  <p class="cx-eyebrow">Filed under</p>
-  {{ partial "motifspec/tags.html" (dict "page" . "max" 5) }}
-</div>
+{{- /* The "Filed under" tags after an article (docs/templates.md, tag.md). Context: a page. */ -}}
+<div class="cx-stack">
+  <p class="cx-eyebrow">Filed under</p>
+  {{ partial "motifspec/tags.html" (dict "page" . "max" 5) }}
+</div>

package/layouts/_partials/motifspec/h2s.html

@@ -1,7 +1,7 @@
-{{- /* The content's h2 headings (with their h3 children) from Hugo's fragments tree. Content starts at h2, so
-       the tree's top level is a placeholder for the missing h1; step down to the first level that has an h2. */ -}}
-{{- $out := slice -}}
-{{- range .Fragments.Headings -}}
-  {{- if eq .Level 2 }}{{ $out = $out | append . }}{{ else }}{{ range .Headings }}{{ if eq .Level 2 }}{{ $out = $out | append . }}{{ end }}{{ end }}{{ end -}}
-{{- end -}}
-{{- return $out -}}
+{{- /* The content's h2 headings (with their h3 children) from Hugo's fragments tree. Content starts at h2, so
+       the tree's top level is a placeholder for the missing h1; step down to the first level that has an h2. */ -}}
+{{- $out := slice -}}
+{{- range .Fragments.Headings -}}
+  {{- if eq .Level 2 }}{{ $out = $out | append . }}{{ else }}{{ range .Headings }}{{ if eq .Level 2 }}{{ $out = $out | append . }}{{ end }}{{ end }}{{ end -}}
+{{- end -}}
+{{- return $out -}}

package/layouts/_partials/motifspec/head.html

@@ -1,15 +1,15 @@
-{{- /* docs/hugo.md. Call inside <head>: the theme snippet, font preloads, the stylesheet and the behaviour script.
-       Order matters: the theme snippet runs before the stylesheet is parsed, so a stored theme is on <html> before
-       first paint. Everything is self-hosted from this module. */ -}}
-{{- with resources.Get "motifspec/theme-init.js" }}
-<script>{{ .Content | safeJS }}</script>
-{{- else }}{{ errorf "motifspec/theme-init.js is missing: is the MotifSpec module imported?" }}{{ end }}
-<link rel="preload" href="/fonts/national-park-latin-wght.woff2" as="font" type="font/woff2" crossorigin>
-<link rel="preload" href="/fonts/yarndings-12-latin.woff2" as="font" type="font/woff2" crossorigin>
-{{- /* Published at /motifspec/…: one level below the root, so the stylesheet's ../fonts/ URLs reach /fonts/. */}}
-{{- with resources.Get "motifspec/codex.css" | minify | fingerprint }}
-<link rel="stylesheet" href="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
-{{- end }}
-{{- with resources.Get "motifspec/codex.js" | minify | fingerprint }}
-<script src="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous" defer></script>
-{{- end }}
+{{- /* docs/hugo.md. Call inside <head>: the theme snippet, font preloads, the stylesheet and the behaviour script.
+       Order matters: the theme snippet runs before the stylesheet is parsed, so a stored theme is on <html> before
+       first paint. Everything is self-hosted from this module. */ -}}
+{{- with resources.Get "motifspec/theme-init.js" }}
+<script>{{ .Content | safeJS }}</script>
+{{- else }}{{ errorf "motifspec/theme-init.js is missing: is the MotifSpec module imported?" }}{{ end }}
+<link rel="preload" href="/fonts/national-park-latin-wght.woff2" as="font" type="font/woff2" crossorigin>
+<link rel="preload" href="/fonts/yarndings-12-latin.woff2" as="font" type="font/woff2" crossorigin>
+{{- /* Published at /motifspec/…: one level below the root, so the stylesheet's ../fonts/ URLs reach /fonts/. */}}
+{{- with resources.Get "motifspec/codex.css" | minify | fingerprint }}
+<link rel="stylesheet" href="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
+{{- end }}
+{{- with resources.Get "motifspec/codex.js" | minify | fingerprint }}
+<script src="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous" defer></script>
+{{- end }}

package/layouts/_partials/motifspec/pagination-entries.html

@@ -1,34 +1,34 @@
-{{- /* pagination.md between entries of one collection, oldest = 1. Previous is the older entry, Next the newer.
-       A missing direction stays as a disabled cell. Context: dict "page" "label" ("Post navigation") "noun" ("Post"). */ -}}
-{{- $p := .page -}}
-{{- $all := (where site.RegularPages "Section" $p.Section).ByDate -}}
-{{- $at := 0 }}{{ range $i, $e := $all }}{{ if eq $e.RelPermalink $p.RelPermalink }}{{ $at = $i }}{{ end }}{{ end -}}
-{{- $prev := cond (gt $at 0) (index $all (sub $at 1)) nil -}}
-{{- $next := cond (lt (add $at 1) (len $all)) (index $all (add $at 1)) nil -}}
-{{- if gt (len $all) 1 }}
-<nav class="cx-pagination" aria-label="{{ .label }}">
-  {{- with $prev }}
-  <a class="cx-pagination__link" href="{{ .RelPermalink }}" rel="prev">
-    <span class="cx-pagination__dir"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>Previous</span>
-    <span class="cx-pagination__title">{{ .Title }}</span>
-  </a>
-  {{- else }}
-  <span class="cx-pagination__link" rel="prev" aria-disabled="true">
-    <span class="cx-pagination__dir"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>Previous</span>
-    <span class="cx-pagination__title">First entry</span>
-  </span>
-  {{- end }}
-  <p class="cx-pagination__status">{{ .noun }}<strong>{{ add $at 1 }} / {{ len $all }}</strong></p>
-  {{- with $next }}
-  <a class="cx-pagination__link" href="{{ .RelPermalink }}" rel="next">
-    <span class="cx-pagination__dir">Next<svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-forward"></use></svg></span>
-    <span class="cx-pagination__title">{{ .Title }}</span>
-  </a>
-  {{- else }}
-  <span class="cx-pagination__link" rel="next" aria-disabled="true">
-    <span class="cx-pagination__dir">Next<svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-forward"></use></svg></span>
-    <span class="cx-pagination__title">Latest entry</span>
-  </span>
-  {{- end }}
-</nav>
-{{- end -}}
+{{- /* pagination.md between entries of one collection, oldest = 1. Previous is the older entry, Next the newer.
+       A missing direction stays as a disabled cell. Context: dict "page" "label" ("Post navigation") "noun" ("Post"). */ -}}
+{{- $p := .page -}}
+{{- $all := (where site.RegularPages "Section" $p.Section).ByDate -}}
+{{- $at := 0 }}{{ range $i, $e := $all }}{{ if eq $e.RelPermalink $p.RelPermalink }}{{ $at = $i }}{{ end }}{{ end -}}
+{{- $prev := cond (gt $at 0) (index $all (sub $at 1)) nil -}}
+{{- $next := cond (lt (add $at 1) (len $all)) (index $all (add $at 1)) nil -}}
+{{- if gt (len $all) 1 }}
+<nav class="cx-pagination" aria-label="{{ .label }}">
+  {{- with $prev }}
+  <a class="cx-pagination__link" href="{{ .RelPermalink }}" rel="prev">
+    <span class="cx-pagination__dir"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>Previous</span>
+    <span class="cx-pagination__title">{{ .Title }}</span>
+  </a>
+  {{- else }}
+  <span class="cx-pagination__link" rel="prev" aria-disabled="true">
+    <span class="cx-pagination__dir"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>Previous</span>
+    <span class="cx-pagination__title">First entry</span>
+  </span>
+  {{- end }}
+  <p class="cx-pagination__status">{{ .noun }}<strong>{{ add $at 1 }} / {{ len $all }}</strong></p>
+  {{- with $next }}
+  <a class="cx-pagination__link" href="{{ .RelPermalink }}" rel="next">
+    <span class="cx-pagination__dir">Next<svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-forward"></use></svg></span>
+    <span class="cx-pagination__title">{{ .Title }}</span>
+  </a>
+  {{- else }}
+  <span class="cx-pagination__link" rel="next" aria-disabled="true">
+    <span class="cx-pagination__dir">Next<svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-forward"></use></svg></span>
+    <span class="cx-pagination__title">Latest entry</span>
+  </span>
+  {{- end }}
+</nav>
+{{- end -}}

package/layouts/_partials/motifspec/pagination-pages.html

@@ -1,30 +1,30 @@
-{{- /* pagination.md below a paginated index: "Page 2 / 5", with Newer and Older in place of titles.
-       Context: dict "pager" "label". Renders nothing when everything fits on one page. */ -}}
-{{- $pg := .pager -}}
-{{- if gt $pg.TotalPages 1 }}
-<nav class="cx-pagination" aria-label="{{ .label }}">
-  {{- if $pg.HasPrev }}
-  <a class="cx-pagination__link" href="{{ $pg.Prev.URL }}" rel="prev">
-    <span class="cx-pagination__dir"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>Previous</span>
-    <span class="cx-pagination__title">Newer</span>
-  </a>
-  {{- else }}
-  <span class="cx-pagination__link" rel="prev" aria-disabled="true">
-    <span class="cx-pagination__dir"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>Previous</span>
-    <span class="cx-pagination__title">Newest page</span>
-  </span>
-  {{- end }}
-  <p class="cx-pagination__status">Page<strong>{{ $pg.PageNumber }} / {{ $pg.TotalPages }}</strong></p>
-  {{- if $pg.HasNext }}
-  <a class="cx-pagination__link" href="{{ $pg.Next.URL }}" rel="next">
-    <span class="cx-pagination__dir">Next<svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-forward"></use></svg></span>
-    <span class="cx-pagination__title">Older</span>
-  </a>
-  {{- else }}
-  <span class="cx-pagination__link" rel="next" aria-disabled="true">
-    <span class="cx-pagination__dir">Next<svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-forward"></use></svg></span>
-    <span class="cx-pagination__title">Oldest page</span>
-  </span>
-  {{- end }}
-</nav>
-{{- end -}}
+{{- /* pagination.md below a paginated index: "Page 2 / 5", with Newer and Older in place of titles.
+       Context: dict "pager" "label". Renders nothing when everything fits on one page. */ -}}
+{{- $pg := .pager -}}
+{{- if gt $pg.TotalPages 1 }}
+<nav class="cx-pagination" aria-label="{{ .label }}">
+  {{- if $pg.HasPrev }}
+  <a class="cx-pagination__link" href="{{ $pg.Prev.URL }}" rel="prev">
+    <span class="cx-pagination__dir"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>Previous</span>
+    <span class="cx-pagination__title">Newer</span>
+  </a>
+  {{- else }}
+  <span class="cx-pagination__link" rel="prev" aria-disabled="true">
+    <span class="cx-pagination__dir"><svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-back"></use></svg>Previous</span>
+    <span class="cx-pagination__title">Newest page</span>
+  </span>
+  {{- end }}
+  <p class="cx-pagination__status">Page<strong>{{ $pg.PageNumber }} / {{ $pg.TotalPages }}</strong></p>
+  {{- if $pg.HasNext }}
+  <a class="cx-pagination__link" href="{{ $pg.Next.URL }}" rel="next">
+    <span class="cx-pagination__dir">Next<svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-forward"></use></svg></span>
+    <span class="cx-pagination__title">Older</span>
+  </a>
+  {{- else }}
+  <span class="cx-pagination__link" rel="next" aria-disabled="true">
+    <span class="cx-pagination__dir">Next<svg class="cx-icon cx-icon--sm cx-button__arrow" aria-hidden="true" focusable="false"><use href="#cx-icon-arrow-forward"></use></svg></span>
+    <span class="cx-pagination__title">Oldest page</span>
+  </span>
+  {{- end }}
+</nav>
+{{- end -}}

package/layouts/_partials/motifspec/post-list-item.html

@@ -1,15 +1,15 @@
-{{- /* post-list-item.md: number, date and reading time beside the title, summary and tags. Context: dict "page" "level". */ -}}
-{{- $p := .page -}}
-{{- $h := .level | default 3 -}}
-<li class="cx-post">
-  <p class="cx-post__meta">
-    <span class="cx-id__no">{{ $p.Params.accession }}</span>
-    <time datetime="{{ $p.Date.Format "2006-01-02" }}">{{ $p.Date.Format "2006-01-02" }}</time>
-    <span>{{ $p.ReadingTime }} min</span>
-  </p>
-  <div class="cx-post__main">
-    <h{{ $h }} class="cx-post__title"><a href="{{ $p.RelPermalink }}">{{ $p.Title }}</a></h{{ $h }}>
-    <p class="cx-post__summary">{{ $p.Summary | plainify }}</p>
-    {{- partial "motifspec/tags.html" (dict "page" $p "max" 5) }}
-  </div>
-</li>
+{{- /* post-list-item.md: number, date and reading time beside the title, summary and tags. Context: dict "page" "level". */ -}}
+{{- $p := .page -}}
+{{- $h := .level | default 3 -}}
+<li class="cx-post">
+  <p class="cx-post__meta">
+    <span class="cx-id__no">{{ $p.Params.accession }}</span>
+    <time datetime="{{ $p.Date.Format "2006-01-02" }}">{{ $p.Date.Format "2006-01-02" }}</time>
+    <span>{{ $p.ReadingTime }} min</span>
+  </p>
+  <div class="cx-post__main">
+    <h{{ $h }} class="cx-post__title"><a href="{{ $p.RelPermalink }}">{{ $p.Title }}</a></h{{ $h }}>
+    <p class="cx-post__summary">{{ $p.Summary | plainify }}</p>
+    {{- partial "motifspec/tags.html" (dict "page" $p "max" 5) }}
+  </div>
+</li>