@heroiclands/package-build 22.22.0 → 22.24.0

package/hugo-theme/layouts/partials/tags.html

@@ -0,0 +1,30 @@
+{{- /*
+  A page's own subject-tag chips, rendered from .Params.tags.
+
+  `draft` is suppressed here: it is a presentation fact about the writing,
+  not a fact about the subject (package-build/engine/note-vocabulary.mjs,
+  `DRAFT_TAG`) — a draft compiles, validates, publishes and resolves like any
+  other note. It does not belong beside subject tags in a reader-facing tag
+  list; `draft-notice.html` is where the state is stated,
+  and `draft-state.html` is the one place either partial spells the tag.
+
+  The taxonomy itself is untouched: a draft page still carries the tag, still
+  lists on its term page, and the term still appears in a site-wide taxonomy
+  listing. This partial decides only what a page's own chip row shows.
+
+  Silent-disappear: a page whose only tag is `draft` emits nothing here, the
+  same as a page with no tags at all.
+
+  Context: the page.
+*/ -}}
+{{- $tags := slice -}}
+{{- range .Params.tags -}}
+  {{- if ne (lower .) "draft" -}}
+    {{- $tags = $tags | append . -}}
+  {{- end -}}
+{{- end -}}
+{{- with $tags }}
+<div class="single-tags">
+  {{ range . }}<a href="{{ printf "tags/%s/" (. | urlize) | relURL }}" class="tag">{{ . }}</a>{{ end }}
+</div>
+{{ end -}}

package/hugo-theme/layouts/partials/toc.html

@@ -0,0 +1,28 @@
+{{- /*
+  Table of Contents partial.
+
+  Renders a sticky right-rail TOC on pages that have more than 3 H2
+  headings. We detect the threshold by grepping the raw content source
+  (`.RawContent`) for lines starting with "## " — this is faster and
+  more reliable than parsing the rendered HTML, and catches authored
+  headings regardless of markdown extensions that Hugo might apply.
+
+  The caller is responsible for:
+    - wrapping the page in a CSS grid when this partial renders
+      (see `.single.single-with-toc` in style.css)
+    - gating invocation with `partialCached` if desired
+
+  This partial prints nothing when the H2 count is 3 or less, so it's
+  safe to include unconditionally.
+*/ -}}
+
+{{- $raw := .RawContent | default "" -}}
+{{- $h2Count := len (findRE `(?m)^##\s+\S` $raw) -}}
+{{- if gt $h2Count 3 -}}
+<aside class="toc" aria-label="Table of contents" data-pagefind-ignore>
+  <div class="toc-inner">
+    <p class="toc-label">On this page</p>
+    {{ .TableOfContents }}
+  </div>
+</aside>
+{{- end -}}

package/hugo-theme/layouts/partials/warn-missing-banner.html

@@ -0,0 +1,3 @@
+{{- warnidf (printf "hero-banner-missing-%s" .name)
+    "hero-banner: no banner named %q in the shared artwork set; falling back to %s/%s. Draw it and add %q to data/banners.yaml, or name a hero image on the page — `data.banner` on a note, `banner:` on a hand-authored page. A blank `data.banner`, or `banner: none`, declines a hero image. First seen on %s."
+    .name .dir .fallback .name .context -}}

package/hugo-theme/layouts/shortcodes/cartouche.html

@@ -0,0 +1,64 @@
+{{- /*
+  Cartouche shortcode — renders a named cartouche SVG as an ornamental
+  accent on culture-flavored pages. The canonical use is Kheperi
+  cartouches on Ta'Kheperu and Kemetian-pantheon pages, but the same
+  pipeline works for any "named seal" SVG.
+
+  Usage (shown with plain angle brackets so the Go template parser
+  doesn't try to close this comment). Hugo forbids MIXING positional
+  and named parameters in one call, so pick a form per call:
+
+    { {< cartouche "takheperu" >} }                               positional
+    { {< cartouche slug="takheperu" >} }                          named, centered
+    { {< cartouche slug="takheperu" align="right" >} }            floated right
+    { {< cartouche slug="ra" size="inline" >} }                   inline
+    { {< cartouche slug="anubis" caption="Anpu" >} }              figure + caption
+
+  Parameters (all optional except slug):
+    slug    - The cartouche SVG basename. May also be passed positionally
+              (as the first positional argument) when no other params
+              are needed — Hugo disallows mixing the two styles.
+    size    - "inline" to flow with text. Otherwise block-level.
+    align   - "left" or "right" to float so prose wraps. Default centered.
+    height  - CSS length override for the cartouche's height, e.g.
+              "10rem" or "160px". Default comes from .cartouche CSS
+              (13rem block, 9rem floated). Width scales from aspect ratio.
+    alt     - Override screen-reader text. Defaults to humanized slug.
+    caption - Optional figcaption (block mode only).
+
+  SVG is expected at /static/img/cartouches/<slug>.svg. Design note:
+  cartouche SVGs should draw with stroke="currentColor" and fill="none"
+  (or a hard-coded brand color) so they tint cleanly against any
+  background.
+*/ -}}
+{{- /* Accept slug as either the first positional arg or the named
+       "slug" parameter, so a caller can pick the style that fits the
+       rest of their arguments. */ -}}
+{{- $slug := .Get "slug" -}}
+{{- if not $slug }}{{ $slug = .Get 0 }}{{ end -}}
+{{- if not $slug -}}
+  {{- errorf "cartouche shortcode at %s needs a slug (positional arg 0 or slug=\"…\")" .Position -}}
+{{- end -}}
+{{- $altDefault := humanize (replace $slug "-" " ") | title -}}
+{{- $alt    := .Get "alt"     | default $altDefault -}}
+{{- $size   := .Get "size"    | default "" -}}
+{{- $align  := .Get "align"   | default "" -}}
+{{- $cap    := .Get "caption" | default "" -}}
+{{- $height := .Get "height"  | default "" -}}
+{{- $src    := printf "img/cartouches/%s.svg" $slug | relURL -}}
+{{- $classes := slice "cartouche" -}}
+{{- with $size  }}{{ $classes = $classes | append (printf "cartouche-%s" .) }}{{ end -}}
+{{- with $align }}{{ $classes = $classes | append (printf "cartouche-%s" .) }}{{ end -}}
+{{- $class := delimit $classes " " -}}
+{{- /* When `height` is given, apply it as an inline style directly on
+       the <img>. Inline styles on the target element are unambiguous —
+       they trump any .cartouche img CSS rule on specificity and don't
+       depend on custom-property inheritance. */ -}}
+{{- if eq $size "inline" -}}
+<span class="{{ $class }}"><img src="{{ $src }}" alt="{{ $alt }}" loading="lazy"{{ with $height }} style="height: {{ . }}; width: auto; max-width: none;"{{ end }} /></span>
+{{- else -}}
+<figure class="{{ $class }}">
+  <img src="{{ $src }}" alt="{{ $alt }}" loading="lazy"{{ with $height }} style="height: {{ . }}; width: auto; max-width: none;"{{ end }} />
+  {{- with $cap }}<figcaption>{{ . }}</figcaption>{{ end }}
+</figure>
+{{- end -}}

package/hugo-theme/layouts/shortcodes/exturl.html

@@ -0,0 +1,12 @@
+<span class="exturl">
+  <code class="exturl-text">{{ .Get 0 }}</code>
+  <button class="exturl-copy" onclick="navigator.clipboard.writeText('{{ .Get 0 }}').then(()=>{const b=this;b.classList.add('copied');setTimeout(()=>b.classList.remove('copied'),1500)})" title="Copy URL to clipboard" aria-label="Copy URL to clipboard">
+    <svg class="exturl-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <rect x="9" y="9" width="13" height="13" rx="2" ry="2"/>
+      <path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/>
+    </svg>
+    <svg class="exturl-check" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+      <polyline points="20 6 9 17 4 12"/>
+    </svg>
+  </button>
+</span>

package/hugo-theme/layouts/shortcodes/glyph.html

@@ -0,0 +1,43 @@
+{{- /*
+  Glyph shortcode — renders a hieroglyphic deity-name cluster (or any
+  "icon-scale" SVG) from the project CDN. Parallel to cartouche.html
+  but for smaller, non-royal glyph groups: Kemetían deity names,
+  category icons, ornamental marks, etc.
+
+  Usage (Hugo disallows mixing positional and named params in one
+  call; pick a form per call):
+
+    { {< glyph "anubis" >} }                             inline, plain
+    { {< glyph slug="anubis" >} }                        same, named form
+    { {< glyph slug="anubis" frame="tablet" >} }         inside stone tablet
+    { {< glyph slug="ra" size="inline" >} }              scales with text
+    { {< glyph slug="ra" size="block" >} }               centered block
+    { {< glyph slug="ra" alt="Sun god Ra" >} }           override alt text
+
+  Parameters (all optional except slug):
+    slug    - Filename (without .svg). Passed positionally or as slug=.
+    frame   - "tablet" wraps in a limestone rectangular frame (good for
+              catalog layouts like the pantheon table where visual
+              parallelism across rows matters more than intrinsic width).
+    size    - "inline" (small, flows with text), "block" (centered
+              standalone). Default sits at 1.8em height.
+    alt     - Screen-reader text. Defaults to humanized slug.
+
+  SVG source: icons/<slug>.svg, resolved against the consuming site's
+  `params.cdnBaseURL` — the theme names no host of its own.
+*/ -}}
+{{- $slug := .Get "slug" -}}
+{{- if not $slug }}{{ $slug = .Get 0 }}{{ end -}}
+{{- if not $slug -}}
+  {{- errorf "glyph shortcode at %s needs a slug (positional arg 0 or slug=\"…\")" .Position -}}
+{{- end -}}
+{{- $altDefault := humanize (replace $slug "-" " ") | title -}}
+{{- $alt   := .Get "alt"   | default $altDefault -}}
+{{- $frame := .Get "frame" | default "" -}}
+{{- $size  := .Get "size"  | default "" -}}
+{{- $src   := partial "cdn-url.html" (dict "site" .Site "path" (printf "icons/%s.svg" $slug)) -}}
+{{- $classes := slice "glyph" -}}
+{{- with $frame }}{{ $classes = $classes | append (printf "glyph-%s" .) }}{{ end -}}
+{{- with $size  }}{{ $classes = $classes | append (printf "glyph-%s" .) }}{{ end -}}
+{{- $class := delimit $classes " " -}}
+<span class="{{ $class }}"><img src="{{ $src }}" alt="{{ $alt }}" loading="lazy" /></span>

package/hugo-theme/layouts/shortcodes/pagelist.html

@@ -0,0 +1,63 @@
+{{- /*
+  pagelist — the pages carrying a tag, as a plain list.
+
+  Curated landings are the right front door, but hand-enumerated link lists
+  drift: a page gets added and nobody updates the index. This expresses a group
+  by INTENT instead. Tag a page and it files itself; untag it and it leaves.
+
+  Usage:
+
+    { {< pagelist tag="key-concept" >} }                  every tagged page
+    { {< pagelist tag="key-concept" section="rules" >} }  restricted to a section
+    { {< pagelist tag="key-concept" sort="weight" >} }    title (default) | weight | date
+    { {< pagelist tag="key-concept" desc="true" >} }      include page descriptions
+
+  Parameters:
+    tag      - (required) taxonomy term. Matched case-insensitively.
+    section  - (optional) restrict to one top-level section, e.g. "rules".
+    sort     - (optional) "title" (default), "weight", or "date" (newest first).
+    desc     - (optional) "true" to show each page's description beneath it.
+
+  An unknown or empty tag warns at build time rather than rendering nothing
+  silently — a typo in a tag is exactly the drift this is meant to prevent.
+*/ -}}
+{{- $tag := .Get "tag" -}}
+{{- if not $tag }}{{ $tag = .Get 0 }}{{ end -}}
+{{- if not $tag -}}
+  {{- errorf "pagelist shortcode at %s needs a tag (tag=\"…\" or positional arg 0)" .Position -}}
+{{- end -}}
+
+{{- $term := $tag | urlize -}}
+{{- $pages := slice -}}
+{{- with index .Site.Taxonomies.tags $term -}}
+  {{- $pages = .Pages -}}
+{{- end -}}
+
+{{- with $.Get "section" -}}
+  {{- $sec := . -}}
+  {{- $pages = where $pages "Section" $sec -}}
+{{- end -}}
+
+{{- $sort := $.Get "sort" | default "title" -}}
+{{- if eq $sort "weight" -}}
+  {{- $pages = sort $pages "Weight" -}}
+{{- else if eq $sort "date" -}}
+  {{- $pages = sort $pages "Date" "desc" -}}
+{{- else -}}
+  {{- $pages = sort $pages "Title" -}}
+{{- end -}}
+
+{{- if not $pages -}}
+  {{- warnf "pagelist at %s: no pages carry the tag %q — check the spelling, or tag some pages." $.Position $tag -}}
+{{- else -}}
+<ul class="page-list pagelist">
+  {{- range $pages }}
+  <li class="page-list-item">
+    <a class="page-list-title" href="{{ .RelPermalink }}">{{ .Title }}</a>
+    {{- if and (eq ($.Get "desc") "true") .Description }}
+    <span class="page-list-desc">{{ .Description }}</span>
+    {{- end }}
+  </li>
+  {{- end }}
+</ul>
+{{- end -}}

package/hugo-theme/static/css/sohl-icons.css

@@ -0,0 +1,57 @@
+/*
+ * SoHL icon glyphs for the knowledgebase.
+ * AUTO-GENERATED by the SoHL repo (utils/build-kb-icon-assets.mjs) — do not edit
+ * by hand. Regenerate with `npm run build:kb-icons` and copy both files across.
+ *
+ * Contains only the 12 game-icons glyph(s) the published docs use.
+ * Font Awesome is loaded separately (its free set, from a CDN).
+ *
+ * Game-Icons.net artwork is CC BY 3.0 (CC0 for Viscious Speed and Zeromancer);
+ * per-author credit lives in the SoHL repo at
+ * assets/icons/game-icons/ATTRIBUTION.md.
+ */
+@font-face {
+    font-display: block;
+    font-family: "game-icons.net";
+    font-style: normal;
+    font-weight: 400;
+    src: url("../fonts/game-icons-kb.woff2") format("woff2");
+}
+
+[class^="ginf-"],
+[class*=" ginf-"] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 1.25em;
+    height: 1em;
+    line-height: 1;
+    vertical-align: -0.30em;
+}
+
+[class^="ginf-"]::before,
+[class*=" ginf-"]::before {
+    font-family: "game-icons.net" !important;
+    font-style: normal;
+    font-weight: normal;
+    font-variant: normal;
+    text-transform: none;
+    line-height: 1;
+    font-size: 1.4em;
+    speak: never;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+}
+
+.ginf-bow-arrow::before { content: "\e219"; }
+.ginf-broadsword::before { content: "\e248"; }
+.ginf-chest::before { content: "\e358"; }
+.ginf-crossed-swords::before { content: "\e418"; }
+.ginf-heart-beats::before { content: "\e736"; }
+.ginf-knapsack::before { content: "\e83e"; }
+.ginf-knockout::before { content: "\e847"; }
+.ginf-old-wagon::before { content: "\ea18"; }
+.ginf-screaming::before { content: "\ec38"; }
+.ginf-skills::before { content: "\ecc3"; }
+.ginf-sparkles::before { content: "\ed32"; }
+.ginf-stockpiles::before { content: "\edd3"; }