From 42ae3a46930a5ff84ec8e4d45ab5a1d3fd409b90 Mon Sep 17 00:00:00 2001
From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>
Date: Thu, 19 Nov 2026 20:45:57 -0500
Subject: [PATCH 1/7] feat: introduce the Jackal Jekyll theme
---
.github/workflows/ci.yml | 44 +++
.gitignore | 9 +
Gemfile | 11 +
README.md | 124 ++++++-
_includes/jackal/actions.html | 10 +
_includes/jackal/footer.html | 31 ++
_includes/jackal/head.html | 24 ++
_includes/jackal/header.html | 40 +++
_includes/jackal/hero.html | 14 +
_includes/jackal/media.html | 13 +
_includes/jackal/nav-link.html | 5 +
_includes/jackal/page-header.html | 4 +
_includes/jackal/post-grid.html | 12 +
_includes/jackal/sections.html | 38 +++
_includes/jackal/url.html | 19 ++
_layouts/blog.html | 8 +
_layouts/catalog.html | 7 +
_layouts/home.html | 19 ++
_layouts/jackal.html | 18 +
_layouts/page.html | 7 +
_layouts/post.html | 11 +
_layouts/product.html | 11 +
assets/jackal/jackal.css | 317 ++++++++++++++++++
assets/jackal/theme.js | 37 ++
docs/jackal-preview.jpg | Bin 0 -> 123213 bytes
example/_config.yml | 43 +++
example/_data/catalog.yml | 10 +
example/_includes/koko-project.html | 3 +
.../2026-01-01-a-home-for-each-project.md | 13 +
example/_preview.yml | 7 +
example/about.md | 9 +
example/assets/example/catalog.js | 18 +
example/assets/example/koko.css | 5 +
example/assets/example/themerr.css | 5 +
example/blog.md | 5 +
example/catalog/index.html | 31 ++
example/catalog/index.json | 4 +
example/index.md | 33 ++
example/koko.md | 23 ++
example/sunshine.md | 46 +++
example/themerr.md | 32 ++
jekyll-theme-jackal.gemspec | 14 +
script/verify-preview.rb | 56 ++++
43 files changed, 1185 insertions(+), 5 deletions(-)
create mode 100644 .github/workflows/ci.yml
create mode 100644 Gemfile
create mode 100644 _includes/jackal/actions.html
create mode 100644 _includes/jackal/footer.html
create mode 100644 _includes/jackal/head.html
create mode 100644 _includes/jackal/header.html
create mode 100644 _includes/jackal/hero.html
create mode 100644 _includes/jackal/media.html
create mode 100644 _includes/jackal/nav-link.html
create mode 100644 _includes/jackal/page-header.html
create mode 100644 _includes/jackal/post-grid.html
create mode 100644 _includes/jackal/sections.html
create mode 100644 _includes/jackal/url.html
create mode 100644 _layouts/blog.html
create mode 100644 _layouts/catalog.html
create mode 100644 _layouts/home.html
create mode 100644 _layouts/jackal.html
create mode 100644 _layouts/page.html
create mode 100644 _layouts/post.html
create mode 100644 _layouts/product.html
create mode 100644 assets/jackal/jackal.css
create mode 100644 assets/jackal/theme.js
create mode 100644 docs/jackal-preview.jpg
create mode 100644 example/_config.yml
create mode 100644 example/_data/catalog.yml
create mode 100644 example/_includes/koko-project.html
create mode 100644 example/_posts/2026-01-01-a-home-for-each-project.md
create mode 100644 example/_preview.yml
create mode 100644 example/about.md
create mode 100644 example/assets/example/catalog.js
create mode 100644 example/assets/example/koko.css
create mode 100644 example/assets/example/themerr.css
create mode 100644 example/blog.md
create mode 100644 example/catalog/index.html
create mode 100644 example/catalog/index.json
create mode 100644 example/index.md
create mode 100644 example/koko.md
create mode 100644 example/sunshine.md
create mode 100644 example/themerr.md
create mode 100644 jekyll-theme-jackal.gemspec
create mode 100644 script/verify-preview.rb
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..bf1f274
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,44 @@
+---
+name: Theme CI
+permissions: {}
+
+on:
+ pull_request:
+ push:
+ branches:
+ - master
+ workflow_dispatch:
+
+jobs:
+ build:
+ name: Build preview (Jekyll ${{ matrix.jekyll }})
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ strategy:
+ matrix:
+ include:
+ - ruby: '3.1'
+ jekyll: '~> 3.10.0'
+ - ruby: '3.4'
+ jekyll: '~> 4.4.0'
+ env:
+ JEKYLL_VERSION: ${{ matrix.jekyll }}
+ steps:
+ - name: Checkout
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ with:
+ persist-credentials: false
+ - name: Set up Ruby
+ uses: ruby/setup-ruby@20eb24b0d509e2b9ed9b6d42ddfeb992915e0564 # v1.341.0
+ with:
+ ruby-version: ${{ matrix.ruby }}
+ bundler-cache: true
+ - name: Build and verify both URL layouts
+ run: |
+ bundle exec jekyll build --source example --destination _site/root --config example/_config.yml
+ ruby script/verify-preview.rb _site/root '' https://app.lizardbyte.dev/ https://example.org
+ bundle exec jekyll build --source example --destination _site/nested --config example/_config.yml,example/_preview.yml
+ ruby script/verify-preview.rb _site/nested /previews/42/ThemerrDB /previews/42 https://preview.example.org
+ - name: Build theme gem
+ run: gem build jekyll-theme-jackal.gemspec
diff --git a/.gitignore b/.gitignore
index e3f4af3..1196f87 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,11 @@
# JetBrains IDEs
.idea/
+
+# Local builds and Bundler state
+.bundle/
+.jekyll-cache/
+.jekyll-metadata
+.sass-cache/
+_site/
+/Gemfile.lock
+*.gem
diff --git a/Gemfile b/Gemfile
new file mode 100644
index 0000000..fa02953
--- /dev/null
+++ b/Gemfile
@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+
+gemspec
+
+# Set JEKYLL_VERSION=~>3.10.0 to test the GitHub Pages generation of Jekyll.
+gem "jekyll", ENV.fetch("JEKYLL_VERSION", "~> 4.4.0")
+# These libraries moved out of the default gem set in Ruby 3.4.
+gem "base64", "~> 0.3"
+gem "bigdecimal", ">= 3.0", "< 5"
+gem "kramdown-parser-gfm", "~> 1.1"
+gem "webrick", "~> 1.9"
diff --git a/README.md b/README.md
index eaabf03..6281687 100644
--- a/README.md
+++ b/README.md
@@ -4,10 +4,124 @@
alt="LizardByte icon"
width="256"
/>
-
repo-name
- Repo description. This should exactly match the description in GitHub.
+ Jackal
+ A shared Jekyll theme for organizations and their project sites.
-
-
-
+Jackal provides product landing pages, a project hub, articles, a blog index, and wide catalog pages.
+Sites choose their own branding, navigation, content, and deployment paths. The theme provides
+the shared page structure, responsive components, and system, light, and dark color modes.
+
+## Preview
+
+From the theme checkout, install Ruby and Bundler, then run:
+
+```sh
+bundle install
+bundle exec jekyll serve --source example --config example/_config.yml
+```
+
+Open the address printed by Jekyll to preview the Sunshine, Themerr, and Koko examples,
+the blog, and the filterable release catalog. Product artwork in the examples is served
+by the original sites. Example content and assets are separate from the theme package.
+
+## Use Jackal
+
+For a Jekyll build in GitHub Actions or on your machine, add Jackal to the site's
+`Gemfile`. Use a tag or commit that contains the theme:
+
+```ruby
+gem "jekyll-theme-jackal", git: "https://github.com/LizardByte/jackal.git", ref: "YOUR_THEME_REF"
+```
+
+Set `theme: jekyll-theme-jackal` in `_config.yml` and run `bundle install`.
+During development, use `path: "../jackal"` in place of `git:` and `ref:`.
+
+GitHub Pages' branch builds can instead use
+[`jekyll-remote-theme`](https://github.com/benbalter/jekyll-remote-theme).
+Set `remote_theme: LizardByte/jackal@YOUR_THEME_REF`, enable `jekyll-remote-theme`
+in `plugins`, and omit `theme`. Jackal's layouts require no custom plugins.
+
+## Configure a site
+
+```yaml
+theme: jekyll-theme-jackal
+title: ThemerrDB
+description: Browse themes for your media library.
+url: https://themerr.lizardbyte.dev
+baseurl: /ThemerrDB
+
+jackal:
+ logo: /assets/project-logo.svg
+ icon: /assets/favicon.svg
+ styles:
+ - /assets/project.css
+ nav:
+ - label: Browse
+ url: /
+ - label: Resources
+ items:
+ - label: Themerr
+ url: https://themerr.lizardbyte.dev/
+ - label: LizardByte blog
+ url: /blog/
+ scope: umbrella
+ umbrella:
+ name: LizardByte
+ url: https://app.lizardbyte.dev/
+ logo: /assets/lizardbyte-wordmark.svg
+ footer:
+ - label: Explore projects
+ url: /
+ scope: umbrella
+ - label: Get support
+ url: /support/
+ scope: umbrella
+ copyright: LizardByte
+```
+
+- Use an empty `baseurl` for a domain root. Set a subpath such as `/ThemerrDB` for a
+ project site. Local links and assets automatically use the consumer's `baseurl`.
+- Set `jackal.umbrella.url` to a full origin when the parent site is on another domain.
+ Use `/` for the root of the same origin, or a path such as `/previews/42` when a
+ preview hosts the umbrella site there. Links marked `scope: umbrella` use that
+ URL, independently of the project's own `baseurl`.
+- `jackal.umbrella.logo` is a project asset unless it is an absolute URL or
+ `jackal.umbrella.logo_scope: umbrella` is set. If `jackal.umbrella` is omitted,
+ the footer displays the site's own name.
+- Set `jackal.name` to override the displayed site name. Set `jackal.styles` and
+ `jackal.scripts` for site-wide assets. Pages can also specify their own
+ `styles` and `scripts` lists in front matter.
+- Adjust the theme tokens in your stylesheet. Set `--jackal-accent`,
+ `--jackal-on-accent`, and `--jackal-accent-soft` together so buttons and links
+ remain readable in both modes. See [Themerr's example palette](example/assets/example/themerr.css).
+
+## Layouts
+
+- `home` displays a hero, content, sections, and recent posts. Set
+ `show_posts: false` to hide the post list, or use `posts_title` and
+ `posts_limit` to customize it.
+- `product` displays a hero, page content, and reusable sections. Optional
+ `hero.image` fields include `dark_src`, `width`, `height`, and `caption`.
+ Set `alt` to describe informative images.
+- `page` and `post` provide a reading layout. Use `blog` for a post index.
+- `catalog` provides a full-width layout for a data browser. Catalogs can use the
+ theme's grid, table, and toolbar styles with their own data and JavaScript.
+- `jackal` provides the base layout for a custom page.
+
+Product and home pages build their content using these section types:
+
+- `cards` for features, linked projects, or platform downloads.
+- `gallery` for screenshots, with optional alternate images for dark mode.
+- `faq` for expandable questions and answers.
+- `callout` for a highlighted action such as sponsorship or installation help.
+- `custom` for a site-owned template in `_includes`. Set `template` to its
+ filename and read any section fields with `include.section`.
+
+See the [Sunshine example](example/sunshine.md) and [Themerr example](example/themerr.md)
+for concrete front matter. Use [the catalog example](example/catalog/index.html)
+as a starting point for a project with its own generated data.
+
+When migrating a site, keep its existing `url`, `baseurl`, permalinks, feeds, and redirects.
+Keep generated data, release assets, and downloads at their existing public paths.
+Build and compare the new output before changing a site's publishing workflow.
diff --git a/_includes/jackal/actions.html b/_includes/jackal/actions.html
new file mode 100644
index 0000000..e3d5ad7
--- /dev/null
+++ b/_includes/jackal/actions.html
@@ -0,0 +1,10 @@
+{% if include.actions.size > 0 %}
+
+{% endif %}
diff --git a/_includes/jackal/footer.html b/_includes/jackal/footer.html
new file mode 100644
index 0000000..6648f9f
--- /dev/null
+++ b/_includes/jackal/footer.html
@@ -0,0 +1,31 @@
+
diff --git a/_includes/jackal/head.html b/_includes/jackal/head.html
new file mode 100644
index 0000000..421d964
--- /dev/null
+++ b/_includes/jackal/head.html
@@ -0,0 +1,24 @@
+
+
+
+ {% assign jackal_title = site.jackal.name | default: site.title %}
+ {% assign jackal_description = page.description | default: page.hero.description | default: site.description %}
+ {% if page.title and page.title != jackal_title %}{{ page.title | escape }} · {% endif %}{{ jackal_title | escape }}
+ {% if jackal_description %}
+
+ {% endif %}
+ {% if site.url and site.url != empty %}
+
+ {% endif %}
+ {% if site.jackal.icon %}
+
+ {% endif %}
+
+
+ {% for jackal_style in site.jackal.styles %}
+
+ {% endfor %}
+ {% for jackal_style in page.styles %}
+
+ {% endfor %}
+
diff --git a/_includes/jackal/header.html b/_includes/jackal/header.html
new file mode 100644
index 0000000..a17e93e
--- /dev/null
+++ b/_includes/jackal/header.html
@@ -0,0 +1,40 @@
+
diff --git a/_includes/jackal/hero.html b/_includes/jackal/hero.html
new file mode 100644
index 0000000..8af3515
--- /dev/null
+++ b/_includes/jackal/hero.html
@@ -0,0 +1,14 @@
+{% assign jackal_hero = include.hero %}
+
diff --git a/_includes/jackal/media.html b/_includes/jackal/media.html
new file mode 100644
index 0000000..58a5d72
--- /dev/null
+++ b/_includes/jackal/media.html
@@ -0,0 +1,13 @@
+{% assign jackal_image = include.image %}
+
+
+ {% if jackal_image.dark_src %}
+
+ {% endif %}
+ {% if jackal_image.caption %}{{ jackal_image.caption | escape }} {% endif %}
+
diff --git a/_includes/jackal/nav-link.html b/_includes/jackal/nav-link.html
new file mode 100644
index 0000000..1a3fe28
--- /dev/null
+++ b/_includes/jackal/nav-link.html
@@ -0,0 +1,5 @@
+{%- capture jackal_nav_url -%}{% include jackal/url.html url=include.link.url scope=include.link.scope %}{%- endcapture -%}
+{%- assign jackal_nav_current = page.url | relative_url | escape -%}
+
+ {{- include.link.label | escape -}}
+
diff --git a/_includes/jackal/page-header.html b/_includes/jackal/page-header.html
new file mode 100644
index 0000000..d0b816a
--- /dev/null
+++ b/_includes/jackal/page-header.html
@@ -0,0 +1,4 @@
+
diff --git a/_includes/jackal/post-grid.html b/_includes/jackal/post-grid.html
new file mode 100644
index 0000000..009f4b3
--- /dev/null
+++ b/_includes/jackal/post-grid.html
@@ -0,0 +1,12 @@
+
+ {% assign jackal_post_limit = include.limit | default: include.posts.size %}
+ {% for jackal_post in include.posts limit: jackal_post_limit %}
+
+
+ {{ jackal_post.date | date_to_string }}
+
+
+ {{ jackal_post.description | default: jackal_post.excerpt | strip_html | strip_newlines | escape }}
+
+ {% endfor %}
+
diff --git a/_includes/jackal/sections.html b/_includes/jackal/sections.html
new file mode 100644
index 0000000..2e669b8
--- /dev/null
+++ b/_includes/jackal/sections.html
@@ -0,0 +1,38 @@
+{% for jackal_section in include.sections %}
+
+ {% if jackal_section.title %}{{ jackal_section.title | escape }} {% endif %}
+ {% if jackal_section.description %}{{ jackal_section.description | escape }}
{% endif %}
+ {% case jackal_section.type %}
+ {% when 'cards' %}
+
+ {% for jackal_card in jackal_section.items %}
+
+ {{ jackal_card.title | escape }}
+ {% if jackal_card.description %}{{ jackal_card.description | markdownify }}
{% endif %}
+ {% include jackal/actions.html actions=jackal_card.actions %}
+
+ {% endfor %}
+
+ {% when 'gallery' %}
+
+ {% for jackal_gallery_image in jackal_section.items %}
+ {% include jackal/media.html image=jackal_gallery_image %}
+ {% endfor %}
+
+ {% when 'faq' %}
+
+ {% for jackal_question in jackal_section.items %}
+
+ {{ jackal_question.question | escape }}
+ {{ jackal_question.answer | markdownify }}
+
+ {% endfor %}
+
+ {% when 'callout' %}
+ {% include jackal/actions.html actions=jackal_section.actions %}
+ {% when 'custom' %}
+ {% include {{ jackal_section.template }} section=jackal_section %}
+ {% endcase %}
+
+{% endfor %}
diff --git a/_includes/jackal/url.html b/_includes/jackal/url.html
new file mode 100644
index 0000000..e41372f
--- /dev/null
+++ b/_includes/jackal/url.html
@@ -0,0 +1,19 @@
+{%- assign jackal_url = include.url | default: '' | strip -%}
+{%- assign jackal_url_start = jackal_url | slice: 0, 1 -%}
+{%- assign jackal_url_pair = jackal_url | slice: 0, 2 -%}
+{%- assign jackal_url_scheme = jackal_url | split: ':' | first -%}
+{%- if jackal_url == empty or jackal_url contains '://' or jackal_url_start == '#' or jackal_url_start == '?'
+ or jackal_url_pair == '//' or jackal_url_scheme == 'mailto' or jackal_url_scheme == 'tel' -%}
+ {{- jackal_url | escape -}}
+{%- elsif include.scope == 'umbrella' -%}
+ {%- assign jackal_umbrella_root = site.jackal.umbrella.url | default: '/' | strip -%}
+ {%- assign jackal_umbrella_root_end = jackal_umbrella_root | slice: -1, 1 -%}
+ {%- if jackal_url_start == '/' -%}
+ {%- assign jackal_url = jackal_url | remove_first: '/' -%}
+ {%- endif -%}
+ {{- jackal_umbrella_root | escape -}}
+ {%- unless jackal_umbrella_root_end == '/' -%}/{%- endunless -%}
+ {{- jackal_url | escape -}}
+{%- else -%}
+ {{- jackal_url | relative_url | escape -}}
+{%- endif -%}
diff --git a/_layouts/blog.html b/_layouts/blog.html
new file mode 100644
index 0000000..5f8b1e0
--- /dev/null
+++ b/_layouts/blog.html
@@ -0,0 +1,8 @@
+---
+layout: jackal
+---
+
+ {% include jackal/page-header.html %}
+
{{ content }}
+ {% include jackal/post-grid.html posts=site.posts %}
+
diff --git a/_layouts/catalog.html b/_layouts/catalog.html
new file mode 100644
index 0000000..ff9ddb6
--- /dev/null
+++ b/_layouts/catalog.html
@@ -0,0 +1,7 @@
+---
+layout: jackal
+---
+
+ {% include jackal/page-header.html %}
+ {{ content }}
+
diff --git a/_layouts/home.html b/_layouts/home.html
new file mode 100644
index 0000000..fb1f805
--- /dev/null
+++ b/_layouts/home.html
@@ -0,0 +1,19 @@
+---
+layout: jackal
+---
+{% include jackal/hero.html hero=page.hero %}
+
+{% assign jackal_home_body = content | strip %}
+{% if jackal_home_body != empty %}
+ {{ content }}
+{% endif %}
+
+{% include jackal/sections.html sections=page.sections %}
+
+{% if site.posts.size > 0 and page.show_posts != false %}
+
+ {{ page.posts_title | default: 'Latest news' | escape }}
+ {% assign jackal_home_post_limit = page.posts_limit | default: 3 %}
+ {% include jackal/post-grid.html posts=site.posts limit=jackal_home_post_limit %}
+
+{% endif %}
diff --git a/_layouts/jackal.html b/_layouts/jackal.html
new file mode 100644
index 0000000..8d29d9f
--- /dev/null
+++ b/_layouts/jackal.html
@@ -0,0 +1,18 @@
+
+
+ {% include jackal/head.html %}
+
+ Skip to content
+ {% include jackal/header.html %}
+
+ {{ content }}
+
+ {% include jackal/footer.html %}
+ {% for jackal_script in site.jackal.scripts %}
+
+ {% endfor %}
+ {% for jackal_script in page.scripts %}
+
+ {% endfor %}
+
+
diff --git a/_layouts/page.html b/_layouts/page.html
new file mode 100644
index 0000000..58ff34b
--- /dev/null
+++ b/_layouts/page.html
@@ -0,0 +1,7 @@
+---
+layout: jackal
+---
+
+ {% include jackal/page-header.html %}
+ {{ content }}
+
diff --git a/_layouts/post.html b/_layouts/post.html
new file mode 100644
index 0000000..00bd04d
--- /dev/null
+++ b/_layouts/post.html
@@ -0,0 +1,11 @@
+---
+layout: jackal
+---
+
+ {% include jackal/page-header.html %}
+
+ {{ page.date | date_to_string }}
+ {% if page.author %} · {{ page.author | escape }} {% endif %}
+
+ {{ content }}
+
diff --git a/_layouts/product.html b/_layouts/product.html
new file mode 100644
index 0000000..56cce7a
--- /dev/null
+++ b/_layouts/product.html
@@ -0,0 +1,11 @@
+---
+layout: jackal
+---
+{% include jackal/hero.html hero=page.hero %}
+
+{% assign jackal_product_body = content | strip %}
+{% if jackal_product_body != empty %}
+ {{ content }}
+{% endif %}
+
+{% include jackal/sections.html sections=page.sections %}
diff --git a/assets/jackal/jackal.css b/assets/jackal/jackal.css
new file mode 100644
index 0000000..de56171
--- /dev/null
+++ b/assets/jackal/jackal.css
@@ -0,0 +1,317 @@
+:root {
+ color-scheme: light dark;
+ --jackal-paper: light-dark(#f7f5ee, #171715);
+ --jackal-surface: light-dark(#fffdf7, #232320);
+ --jackal-muted-surface: light-dark(#eeeae0, #292824);
+ --jackal-ink: light-dark(#22221e, #f5f1e8);
+ --jackal-muted: light-dark(#605d52, #c8c1b1);
+ --jackal-border: light-dark(#d6cfc0, #49463d);
+ --jackal-accent: light-dark(#9b3f1c, #ffb085);
+ --jackal-on-accent: light-dark(#fffdf7, #261106);
+ --jackal-accent-soft: light-dark(#f8e6da, #37271e);
+ --jackal-max-width: 74rem;
+ --jackal-prose-width: 67ch;
+ --jackal-gutter: clamp(1.25rem, 4vw, 3rem);
+ --jackal-radius: 1rem;
+ --jackal-font: system-ui, -apple-system, "Segoe UI", sans-serif;
+}
+
+:root[data-jackal-theme="light"] { color-scheme: light; }
+:root[data-jackal-theme="dark"] { color-scheme: dark; }
+
+body {
+ margin: 0;
+ min-width: 0;
+ background: var(--jackal-paper);
+ color: var(--jackal-ink);
+ font: 1rem/1.65 var(--jackal-font);
+}
+
+body, .jackal-header, .jackal-main, .jackal-footer { box-sizing: border-box; }
+a { color: var(--jackal-accent); text-underline-offset: 0.2em; }
+a:hover { text-decoration-thickness: 0.13em; }
+:focus-visible { outline: 2px solid var(--jackal-accent); outline-offset: 4px; }
+[id] { scroll-margin-top: 2rem; }
+
+.jackal-wrap {
+ box-sizing: border-box;
+ width: min(100%, var(--jackal-max-width));
+ margin-inline: auto;
+ padding-inline: var(--jackal-gutter);
+}
+
+.jackal-main { min-height: 56vh; padding-bottom: clamp(3rem, 9vw, 8rem); }
+
+.jackal-sr-only, .jackal-skip:not(:focus) {
+ position: absolute;
+ width: 1px;
+ height: 1px;
+ overflow: hidden;
+ clip-path: inset(50%);
+ white-space: nowrap;
+}
+
+.jackal-skip:focus {
+ position: absolute;
+ z-index: 3;
+ inset: 0 auto auto 0;
+ padding: 0.75rem 1rem;
+ background: var(--jackal-surface);
+}
+
+.jackal-header { border-bottom: 1px solid var(--jackal-border); }
+
+.jackal-header__inner {
+ display: flex;
+ align-items: center;
+ flex-wrap: wrap;
+ gap: 0.6rem 1.5rem;
+ min-height: 4.75rem;
+ padding-block: 0.75rem;
+}
+
+.jackal-brand {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.65rem;
+ color: var(--jackal-ink);
+ font-size: 1.22rem;
+ font-weight: 800;
+ letter-spacing: -0.05em;
+ text-decoration: none;
+}
+
+.jackal-brand img { object-fit: contain; }
+.jackal-nav { margin-inline-start: auto; }
+
+.jackal-nav ul {
+ margin: 0;
+ padding: 0;
+ list-style: none;
+}
+
+.jackal-nav__list {
+ display: flex;
+ align-items: baseline;
+ flex-wrap: wrap;
+ gap: 0.25rem 1.5rem;
+}
+
+.jackal-nav a, .jackal-nav summary, .jackal-footer nav a {
+ color: var(--jackal-ink);
+ font-size: 0.9rem;
+ font-weight: 650;
+ text-decoration: none;
+}
+
+.jackal-nav a:hover, .jackal-nav a[aria-current="page"], .jackal-footer nav a:hover {
+ color: var(--jackal-accent);
+ text-decoration: underline;
+}
+
+.jackal-nav__group { position: relative; }
+.jackal-nav summary, .jackal-faq summary { cursor: pointer; }
+
+.jackal-nav .jackal-nav__dropdown {
+ position: absolute;
+ z-index: 2;
+ top: calc(100% + 0.35rem);
+ inset-inline-end: 0;
+ width: max-content;
+ max-width: 80vw;
+ padding: 0.5rem;
+ border: 1px solid var(--jackal-border);
+ border-radius: 0.75rem;
+ background: var(--jackal-surface);
+}
+
+.jackal-nav__dropdown a { display: block; padding: 0.4rem 0.65rem; }
+.jackal-theme-control { margin-inline-start: auto; }
+.jackal-nav + .jackal-theme-control { margin-inline-start: 0; }
+
+.jackal-theme-control select, .jackal-input {
+ box-sizing: border-box;
+ min-height: 2.25rem;
+ padding: 0.4rem 0.65rem;
+ border: 1px solid var(--jackal-border);
+ border-radius: 0.6rem;
+ background: var(--jackal-surface);
+ color: var(--jackal-ink);
+ font: inherit;
+}
+
+.jackal-theme-control select { font-size: 0.85rem; }
+.jackal-input { padding: 0.65rem 0.8rem; width: min(100%, 30rem); }
+
+.jackal-hero {
+ display: grid;
+ align-items: center;
+ gap: clamp(2rem, 5vw, 4.5rem);
+ padding-block: clamp(3.5rem, 8vw, 7rem);
+}
+
+.jackal-hero--with-image { grid-template-columns: minmax(0, 0.95fr) minmax(0, 1.05fr); }
+
+.jackal-main h1, .jackal-main h2, .jackal-main h3 {
+ line-height: 1.05;
+ letter-spacing: -0.041em;
+ text-wrap: balance;
+}
+
+.jackal-hero h1, .jackal-page-header h1 { margin: 0; font-size: clamp(2.85rem, 7vw, 5.8rem); }
+.jackal-hero h1 { max-width: 15ch; }
+.jackal-hero__copy > :last-child, .jackal-page-header > :last-child { margin-bottom: 0; }
+.jackal-main h2 { margin: 0 0 1.4rem; font-size: clamp(1.85rem, 4.5vw, 3rem); }
+.jackal-main h3 { margin: 0; font-size: 1.35rem; }
+
+.jackal-lede {
+ max-width: 56ch;
+ margin-block: 1.2rem 1.75rem;
+ color: var(--jackal-muted);
+ font-size: clamp(1.05rem, 2.4vw, 1.32rem);
+ line-height: 1.55;
+}
+
+.jackal-actions { display: flex; flex-wrap: wrap; gap: 0.65rem; margin-top: 1.25rem; }
+
+.jackal-button {
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ box-sizing: border-box;
+ min-height: 2.75rem;
+ padding: 0.55rem 1.1rem;
+ border: 1px solid var(--jackal-border);
+ border-radius: 2rem;
+ background: var(--jackal-surface);
+ color: var(--jackal-ink);
+ font-size: 0.95rem;
+ font-weight: 680;
+ text-decoration: none;
+}
+
+.jackal-button--primary {
+ border-color: var(--jackal-accent);
+ background: var(--jackal-accent);
+ color: var(--jackal-on-accent);
+}
+
+.jackal-button:hover { text-decoration: underline; }
+
+.jackal-section + .jackal-section { margin-top: clamp(3rem, 7vw, 6rem); }
+.jackal-section h2 + .jackal-lede { margin-top: -0.6rem; }
+
+.jackal-section--callout {
+ width: min(calc(100% - 2 * var(--jackal-gutter)), calc(var(--jackal-max-width) - 2 * var(--jackal-gutter)));
+ padding: clamp(1.5rem, 5vw, 3rem);
+ border: 1px solid var(--jackal-border);
+ border-radius: var(--jackal-radius);
+ background: var(--jackal-accent-soft);
+}
+
+.jackal-grid {
+ display: grid;
+ grid-template-columns: repeat(auto-fit, minmax(min(100%, 16rem), 1fr));
+ gap: 1rem;
+}
+
+.jackal-card {
+ display: flex;
+ flex-direction: column;
+ align-items: start;
+ gap: 0.75rem;
+ min-width: 0;
+ padding: clamp(1rem, 3vw, 1.6rem);
+ border: 1px solid var(--jackal-border);
+ border-radius: var(--jackal-radius);
+ background: var(--jackal-surface);
+}
+
+.jackal-card p { margin: 0; color: var(--jackal-muted); }
+.jackal-card .jackal-actions { margin-top: auto; padding-top: 0.25rem; }
+.jackal-card .jackal-prose > :first-child { margin-top: 0; }
+.jackal-card .jackal-prose > :last-child { margin-bottom: 0; }
+
+.jackal-media { min-width: 0; margin: 0; }
+
+.jackal-media img {
+ display: block;
+ box-sizing: border-box;
+ width: 100%;
+ height: auto;
+ border: 1px solid var(--jackal-border);
+ border-radius: var(--jackal-radius);
+ background: var(--jackal-surface);
+}
+
+.jackal-media img.jackal-media__dark { display: none; }
+
+:root[data-jackal-theme="dark"] .jackal-media img.jackal-media__light { display: none; }
+:root[data-jackal-theme="dark"] .jackal-media img.jackal-media__dark { display: block; }
+
+@media (prefers-color-scheme: dark) {
+ :root:not([data-jackal-theme="light"]) .jackal-media img.jackal-media__light { display: none; }
+ :root:not([data-jackal-theme="light"]) .jackal-media img.jackal-media__dark { display: block; }
+}
+
+.jackal-media figcaption, .jackal-meta { margin-top: 0.5rem; color: var(--jackal-muted); font-size: 0.9rem; }
+.jackal-faq details { max-width: 52rem; padding-block: 0.8rem; border-bottom: 1px solid var(--jackal-border); }
+.jackal-faq summary { font-weight: 700; }
+.jackal-faq details > div { margin-inline-start: 1.15rem; }
+
+.jackal-reading { max-width: calc(51rem + 2 * var(--jackal-gutter)); }
+.jackal-page-header { margin-block: clamp(2rem, 6vw, 4.75rem) 1.5rem; }
+.jackal-page-header h1 { font-size: clamp(2.4rem, 6vw, 4.75rem); }
+.jackal-prose { max-width: var(--jackal-prose-width); overflow-wrap: break-word; }
+.jackal-prose > h2 { margin-top: 1.6em; font-size: clamp(1.6rem, 4vw, 2.25rem); }
+.jackal-prose > h3 { margin-top: 1.55em; }
+.jackal-prose > :last-child { margin-bottom: 0; }
+.jackal-prose img { max-width: 100%; height: auto; }
+.jackal-prose pre { padding: 1rem; overflow: auto; }
+
+.jackal-prose pre, .jackal-prose :not(pre) > code {
+ border-radius: 0.4rem;
+ background: var(--jackal-muted-surface);
+}
+
+.jackal-prose :not(pre) > code { padding: 0.1em 0.28em; }
+.jackal-prose blockquote { margin-inline: 0; padding-inline-start: 1rem; border-inline-start: 3px solid var(--jackal-accent); }
+.jackal-catalog-toolbar { display: flex; flex-wrap: wrap; align-items: end; gap: 1rem; margin-block: 1.5rem; }
+.jackal-catalog-toolbar[hidden] { display: none; }
+.jackal-catalog-toolbar label { display: grid; gap: 0.25rem; flex: 1 1 18rem; }
+.jackal-table-wrap { overflow-x: auto; border: 1px solid var(--jackal-border); border-radius: var(--jackal-radius); }
+
+.jackal-table {
+ width: 100%;
+ border-collapse: collapse;
+ background: var(--jackal-surface);
+ text-align: start;
+}
+
+.jackal-table th, .jackal-table td { padding: 0.8rem 1rem; border-bottom: 1px solid var(--jackal-border); text-align: start; }
+.jackal-table th { background: var(--jackal-muted-surface); }
+.jackal-table tbody tr:last-child td { border-bottom: 0; }
+
+.jackal-footer { border-top: 1px solid var(--jackal-border); }
+
+.jackal-footer__inner {
+ display: grid;
+ justify-items: center;
+ gap: 1rem;
+ padding-block: 2.5rem;
+ text-align: center;
+}
+
+.jackal-affiliation, .jackal-footer__name { margin: 0; font-weight: 700; }
+.jackal-affiliation { display: flex; align-items: center; justify-content: center; flex-wrap: wrap; gap: 0.38rem; }
+.jackal-affiliation img { display: block; width: auto; height: 1.5rem; max-width: 10rem; object-fit: contain; }
+.jackal-footer nav { display: flex; justify-content: center; flex-wrap: wrap; gap: 0.45rem 1.15rem; }
+.jackal-footer small { color: var(--jackal-muted); }
+
+@media (max-width: 46rem) {
+ .jackal-hero--with-image { grid-template-columns: minmax(0, 1fr); }
+ .jackal-theme-control, .jackal-nav + .jackal-theme-control { margin-inline-start: auto; }
+ .jackal-nav { order: 1; flex-basis: 100%; margin-inline-start: 0; }
+ .jackal-nav .jackal-nav__dropdown { position: static; margin-top: 0.4rem; }
+ .jackal-nav__list { gap: 0.3rem 1rem; }
+}
diff --git a/assets/jackal/theme.js b/assets/jackal/theme.js
new file mode 100644
index 0000000..5f02501
--- /dev/null
+++ b/assets/jackal/theme.js
@@ -0,0 +1,37 @@
+(() => {
+ const modes = ['system', 'light', 'dark'];
+ const storageKey = 'jackal-color-mode';
+ let mode = 'system';
+
+ try {
+ const saved = window.localStorage.getItem(storageKey);
+ if (modes.includes(saved)) mode = saved;
+ } catch {
+ // The control still works for this page if storage is unavailable.
+ }
+
+ function applyMode(value) {
+ document.documentElement.dataset.jackalTheme = value;
+ }
+
+ applyMode(mode);
+ document.addEventListener('DOMContentLoaded', () => {
+ const control = document.querySelector('[data-jackal-theme-control]');
+ const selector = control?.querySelector('[data-jackal-theme]');
+ if (!selector) return;
+
+ selector.value = mode;
+ control.hidden = false;
+ selector.addEventListener('change', () => {
+ const next = selector.value;
+ if (!modes.includes(next)) return;
+
+ applyMode(next);
+ try {
+ window.localStorage.setItem(storageKey, next);
+ } catch {
+ // Apply the selection even when it cannot be remembered.
+ }
+ });
+ });
+})();
diff --git a/docs/jackal-preview.jpg b/docs/jackal-preview.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..97614f75f2f2ef602aafa45f48ebdfb3e43451e2
GIT binary patch
literal 123213
zcmeFZcUV)~wl^FLqM)+rN)e?Kno^|%w$i(hgqna-6hf1Z)GbPvASLvol!PP{=^Zv8
zT|i3cMLLAurN2?nId^~ep8LGtec$^%-~Hnx&ok#*YpglO?>A;!Yt6CN`SAHSz;Eix
zYRZ5M7XW|@q(9(%44?qGa+&N3+2t!&$gYr+U%5*08wJI+YZP=hsjmOVNO$WNBOL<+
z6Dt=R6Eg=31H)Z`yByp+d_cb2Y=ZX%dGB-a^6~yqa)F$joZ>14Ed>QFFB1b3?|=Ds
z{wIL?D*1)Wo0l%I11?fuxI}&7{4;>{2T1ZCaR2eUc!>m;{OW~kB(c?RfD4x{UATPt
z8aes3%jB0YQvojgkW*iwp}qHj{E=?&RXTP(@H3~VXnGOn*D)Up85l*y9=jHCNJv7>
zT{4RM!~+_pZ*fBO-D3MuSu>kl4;3sd-!yJj_pFKHr~VZQM9-#<|NG;@WV
zB$TJV0JsRaNb=ofz~w6!FOg2UKz;GvC7K71bT=RXRhG4&
zcBrU1qWX3tKZ;hC@ikaO_Xb=HN>|h>E}N&)D&U|Zz6R+40$)N*zjFU!^0eNFC{$!}
zw`y#@QYE!Y8B*9U$+GYfK2VE$D_ZG_jmRL|81AZ>rP%F9=gSg6@B
z!eXVzNncm3I=w4$)^z$;Hj_&s_3@#qwrsSJ
z0olHD@A1$nyRy`_A(VkTe5?k)WZyQ|y_Kf|+>o++rKOeoBC_j&NxIS~ax5Rmll4iL
zsG&YKrli7Uuffz|rJBqPTaa?bO`u@xK&K9%u)y>94{K&ZF|LtW$fOMo{bly7=nU~G
z<%RNa*bu*NTi)EfCZunY-n-?U20N;U)*TiS!u8u(l$-}B9$Dk&r<%WY{2TLxCkaJe92Fh8ZZJ*+aIWxMU$&Wcw1CA2tu?V-DcXM
zB|{e2FNrpM6NMVy*&3gASMXsOXle3GR?6<5UeP^jxQfC#!YYrmV(!~j!V*TH
z#M3nH#s{fZ+4Xz~J6g}ha39o5WIc0U?RtlBRF{NHnvd@rA76{l6Y^@$;!I(c|=i4OK$nKVTD0^JP85F>7d
z)#+`|VB1{+!fu9p=o6XD;zVc4&jIlgH3o}L-7CyKa`EE|?n_B&%MJr{dyL|fu>5pj
z15Y@6wrog(awTqFjX4mOF)Jm?EIM{JmDZeE=~BKm+EMa6KZEd6Upg+SE(nc;gk>P>
zSifum(O{cOQ;HODXjB45B}rS0%N~o#!F|llNrTUHY1jn?O6XEkBAwHErWWJr=?wV7E&vvy%iXef_mi)MvUZ%F_`$cN+dnxUFJ9}
zeEb>V?Q6SY3bZiDBXg`>sSv+0Qc_y7^~5v!38YU#A74gj=Z4`DXRs0JxiO3n4mQ)p
zLvzwRT4U(@;X)i@Ey-?Y1Xp}5{BE4;Y*}AcxWpQ9BFmvq2uf=kV3E!#Y~T==tKXRi
z7l<`TT((Br(Z}E7CG3_I0W