pandorga 1.2.1

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Pandorga contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,81 @@
+# Pandorga
+
+[![CI](https://github.com/alexandrelheinen/pandorga/actions/workflows/validate.yml/badge.svg)](https://github.com/alexandrelheinen/pandorga/actions/workflows/validate.yml)
+[![Release](https://img.shields.io/github/v/release/alexandrelheinen/pandorga)](https://github.com/alexandrelheinen/pandorga/releases/latest)
+[![Gem Version](https://img.shields.io/gem/v/pandorga)](https://rubygems.org/gems/pandorga)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+<img src="docs/images/family_link_64dp_5084C1_FILL0_wght400_GRAD0_opsz48.svg" alt="Pandorga Logo" width="120" align="left" style="margin-right: 10%;">
+An aesthetic Jekyll publishing platform for creative and technical writing. The site is your paper, your portfolio, and an extension of your own thoughts.
+
+- **Headless and S3-compatible.** Your content lives independently of the Pandorga shell — write, store, and move it on your own terms.
+- **Studio CMS.** Manage everything from quick notes to full diagrams without touching the repo.
+- **Fully configurable.** Portfolio, CV, blog, articles, and bibliography — each with its own presentation.
+
+## Quickstart
+
+Scaffold a site (Ada Example defaults, `content.backend: static`):
+
+```bash
+gem install pandorga   # once 1.1 is on RubyGems; or use a local checkout
+pandorga new my-site
+cd my-site
+bundle install
+bundle exec pandorga doctor
+bundle exec pandorga serve
+```
+
+Or run the packaged minimal example from a clone:
+
+```bash
+git clone https://github.com/alexandrelheinen/pandorga.git
+cd pandorga
+git submodule update --init .guidelines   # agent/prose guidelines (optional for runtime)
+mise install                              # or use Ruby >= 3.3
+bundle install
+cd examples/minimal && bundle install && cd ../..
+bundle exec pandorga export examples/minimal/content examples/minimal/_content_json
+bundle exec pandorga doctor examples/minimal
+mise exec -- ./scripts/validate.sh
+```
+
+Serve from the example directory:
+
+```bash
+cd examples/minimal
+bundle exec pandorga serve
+```
+
+## CLI
+
+| Command | Purpose |
+|---|---|
+| `pandorga new PATH` | Scaffold a site from `examples/minimal` |
+| `pandorga doctor` | Validate `pandorga:` config |
+| `pandorga export` | Content → JSON (`manifest.json` includes `schema_version`) |
+| `pandorga serve` | Export + `jekyll serve` |
+| `pandorga publish` | S3-compatible object-store sync (`S3_*` or `R2_*`) |
+| `pandorga install-functions` | Copy `functions/` + `studio/` into the site root |
+| `pandorga studio-schema` | Compose Studio schema from templates |
+
+## Documentation
+
+| Doc | Topic |
+|---|---|
+| [docs/getting-started.md](docs/getting-started.md) | Minimal example locally |
+| [docs/configuration.md](docs/configuration.md) | `pandorga:` reference |
+| [docs/pages-and-templates.md](docs/pages-and-templates.md) | Registry and seven templates |
+| [docs/theming.md](docs/theming.md) | `_data/themes` and tokens |
+| [docs/extending.md](docs/extending.md) | Site overrides, hero art, Studio overrides |
+| [docs/architecture.md](docs/architecture.md) | Shell, JSON, runtime, Studio |
+| [docs/upgrading.md](docs/upgrading.md) | Semver, `schema_version`, gem pins |
+| [docs/studio.md](docs/studio.md) | Studio env and schema compose |
+| [docs/studio-android.md](docs/studio-android.md) | Optional Expo Android WebView shell |
+| [docs/deploy/static.md](docs/deploy/static.md) | Static backend |
+| [docs/deploy/cloudflare.md](docs/deploy/cloudflare.md) | Pages + object store |
+| [docs/spec.md](docs/spec.md) | Migration plan and acceptance criteria |
+| [docs/decisions.md](docs/decisions.md) | Frozen decisions |
+
+## License
+
+MIT — Copyright (c) The Pandorga contributors.

data/_data/themes/dark.yml

@@ -0,0 +1,97 @@
+# Brazilian Ledger — dark theme (runtime toggle companion to light.yml).
+#
+# 2026-09 vivid pass: same Ledger hues as light, chroma raised so accents
+# read on the near-black ladder (Stitch Home Dark Mode intent: pigment on
+# near-black, not a new triad).
+
+colors:
+  primary: "#a4c8da"
+  secondary: "#95c8a6"
+  tertiary: "#ddd8a8"
+  primary_container: "#4a5c66"
+  secondary_container: "#435c4c"
+  tertiary_container: "#6a684f"
+  on_primary_container: "#c0d8e6"
+  on_secondary_container: "#b5d9c2"
+  on_tertiary_container: "#e8e4c0"
+  chart_project: "#98c8ac"
+
+neutrals:
+  on_surface: "#ffffff"
+  on_surface_variant: "#b8b7ae"
+  on_background: "#ffffff"
+  outline: "#93938d"
+  # Neutralised with the rest of the ramp: this was #44453f (green highest),
+  # and every hairline in the build is an opacity step of it.
+  outline_variant: "#45454c"
+  background: "#0c0c0e"
+  background_secondary: "#141418"
+  surface: "#111114"
+  surface_container_low: "#17171b"
+  surface_container: "#1f1f24"
+  surface_container_high: "#26262b"
+  surface_variant: "#2e2e34"
+  # Architectural Ledger ladder. Depth comes from tonal steps, not shadow:
+  # canvas (background) -> panel -> card (transparent at rest) -> hover.
+  #
+  # Cards rest transparent so the panel/canvas and shards show through; the
+  # hover rung still lifts. Widened 2026-09: canvas near-black buys headroom
+  # the reference mockup uses (#0a0a0a canvas). Panel and hover keep the
+  # ~+4 L* / ~+6 L* steps; the resting card no longer inserts a mid plate.
+  panel_contrast: "#141418"
+  surface_card: "#0c0c0e"
+  surface_card_contrast: "#141418"
+  surface_high: "#26262b"
+  surface_high_contrast: "#26262b"
+
+links:
+  default: "#b0d0e0"
+  hover: "#c4dce8"
+
+# Fonts, motion, and geometry live in shared.yml — colour themes do not
+# redeclare them.
+
+static:
+  on_primary: "#0f1a22"
+  on_secondary: "#141a15"
+  on_tertiary: "#1b1c12"
+  surface_container_lowest: "#08080a"
+  surface_dim: "#060607"
+  inverse_primary: "#1c5a7a"
+  inverse_surface: "#ffffff"
+  inverse_on_surface: "#000000"
+  primary_fixed: "#a8c5d4"
+  primary_fixed_dim: "#a4c8da"
+  secondary_fixed: "#b4d4c0"
+  secondary_fixed_dim: "#95c8a6"
+  tertiary_fixed: "#d0ceb0"
+  tertiary_fixed_dim: "#ddd8a8"
+  on_primary_fixed: "#0a1419"
+  on_primary_fixed_variant: "#c0d8e6"
+  on_secondary_fixed: "#0c1710"
+  on_secondary_fixed_variant: "#b5d9c2"
+  on_tertiary_fixed: "#17160c"
+  on_tertiary_fixed_variant: "#e8e4c0"
+  error: "#ffb4ab"
+  on_error: "#690005"
+  error_container: "#93000a"
+  on_error_container: "#ffdad6"
+  res_youtube: "#de6461"
+  res_podcast: "#5dc462"
+  res_doc: "#e4b268"
+
+sidebar_thumbnail:
+  background: "#1f1f24"
+  overlay_gradient_start: "rgba(23, 23, 27, 0.35)"
+  overlay_gradient_end: "rgba(12, 12, 14, 0.45)"
+
+# Timeline lane palette — see light.yml for the rationale. Same six hues,
+# lifted in lightness and eased in saturation so they carry against the
+# near-black canvas instead of sinking into it. Chroma raised with the triad.
+timeline:
+  employment: "#a4c8da"   # petrol
+  education: "#95c8a6"    # forest
+  product: "#d5b46e"      # tobacco
+  project: "#a9a5dd"      # indigo
+  article: "#da987e"      # terracotta
+  post: "#7cc7b5"         # sage teal

data/_data/themes/light.yml

@@ -0,0 +1,120 @@
+# Brazilian Ledger — light theme (production default).
+# Add sibling files (e.g. dark.yml) and set shell_theme.active in _config.yml to switch palettes.
+#
+# 2026-09 vivid pass (second cut): slate / forest / ochre chroma raised again
+# so brand ink reads on white paper without grey wash. Canvas and cards stay
+# pure white; contrast bands are near-white paper rhythm (Stitch "Editorial
+# Detour" intent, without adopting its alabaster #fcf9f6 canvas). Card margins
+# use a darker outline_variant so hairlines read closer to Stitch paper rules.
+
+colors:
+  primary: "#1c5a7a"
+  secondary: "#287445"
+  tertiary: "#746f30"
+  primary_container: "#a8c5d4"
+  secondary_container: "#b4d4c0"
+  tertiary_container: "#d0ceb0"
+  on_primary_container: "#0a1419"
+  on_secondary_container: "#0c1710"
+  on_tertiary_container: "#17160c"
+  chart_project: "#6fb387"
+
+neutrals:
+  on_surface: "#000000"
+  on_surface_variant: "#5e5d59"
+  on_background: "#000000"
+  # Hairlines. Every border in the build is an opacity step of
+  # `outline_variant`. Stitch-like paper rules need a mid-grey base so the
+  # opacity ladder does not vanish on white cards. Neutral grey — no cream
+  # warmth and no slate cast in the fills.
+  outline: "#5c5c5c"
+  outline_variant: "#b8b8b8"
+  # Architectural Ledger ladder — white paper edition.
+  #
+  # Canvas is pure white. Depth is hairline + a near-neutral grey panel band
+  # for alternating rhythm. Cards rest transparent (panel/canvas shows
+  # through; shards stay visible) and only take a fill on hover. Cream washed
+  # ochre into the page; the blue-grey step still read as slate — this ladder
+  # is practically grey (equal RGB) so highlights stay quiet paper.
+  #
+  # Canvas (#ffffff) -> Panel contrast (#f4f4f4) -> Card (transparent)
+  # -> Hover (#ebebeb). Contrast-band cards stay transparent too, so they
+  # never cut a white plate out of the grey band.
+  background: "#ffffff"
+  background_secondary: "#f4f4f4"
+  panel_contrast: "#f4f4f4"
+  surface_card: "#ffffff"
+  surface_card_contrast: "#f4f4f4"
+  surface_high: "#ebebeb"
+  surface_high_contrast: "#e2e2e2"
+  surface: "#ffffff"
+  surface_container_low: "#f4f4f4"
+  surface_container: "#ebebeb"
+  surface_container_high: "#e2e2e2"
+  surface_variant: "#d8d8d8"
+
+links:
+  default: "#1c5a7a"
+  hover: "#2a6f92"
+
+# Fonts, motion, and geometry live in shared.yml — colour themes do not
+# redeclare them.
+
+# Static tokens shared across Tailwind and scoped CSS (not derived from the brand triad).
+static:
+  on_primary: "#ffffff"
+  on_secondary: "#ffffff"
+  on_tertiary: "#ffffff"
+  surface_container_lowest: "#ffffff"
+  surface_dim: "#d8d8d8"
+  inverse_primary: "#a4c8da"
+  inverse_surface: "#000000"
+  inverse_on_surface: "#ffffff"
+  primary_fixed: "#a8c5d4"
+  primary_fixed_dim: "#7fa8bc"
+  secondary_fixed: "#b4d4c0"
+  secondary_fixed_dim: "#6fb387"
+  tertiary_fixed: "#d0ceb0"
+  tertiary_fixed_dim: "#c0bc90"
+  on_primary_fixed: "#0a1419"
+  on_primary_fixed_variant: "#163040"
+  on_secondary_fixed: "#0c1710"
+  on_secondary_fixed_variant: "#24382a"
+  on_tertiary_fixed: "#17160c"
+  on_tertiary_fixed_variant: "#3a381c"
+  error: "#ba1a1a"
+  on_error: "#ffffff"
+  error_container: "#ffdad6"
+  on_error_container: "#93000a"
+  res_youtube: "#c62828"
+  res_podcast: "#2e7d32"
+  res_doc: "#b45309"
+
+# Detail-page sidebar thumbnail. Light had no block of its own and fell through
+# to _config.yml, whose #eeeeee plate and grey scrim are cold neutrals from
+# before the ramp was warmed (DESIGN.md known inconsistency 14). Same three
+# keys as dark.yml; width, opacity and the filters still fall through.
+#
+# The plate sits a step below the card because a photo is inset into the page,
+# not lifted off it, and the scrim runs from card-white down to deep paper so
+# the image settles onto the sheet instead of floating. Dark can afford 0.35 /
+# 0.45 on its scrim; a light scrim that heavy would wash the photograph out,
+# which is the failure this palette pass exists to undo.
+sidebar_thumbnail:
+  background: "#ebebeb"
+  overlay_gradient_start: "rgba(255, 255, 255, 0.18)"
+  overlay_gradient_end: "rgba(226, 226, 226, 0.28)"
+
+# Timeline lane palette — a categorical scale for the CV chart, not part of
+# the UI triad. Six kinds of event are drawn at once and have to be told
+# apart, so this is the one place the site carries more than three inks.
+# Held separately from `colors:` on purpose: a `.page-accent--*` class
+# rebinds --color-primary, and the CV reads green, but a green chart is an
+# unreadable chart. Same hues as before, chroma raised with the triad.
+timeline:
+  employment: "#1c5a7a"   # petrol — the triad primary, the anchor lane
+  education: "#287445"    # forest — triad secondary
+  product: "#906c2a"      # tobacco — deepened off the ochre tertiary
+  project: "#534da1"      # indigo
+  article: "#a95031"      # terracotta
+  post: "#478576"         # sage teal

data/_data/themes/shared.yml

@@ -0,0 +1,37 @@
+# Tokens shared by every colour theme. Light and dark only differ on colour
+# roles (see light.yml / dark.yml); fonts, motion, and geometry live here so
+# a palette swap cannot drift the type stack.
+#
+# Consumed by theme-context.liquid → theme-vars-block.liquid / font-loader.
+
+fonts:
+  title: "Cinzel Decorative"
+  subtitle: "Newsreader"
+  label: "Marcellus SC"
+  body: "Newsreader"
+  mono: "Courier Prime"
+  code: "Courier Prime"
+  cv_body: "Newsreader"
+  cv_body_weight: 400
+  # Generic CSS fallback after the named face (serif | sans-serif | monospace).
+  body_fallback: "sans-serif"
+  subtitle_fallback: "serif"
+  title_fallback: "serif"
+  label_fallback: "serif"
+  google_title_spec: "wght@400;700;900"
+  google_subtitle_spec: "ital,opsz,wght@0,6..72,300;0,6..72,400;0,6..72,500;0,6..72,600;0,6..72,700;1,6..72,300;1,6..72,400;1,6..72,500"
+  google_label_spec: "wght@400;700"
+  google_body_spec: "wght@300;400;500;600;700"
+  google_mono_spec: "ital,wght@0,400;0,700;1,400;1,700"
+  google_code_spec: "ital,wght@0,300;0,400;0,700;1,400;1,700"
+  google_cv_body_spec: "wght@300;400;500;600;700"
+
+motion:
+  duration_fast: "0.15s"
+  duration_base: "0.4s"
+  duration_slow: "0.7s"
+  ease_default: "ease"
+  ease_out: "ease-out"
+
+geometry:
+  radius_card: "0"

data/_data/translations.yml

@@ -0,0 +1,85 @@
+updated:
+  enus: "Updated"
+  ptbr: "Atualizado"
+  frfr: "Mis à jour"
+  eses: "Actualizado"
+published:
+  enus: "Published"
+  ptbr: "Publicado"
+  frfr: "Publié"
+  eses: "Publicado"
+months:
+  enus: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"]
+  ptbr: ["janeiro", "fevereiro", "março", "abril", "maio", "junho", "julho", "agosto", "setembro", "outubro", "novembro", "dezembro"]
+  frfr: ["janvier", "février", "mars", "avril", "mai", "juin", "juillet", "août", "septembre", "octobre", "novembro", "décembre"]
+  eses: ["enero", "febrero", "marzo", "abril", "mayo", "junio", "julio", "agosto", "septiembre", "octubre", "noviembre", "diciembre"]
+back:
+  enus: "Back"
+  ptbr: "Voltar"
+  frfr: "Retour"
+  eses: "Volver"
+back_to_drafts:
+  enus: "Back to drafts"
+  ptbr: "Voltar aos rascunhos"
+  frfr: "Retour aux brouillons"
+  eses: "Volver a los borradores"
+back_to_articles:
+  enus: "Back to articles"
+  ptbr: "Voltar aos artigos"
+  frfr: "Retour aux articles"
+  eses: "Volver a los artículos"
+back_to_portfolio:
+  enus: "Back to portfolio"
+  ptbr: "Voltar ao portfólio"
+  frfr: "Retour au portfolio"
+  eses: "Volver al portafolio"
+back_to_projects:
+  enus: "Back to projects"
+  ptbr: "Voltar aos projetos"
+  frfr: "Retour aux projets"
+  eses: "Volver a los proyectos"
+back_to_cv:
+  enus: "Back to CV"
+  ptbr: "Voltar ao CV"
+  frfr: "Retour au CV"
+  eses: "Volver al CV"
+previous_text:
+  enus: "Previous"
+  ptbr: "Anterior"
+  frfr: "Précédent"
+  eses: "Anterior"
+next_text:
+  enus: "Next"
+  ptbr: "Próximo"
+  frfr: "Suivant"
+  eses: "Siguiente"
+random_text:
+  enus: "Random"
+  ptbr: "Aleatório"
+  frfr: "Aléatoire"
+  eses: "Aleatorio"
+toc_title:
+  enus: "In this text"
+  ptbr: "Neste texto"
+  frfr: "Dans ce texte"
+  eses: "En este texto"
+cite_this_text:
+  enus: "Cite this text"
+  ptbr: "Citar este texto"
+  frfr: "Citer ce texte"
+  eses: "Citar este texto"
+related_texts:
+  enus: "Related texts"
+  ptbr: "Textos relacionados"
+  frfr: "Textes liés"
+  eses: "Textos relacionados"
+cites:
+  enus: "Cites"
+  ptbr: "Cita"
+  frfr: "Cite"
+  eses: "Cita"
+cited_by:
+  enus: "Cited by"
+  ptbr: "Citado por"
+  frfr: "Cité par"
+  eses: "Citado por"

data/_includes/chord-tab.html

@@ -0,0 +1,38 @@
+{% comment %}
+chord-tab.html
+Exibe uma cifra estruturada em N colunas monoespaçadas, usando toda a largura disponível.
+Cada coluna respeita o limite de 79 caracteres por linha.
+Uso: {% include chord-tab.html tab=tab_data %}
+Onde tab_data tem:
+intro: "linha de acordes do intro (opcional)"
+sections:
+- label: "rótulo da seção (opcional)"
+content: |
+linhas de cifra/letra
+{% endcomment %}
+
+<div class="chord-tab-container mt-16 mb-8"
+  style="width: 100%; box-sizing: border-box; padding-left: 0; padding-right: 0;">
+  <h2>Cifra</h2>
+
+  {% if include.tab.intro %}
+  <div class="mt-3 mb-6">
+    <pre class="font-mono text-tertiary text-[0.8em] leading-relaxed whitespace-pre m-0 p-0 bg-transparent border-0">{{ include.tab.intro }}</pre>
+  </div>
+  {% endif %}
+
+  <div class="mt-4 font-mono text-[0.8em] grid gap-x-2"
+    style="display: grid; grid-template-columns: repeat(auto-fill, min(79ch, 100%)); gap: 0 0.5rem; width: 100%;">
+    {% for section in include.tab.sections %}
+    <div style="overflow-y: auto;">
+      {% if section.label and section.label != '' %}
+      <div class="font-body text-[0.9em] uppercase tracking-widest text-tertiary mb-[0.35rem]">
+        {{ section.label }}</div>
+      {% endif %}
+      <pre
+        class="m-0 p-0 bg-transparent border-0 whitespace-pre overflow-x-auto leading-[1.55] text-on-surface">{{ section.content }}</pre>
+      <hr class="border-0 border-t border-gentle-divider my-[1.55em]" />
+    </div>
+    {% endfor %}
+  </div>
+</div>

data/_includes/content-runtime/00-config.html

@@ -0,0 +1,22 @@
+<script src="https://cdn.jsdelivr.net/npm/marked@15.0.7/marked.min.js"></script>
+<script>
+  window.ContentRuntimeConfig = {
+    contentBase: '{{ site.content_api_base_url | default: "" }}',
+    includeUnpublished: {{ site.content_include_unpublished | default: false | jsonify }},
+    defaultAuthor: {{ site.pandorga.identity.name | default: site.author | jsonify }},
+    siteSuffix: {% assign _short = site.pandorga.identity.short_name | default: site.pandorga.identity.name | default: site.author %}{{ _short | prepend: ' | ' | jsonify }},
+    translations: {{ site.data.translations | jsonify }},
+    tocMinHeadings: 3,
+    expectedSchemaVersion: 1
+  };
+  // Template modules register listing/detail handlers here (PLT Phase 2).
+  window.ContentRuntime = window.ContentRuntime || {};
+  window.ContentRuntime.templates = window.ContentRuntime.templates || {
+    _map: Object.create(null),
+    register: function (name, api) {
+      if (!name) throw new Error('ContentRuntime.templates.register: name required');
+      this._map[name] = api || {};
+    },
+    get: function (name) { return this._map[name] || null; }
+  };
+</script>

data/_includes/content-runtime/10-utils.html

@@ -0,0 +1,176 @@
+{% raw %}
+    var contentBase = (window.ContentRuntimeConfig && window.ContentRuntimeConfig.contentBase);
+    if (contentBase == null) contentBase = '';
+    contentBase = String(contentBase).replace(/\/$/, '');
+
+    function escapeHtml(value) {
+      return String(value == null ? '' : value)
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+    }
+
+    function escapeAttr(value) {
+      return escapeHtml(value).replace(/`/g, '&#96;');
+    }
+
+    function shellOrigin() {
+      return (window.ContentRuntimeConfig && window.ContentRuntimeConfig.shellOrigin) || window.location.origin || '';
+    }
+
+    function buildUrl(path) {
+      var value = unwrapMediaSrc(path);
+      if (!value) return '';
+      if (/^https?:\/\//.test(value)) return value;
+      if (value.charAt(0) === '/') return encodeURI(contentBase + value);
+      return encodeURI(contentBase + '/' + value);
+    }
+
+    /* Pages CMS rich-text (Editor mode) rewrites bare URLs inside quoted
+     * Liquid attributes into Markdown autolinks, e.g.
+     *   src="https://example.com/a.png"
+     * becomes
+     *   src="[https://example.com/a.png](https://example.com/a.png)"
+     * which then breaks <img src>. Prefer the Markdown href when the whole
+     * attribute value is a single link; leave real captions alone. */
+    function unwrapMediaSrc(path) {
+      var value = String(path == null ? '' : path).trim();
+      if (!value) return '';
+      var md = value.match(/^\[([^\]]*)\]\(([^)\s]+)\)\s*$/);
+      if (md) return String(md[2] || '').trim();
+      var angle = value.match(/^<([^>\s]+)>\s*$/);
+      if (angle) return String(angle[1] || '').trim();
+      return value;
+    }
+
+    function resolveAssetUrl(path) {
+      if (!path) return '';
+      var value = unwrapMediaSrc(path);
+      if (!value) return '';
+      if (/^https?:\/\//i.test(value)) return value;
+      if (value.charAt(0) === '/') {
+        if (value.indexOf('/media/') === 0) {
+          return encodeURI(contentBase.replace(/\/$/, '') + value);
+        }
+        return encodeURI(shellOrigin().replace(/\/$/, '') + value);
+      }
+      if (value.indexOf('media/') === 0) {
+        return encodeURI(contentBase.replace(/\/$/, '') + '/' + value);
+      }
+      return encodeURI(contentBase.replace(/\/$/, '') + '/' + value);
+    }
+
+    function parseIncludeAttrs(raw) {
+      var attrs = {};
+      var text = String(raw || '');
+      // Allow newlines inside quoted values (dict-card def=, tweet body=/note=).
+      text = text.replace(/([\w-]+)\s*=\s*(?:"([\s\S]*?)"|'([\s\S]*?)')/g, function (_, key, dbl, sgl) {
+        attrs[key] = dbl != null ? dbl : sgl;
+        return '';
+      });
+      text.replace(/([\w-]+)\s*=\s*([^\s]+)/g, function (_, key, val) {
+        if (!(key in attrs)) attrs[key] = val;
+        return '';
+      });
+      return attrs;
+    }
+
+    function parseScalar(value) {
+      var raw = String(value || '').trim();
+      if ((raw.charAt(0) === '"' && raw.charAt(raw.length - 1) === '"') ||
+          (raw.charAt(0) === "'" && raw.charAt(raw.length - 1) === "'")) {
+        return raw.slice(1, -1);
+      }
+      if (raw === 'true') return true;
+      if (raw === 'false') return false;
+      return raw;
+    }
+
+    function hydrateFrontMatter(item) {
+      var markdown = String(item.body_markdown || '').replace(/^\uFEFF/, '');
+      var match = markdown.match(/^---\s*\n([\s\S]*?)\n---\s*\n?/);
+
+      // The export strips the front-matter block out of body_markdown, so this
+      // never matches for exported content. The date promotion below therefore
+      // has to happen first: when it sat after the early return, no detail
+      // page ever received a date. The parse itself still matters for raw
+      // Markdown that has not been through the exporter.
+      item.front_matter = item.front_matter || {};
+      if (item.date) item.front_matter.date = item.date;
+      if (item.last_updated) item.front_matter.last_updated = item.last_updated;
+
+      if (!match) return item;
+
+      var parsed = {};
+      match[1].split(/\n/).forEach(function (line) {
+        var m = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (m) parsed[m[1]] = parseScalar(m[2]);
+      });
+      item.front_matter = Object.assign({}, parsed, item.front_matter);
+      item.body_markdown = markdown.slice(match[0].length);
+      return item;
+    }
+
+    function stripFrontMatter(markdown) {
+      return String(markdown || '').replace(/^\uFEFF/, '').replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '');
+    }
+
+    function endsWithSentencePunctuation(text) {
+      var value = String(text || '').trim();
+      return /[.!?](\s*<\/[^>]+>)*\s*$/.test(value);
+    }
+
+    function ensureCaptionPeriod(text) {
+      var value = String(text || '').trim();
+      if (!value || endsWithSentencePunctuation(value)) return value;
+      return value + '.';
+    }
+
+    /* The opening sentence of a longer piece of copy, for the places that need
+     * one sentence and are given a paragraph. A project's `tagline` is the
+     * case that forced this: it is a standfirst on the page, and it is also
+     * what `_layouts/projects.html` hands to the meta description and the
+     * social card, where a search result truncated mid-clause reads worse than
+     * a shorter one that finishes its thought.
+     *
+     * 160 characters is roughly what a desktop search result renders; Open
+     * Graph is more generous and takes the same string. A first sentence longer
+     * than the budget is cut on a word boundary rather than mid-word, and any
+     * punctuation left dangling at the cut goes with it.
+     */
+    var LEAD_SENTENCE_MAX = 160;
+
+    function leadSentence(text, limit) {
+      var value = String(text || '').trim();
+      if (!value) return '';
+      var max = limit || LEAD_SENTENCE_MAX;
+      var match = value.match(/^[\s\S]*?[.!?](?=\s|$)/);
+      var lead = match ? match[0] : value;
+      if (lead.length <= max) return lead;
+      var cut = lead.slice(0, max);
+      var space = cut.lastIndexOf(' ');
+      if (space > 0) cut = cut.slice(0, space);
+      return cut.replace(/[\s,;:.]+$/, '');
+    }
+
+    function figureSourceHtml(raw) {
+      raw = String(raw || '').trim();
+      if (!raw) return '';
+      if (/<a\s/i.test(raw)) {
+        return ' Source: ' + raw;
+      }
+      // Captions already parse Markdown; sources do too so
+      // `[Parrot Website](https://…)` renders as a link, not escaped brackets.
+      return ' Source: ' + stripSingleParagraph(parseInlineMarkdown(raw));
+    }
+
+    function includeCaptionHtml(caption) {
+      var trimmed = ensureCaptionPeriod(String(caption || '').trim());
+      if (!trimmed) return '';
+      if (/<[a-z][\s\S]*>/i.test(trimmed)) return trimmed;
+      return stripSingleParagraph(parseInlineMarkdown(trimmed));
+    }
+
+{% endraw %}