jekyll-theme-modootoday 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2d46e35ab0076998d0b4c63e7467f127e6c3821762af5deb6fae73b38300a70
-  data.tar.gz: 975bd03dc80968327a2cbdb253c2fea15340a57864c2163739382976e9ce462a
+  metadata.gz: 497fb07373c85ca822bcf41f91d4d0703a01209ecaa819b9b7ac7ed98471e1cd
+  data.tar.gz: b71c8b2a29a3b01a081330e0d09c0db0233b3a6f2d53224ffa5bad8f65f6c167
 SHA512:
-  metadata.gz: 8eb8f3fb6b6d43b27a1ba9b10513460df6d402acca489dc450da43b41d86f68a9d3c85ad4ba16e4fda29792cfde9dd9b9708c6cbf9c7c6f3f2f77f040c191ee0
-  data.tar.gz: fa3eab12b29e6b53f6ffcb3717ca9df1316a17008038aeaf2d5da67b4cbffd28f10f5ed69c4e92c2f08f43c454309f9a60a55b394003ddf50743f49883ddc8b5
+  metadata.gz: ed3f80481897f18f963d7cc0bc3874bb9c80aaa2d5cb4e2cb75a2ffd9150cae1cd276d14f50239a380206c5eb1c9815a58353087cdc58ebe087de17f8ad5ae4b
+  data.tar.gz: 036c0ae7ee9ed578162fda1812f2ff3e51dacb39619d56e6e006278ac351597f0f47d78da59e95aeb7b4756f33049f6bc5c292f46e947bb55b565313a1c9faa6

data/CHANGELOG.md

@@ -6,6 +6,33 @@ The content rules have their own version header (`md-components v1`) in [RULES.m
 
 ## [Unreleased]
 
+## [1.1.1] - 2026-10-31
+
+### Added
+
+- Release workflow: after the gem is pushed to RubyGems, a GitHub Release is created for the tag with its `CHANGELOG.md` entry as the notes (`script/release-notes`); skipped when the Release already exists.
+- `mt-flat-list`: put it on an ancestor of an unclassed Markdown list that a layout makes a grid or flex row (`.c-body > ul`) to drop the gap between list items (RULES.md §6, Customize).
+- `badge: bottom` on a `c: features` section (`.mt-badge-bottom`): a status badge at the end of a card item sits at the card's bottom edge, so badges line up across a row.
+- `reveal: true` on `hero:` or a section item (`.mt-reveal`): a CSS-only fade-in on scroll, inside `@supports (animation-timeline: view())` and `prefers-reduced-motion: no-preference`. Without support, or when the reader prefers less motion, the content is shown as is. No script.
+- Optional list styles: `modootoday.lists: {link_chips: true, titled_items: true}` turns link-only lists on plain sections and pages into `ul.mt-chips` and `- **Title**: text` items into `strong.mt-item-title` + `span.mt-item-sep`; `hero: {checks: true}` makes the hero's first list a row of ✓ marks (`--mt-ok`). They use a new `lists` sheet (under 1.25 KiB) linked only where used; core CSS is unchanged. The hero lead paragraph gets `.mt-hero-lead`.
+- `decor: <include>` on `hero:` or a section item: an `aria-hidden` ornament in `.mt-section-decor`, placed in the top end corner. `modootoday-check` reports a missing include.
+- `.mt-illustration` convention: `figure[role=img]` with a non-empty `aria-label` and an optional `.mt-illustration-tag` badge; `modootoday-check` reports any other markup in the built site.
+- `ref:` in front matter links translations that live under different paths: `hreflang` and the language switcher use it, and `modootoday/link.html` with `ref=` gives that page's URL in the current language, or in the default language. `modootoday-check` reports a `ref=` that no page defines.
+- `modootoday.full_languages` and `modootoday-check --i18n-pages`: warnings for default-language pages with no translation in those languages; `--strict` makes them fail.
+- `c: split` section: text and its `visual:` include side by side from 48rem, stacked below; params `side: start|end` and `ratio: "1:1"|"5:7"`, inner wrappers `.mt-section-in`, `.mt-section-body`, `.mt-section-visual` (split only, so other sections keep their markup), its own section sheet. `modootoday-check` requires `visual:` on a split.
+- `visual:` include: any other key on the section item reaches the include as `include.section.<key>`, and `modootoday-check` accepts such keys on a section that has `visual:`.
+- Docs: moving from `jekyll-seo-tag` to the kit's SEO tags (Migrate), and what to run when `modootoday-check` is not on `PATH` after `gem install` (Install).
+
+### Changed
+
+- Brand: the visible site name is now **modoo.today theme** (Korean **모두의오늘 테마**, Japanese **modoo.today テーマ**, other languages localized) in the docs header, `<title>`, `og:site_name`, JSON-LD and breadcrumbs, so it is not confused with the modoo.today service. A new optional `site_title` in `_data/i18n/<lang>.yml` sets the header name per language and falls back to `site.title`. The gem name, repository paths, CSS classes, config keys and `modootoday-check` are unchanged.
+- Size budgets have a little more headroom (QA, `qa/audit/config.mjs`): core CSS sheet 24 → 27 KiB, core JS 10 → 11 KiB, CSS one page links 32 → 35 KiB, `loading.css` 2 → 2.5 KiB, `figure.css` 1 → 1.25 KiB, each renderer script 2 → 2.5 KiB. Section sheets stay at 2 KiB. The built sizes did not grow (core CSS 24531 B, core JS 10227 B).
+
+### Fixed
+
+- Checker: specfold value markers with arguments after the name (`<!-- spec:graph format=mermaid source=tutorial -->`, `<!-- spec:count rows="All commands" -->`) are no longer reported as HTML comments (RULES.md, HTML comments row). The HTML comment error now quotes the first comment it found.
+- Checker: JSON-LD between the `jekyll-seo-tag` comments (sites with `seo: false` that bring the plugin) is checked only for valid JSON and reported as a warning, so its `WebPage` without `name` is no longer an error; the kit's own block is still checked in full and not counted as a second block (Structured data).
+
 ## [1.1.0] - 2026-10-31
 
 ### Added
@@ -200,6 +227,7 @@ Internal development milestones, never released. They are all part of 1.0.0.
 - Example: `sass.silence_deprecations: [import]` for Dart Sass; `llms.txt` per language generated instead of hand-written.
 - Raw `<name>.md` copies in `_site` on GitHub Pages: caused by content files without front matter (rendered by `jekyll-optional-front-matter` and also copied). Front matter is now required and checked.
 
-[Unreleased]: https://github.com/modootoday/jekyll-theme-modootoday/compare/v1.1.0...HEAD
+[Unreleased]: https://github.com/modootoday/jekyll-theme-modootoday/compare/v1.1.1...HEAD
+[1.1.1]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.1.1
 [1.1.0]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.1.0
 [1.0.0]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.0.0

data/README.ko.md

@@ -38,7 +38,7 @@ Gemfile 없이 GitHub Pages에서(`remote_theme:`):
 
 ```yaml
 # _config.yml
-remote_theme: modootoday/jekyll-theme-modootoday@v1.1.0
+remote_theme: modootoday/jekyll-theme-modootoday@v1.1.1
 plugins:
   - jekyll-remote-theme
 ```
@@ -79,6 +79,7 @@ bundle exec modootoday-check . _site
 | `--schema-recommended` | also warn about schema.org properties Google Search recommends (author, image, dates, ...) that a JSON-LD node lacks |
 | `--strict` | warnings fail the run |
 | `--i18n` | `_data/i18n/<lang>.yml` against the theme registry (`i18n/en.yml` in the gem): unknown keys, `%{name}` placeholder mismatches, and pages marked `translation: pending` |
+| `--i18n-pages` | warn about default-language pages with no translation in a `modootoday.full_languages` language (the page with the same `ref:`, else the same path under `<lang>/`); with `--strict` they fail |
 | `--i18n-init=LANG,...` | copy the theme's catalogs (`i18n/<lang>.yml`, 23 languages) into `SRC/_data/i18n/` as a starting point for overrides (optional; the theme already uses them), and list keys an existing catalog lacks |
 | `--gh` | also render each page with `gh api markdown` (network, `gh` login) |
 | `--help, -h` | print usage and options (`--help=markdown` prints the README table) |

data/README.md

@@ -35,7 +35,7 @@ On GitHub Pages without a Gemfile (`remote_theme:`):
 
 ```yaml
 # _config.yml
-remote_theme: modootoday/jekyll-theme-modootoday@v1.1.0
+remote_theme: modootoday/jekyll-theme-modootoday@v1.1.1
 plugins:
   - jekyll-remote-theme
 ```
@@ -76,6 +76,7 @@ Walkthrough: [Write your first page](https://modootoday.github.io/jekyll-theme-m
 | `--schema-recommended` | also warn about schema.org properties Google Search recommends (author, image, dates, ...) that a JSON-LD node lacks |
 | `--strict` | warnings fail the run |
 | `--i18n` | `_data/i18n/<lang>.yml` against the theme registry (`i18n/en.yml` in the gem): unknown keys, `%{name}` placeholder mismatches, and pages marked `translation: pending` |
+| `--i18n-pages` | warn about default-language pages with no translation in a `modootoday.full_languages` language (the page with the same `ref:`, else the same path under `<lang>/`); with `--strict` they fail |
 | `--i18n-init=LANG,...` | copy the theme's catalogs (`i18n/<lang>.yml`, 23 languages) into `SRC/_data/i18n/` as a starting point for overrides (optional; the theme already uses them), and list keys an existing catalog lacks |
 | `--gh` | also render each page with `gh api markdown` (network, `gh` login) |
 | `--help, -h` | print usage and options (`--help=markdown` prints the README table) |

data/RULES.md

@@ -14,6 +14,10 @@ Every content page starts with front matter; an empty block (`---` then `---`) i
 |---|---|---|---|
 | Alerts (5) | top-level quote whose first line is exactly `> [!NOTE]` (TIP/IMPORTANT/WARNING/CAUTION; any case), body on the following `>` lines. The body may start with a paragraph, a blank `>` line, a list, a code block or a `###` heading. Alerts are a **GitHub extension outside the GFM spec**; other parsers show a plain quote | `_includes/modootoday/markdown/components.html` converts kramdown's `<p>[!TYPE]` + body, standalone `<p>[!TYPE]</p>` and `[!TYPE]<br />` (trailing spaces) into `blockquote.mt-callout.mt-callout-<type>[role=note]` with a localised title | quote / GitHub alert / source |
 | Sections | `# Title`, lead paragraph, link-only paragraph (CTA), then `## Section`; front matter `sections:` | `doc` layout → `_includes/modootoday/markdown/sections.html`: with `sections:` the part before the first `##` is `section.mt-hero` and item *i* wraps the *i*-th **top-level** `##` in `section.mt-section` (an `h2` nested in a quote, list or alert never splits); without it, one `div.mt-prose` | plain document |
+| Section decor | front matter `decor: <include>` on `hero:` or a section item | the include inside `div.mt-section-decor[aria-hidden=true]` at the end of the section, which gets `.mt-has-decor` | not shown |
+| List styles (optional) | `modootoday.lists: {link_chips, titled_items}`; `hero: {checks: true}` | plain sections and pages: link-only list → `ul.mt-chips`, `- **Title**: text` → `strong.mt-item-title` + `span.mt-item-sep`; hero: `.mt-hero-checks`; first `p` after the `h1` → `p.mt-hero-lead` | plain lists |
+| Scroll reveal | front matter `reveal: true` on `hero:` or a section item | `.mt-reveal` on the section; CSS-only fade-in on scroll inside `@supports (animation-timeline: view())` and `prefers-reduced-motion: no-preference` | shown as is |
+| Card badge at the bottom | `badge: bottom` on a `c: features` item | `.mt-badge-bottom` on the section; a `.mt-badge` that is a direct child of a card sits at its bottom edge | badge after the text |
 | Section mapping | each `sections:` item is a string `name` or `{c: component, name: key, ...params}`. No implicit mapping. Item count ≠ top-level `## ` count is a checker error; setext `---` headings, `##` in quotes/alerts/list items, `##` indented 1–3 spaces and `##` inside HTML comments are checker errors | `data-section`=name, `data-c`=c, class `mt-c-<c>` | none |
 | Card grid | under `##`, list items `- **Title** — text` or `- **Title**: text` | CSS only | list |
 | CTA buttons | every link-only paragraph in `section.mt-hero` and in `c: cta` sections; the first link is primary. Separator text such as `·` between links is a text node, so the paragraph still counts as link-only | CSS `p:has(> a):not(:has(> :not(a)))` | links |
@@ -39,7 +43,7 @@ Every content page starts with front matter; an empty block (`---` then `---`) i
 | Progress | `` `progress:60` `` (whole number 0–100) | `span.mt-progress` > `progress` + value text (i18n `progress.label`) | out of range is a checker error |
 | Embed | a paragraph holding only `` `embed:https://… Title` `` | `div.mt-embed` > lazy `iframe[title]` (16:9 reserved) | non-https is a checker error |
 | Loading / skeleton | `` `loading:spinner` ``, `` `loading:bar` ``, `` `skeleton:text` `` / `card` / `image` / `avatar` / `row` | `span.mt-spinner`, `span.mt-topbar`, `span.mt-skeleton` with `role=status`, `aria-busy` and i18n `loading.label`; optional `loading` sheet; reduced motion, forced colors and RTL | unknown variants are checker errors |
-| File tree / Details / FAQ / Params / Link cards / Quote / Gallery / Pricing / Subscribe | `c: filetree` (nested list), `c: details` and `c: faq` (`###` per item), `c: params` (table), `c: linkcards` (link-first list), `c: quote` (quote ending in `— name`), `c: gallery` (tight image list), `c: pricing` (`###` per plan, param `recommended`), `c: subscribe` (text; form posts to `modootoday.subscribe.action`) | per-component markup listed in docs api.md; each has its own sheet | gallery images need alt; `recommended` must be in range; subscribe action must be https |
+| File tree / Details / FAQ / Params / Link cards / Quote / Gallery / Pricing / Subscribe / Split | `c: filetree` (nested list), `c: details` and `c: faq` (`###` per item), `c: params` (table), `c: linkcards` (link-first list), `c: quote` (quote ending in `— name`), `c: gallery` (tight image list), `c: pricing` (`###` per plan, param `recommended`), `c: subscribe` (text; form posts to `modootoday.subscribe.action`), `c: split` (text beside its `visual:`, params `side`, `ratio`; the only section with inner wrappers) | per-component markup listed in docs api.md; each has its own sheet | gallery images need alt; `recommended` must be in range; subscribe action must be https; split needs `visual:` |
 | Component registry | optional `_data/components.yml`: `name: {params: {key: {allowed: [...], required: bool}}, i18n: [keys...]}` | when present the checker validates `c`, params and i18n keys | — |
 
 ## 3. Localisation
@@ -55,7 +59,7 @@ The bans are about **portability**: the same source must look the same on github
 | Forbidden | Why | Check |
 |---|---|---|
 | raw HTML (`<div>`, `<details>`, `<kbd>` …) | not portable: GitHub renders some tags (`details`, `kbd`) and strips or escapes others (`script`, `iframe`), kramdown passes everything through; keeps twins readable | checker |
-| HTML comments `<!-- -->` | hidden on GitHub but emitted by kramdown; a `##` inside one shifts section counts. Exceptions: a tool region marker alone on its line, `<!-- tool:name:begin -->` / `<!-- tool:name:end -->` (lowercase, ends in `:begin` or `:end`); a one-line specfold value marker, own-line or inline, `<!-- spec:name -->` / `<!-- /spec:name -->` (lowercase letters, digits, `.`, `_`, `-`, `:`-separated) | checker |
+| HTML comments `<!-- -->` | hidden on GitHub but emitted by kramdown; a `##` inside one shifts section counts. Exceptions: a tool region marker alone on its line, `<!-- tool:name:begin -->` / `<!-- tool:name:end -->` (lowercase, ends in `:begin` or `:end`); a one-line specfold value marker, own-line or inline, `<!-- spec:name -->` / `<!-- /spec:name -->` (lowercase letters, digits, `.`, `_`, `-`, `:`-separated), for example `<!-- spec:count -->12<!-- /spec:count -->`; arguments may follow the name after a space, `<!-- spec:count rows="All commands" -->12<!-- /spec:count -->`, on the same line and without `>`, `--` or `##` | checker |
 | Liquid `{% %}` `{{ }}` | breaks on GitHub and in twins | checker |
 | kramdown IAL/ALD `{: .x}`, `{:toc}` | kramdown-only | checker |
 | header ids `{#id}` | kramdown-only (literal text on GitHub) | checker |
@@ -114,6 +118,7 @@ Stub and generator details:
 - Liquid inside code (`{{ }}`) is still processed by Jekyll before kramdown; such pages need `{% raw %}` on the Jekyll side, which itself shows on GitHub.
 - The stylesheet uses Sass `@import` so it compiles with both Ruby Sass (GitHub Pages) and Dart Sass (Jekyll 4); Dart Sass prints deprecation warnings unless the site sets `sass: {silence_deprecations: [import, global-builtin]}` (jekyll-sass-converter ≥ 3.1). Custom properties holding Sass values must interpolate (`--x: #{$v}`); Ruby Sass prints `$v` literally.
 - Component classes are `mt-*`.
+- Lists without a class get `margin-top: .3em` between items (`:where(:not([class])) > li + li`). A layout or include that turns an unclassed Markdown list into a grid or flex row (for example `.c-body > ul`) puts `mt-flat-list` on an ancestor to drop that gap; a list with any class of its own is already exempt.
 - CTA buttons need `:has()`; without it they stay links.
 
 ## 7. Design tokens artifact

data/_includes/modootoday/breadcrumb.html

@@ -7,7 +7,7 @@ The home crumb uses the home page short_title, then its title. Hidden on the hom
 {%- if page.url != _home and page.url != "/" -%}
 {%- assign _hp = site.pages | where: "url", _home | first -%}
 <nav class="mt-breadcrumb" aria-label="{% include modootoday/i18n.html lang=_lang %}{{ mt_t_breadcrumb_label }}"><ol>
-<li><a href="{{ _home | relative_url }}">{{ _hp.short_title | default: _hp.title | default: site.title | default: "Home" }}</a></li>
+<li><a href="{{ _home | relative_url }}">{{ _hp.short_title | default: _hp.title | default: mt_site_title | default: site.title | default: "Home" }}</a></li>
 {%- assign _acc = _home -%}
 {%- for _s in _segs offset: 1 -%}{%- if forloop.index > _start and _s != "" and _s != "index.html" -%}
 {%- assign _acc = _acc | append: _s | append: "/" -%}

data/_includes/modootoday/config.html

@@ -10,15 +10,16 @@ Jekyll 3.10 / GitHub Pages, so every default lives here (Liquid). Sets mt_* vari
   site.modootoday.tokens / tokens_dark  semantic token overrides, inline :root CSS
   site.modootoday.sidebar       auto | true | false: doc-page sidebar from the nav (default auto: on when the nav has a group)
   site.modootoday.badges        false disables status badges (default true)
+  site.modootoday.lists         {link_chips: true, titled_items: true}: optional list markup (markdown/lists.html, lists sheet)
 {%- endcomment -%}
 {%- assign mt = site.modootoday -%}
-{%- assign mt_all_components = "callout,badge,hero,cta,card,tabs,code-copy,nav,sidebar,page-actions,pagination,theme-toggle,breadcrumb,toc,accordion,steps,figure,timeline,kbd,search,code,footnotes,progress,embed,banner,filetree,details,faq,params,linkcards,quote,gallery,pricing,subscribe,loading,figure-svg" | split: "," -%}
+{%- assign mt_all_components = "callout,badge,hero,cta,card,tabs,code-copy,nav,sidebar,page-actions,pagination,theme-toggle,breadcrumb,toc,accordion,steps,figure,timeline,kbd,search,code,footnotes,progress,embed,banner,filetree,details,faq,params,linkcards,quote,gallery,pricing,subscribe,split,loading,figure-svg,lists,reveal" | split: "," -%}
 {%- comment -%}Sass partials by context (components/<group>/_<name>.scss). Core: always in assets/css/modootoday.css.
   Section sheets: assets/css/modootoday/<group>/<name>.css, linked when a page's sections: use c (c:sheet).
   Context sheets: assets/css/modootoday/<name>.css, linked by layout front matter mt_sheets (doc; blog layouts also get assets/css/modootoday-blog.css).{%- endcomment -%}
-{%- assign mt_core_partials = "core/inline/callout,core/inline/badge,core/inline/kbd,core/inline/figure,core/inline/code-copy,core/inline/hero,core/inline/cta,core/inline/code,core/inline/footnotes,core/inline/progress,core/inline/embed,core/chrome/nav,core/chrome/theme-toggle,core/chrome/breadcrumb,core/chrome/pagination,core/chrome/banner" | split: "," -%}
-{%- assign mt_section_sheets = "cta:showcase/cta,features:showcase/card,linkcards:showcase/linkcards,quote:showcase/quote,gallery:showcase/gallery,pricing:showcase/pricing,subscribe:showcase/subscribe,tabs:structure/tabs,accordion:structure/accordion,steps:structure/steps,timeline:structure/timeline,filetree:structure/filetree,details:structure/details,faq:structure/faq,params:structure/params" | split: "," -%}
-{%- assign mt_context_sheets = "doc:sidebar|toc|page-actions,search:search,loading:loading,figure:figure-svg" | split: "," -%}
+{%- assign mt_core_partials = "core/inline/callout,core/inline/badge,core/inline/kbd,core/inline/figure,core/inline/code-copy,core/inline/hero,core/inline/reveal,core/inline/cta,core/inline/code,core/inline/footnotes,core/inline/progress,core/inline/embed,core/chrome/nav,core/chrome/theme-toggle,core/chrome/breadcrumb,core/chrome/pagination,core/chrome/banner" | split: "," -%}
+{%- assign mt_section_sheets = "cta:showcase/cta,features:showcase/card,linkcards:showcase/linkcards,quote:showcase/quote,gallery:showcase/gallery,pricing:showcase/pricing,subscribe:showcase/subscribe,tabs:structure/tabs,accordion:structure/accordion,steps:structure/steps,timeline:structure/timeline,filetree:structure/filetree,details:structure/details,faq:structure/faq,params:structure/params,split:structure/split" | split: "," -%}
+{%- assign mt_context_sheets = "doc:sidebar|toc|page-actions,search:search,loading:loading,figure:figure-svg,lists:lists" | split: "," -%}
 {%- assign mt_components = mt_all_components -%}
 {%- if mt.components -%}{%- assign mt_components = mt.components -%}{%- endif -%}
 {%- assign mt_color_scheme = "auto" -%}

data/_includes/modootoday/head-meta.html

@@ -3,6 +3,7 @@ SEO and theme-init head tags (needs modootoday/config.html first). Liquid only,
   site.modootoday.seo        false drops canonical, hreflang and Open Graph (use jekyll-seo-tag instead)
   site.modootoday.hreflang   true keeps the hreflang alternates when seo is false (default: follows seo)
   site.modootoday.languages  list of language codes for hreflang, e.g. [en, ko]; site.lang is unprefixed, others live under /<lang>/
+                             (a page with front matter ref: links the pages sharing that ref instead, whatever their paths)
   site.modootoday.feed       true adds the Atom link to /feed.xml, or /<lang>/feed.xml when that page exists (jekyll-feed or layout: feed)
   site.modootoday.csp        strict loads the pre-paint theme script from a file instead of inline
   site.modootoday.favicon    brand links the theme's modootoday mark (SVG, 32px PNG, apple-touch); a path links your own icon
@@ -39,7 +40,8 @@ SEO and theme-init head tags (needs modootoday/config.html first). Liquid only,
 {%- if _mt_plang != _mt_def -%}{%- assign _mt_pre = "/" | append: _mt_plang -%}{%- assign _mt_base = page.url | remove_first: _mt_pre -%}{%- endif -%}
 {%- unless mt_page_urls -%}{%- assign mt_page_urls = site.pages | map: "url" | join: "|" | prepend: "|" | append: "|" -%}{%- endunless -%}
 {%- for _l in _mt_langs -%}
-{%- if _l == _mt_def -%}{%- assign _mt_alt = _mt_base -%}{%- else -%}{%- assign _mt_alt = "/" | append: _l | append: _mt_base -%}{%- endif -%}
+{%- if page.ref -%}{%- include modootoday/ref-url.html ref=page.ref lang=_l exact=true -%}{%- assign _mt_alt = mt_ref_url | default: "/-none-/" -%}
+{%- elsif _l == _mt_def -%}{%- assign _mt_alt = _mt_base -%}{%- else -%}{%- assign _mt_alt = "/" | append: _l | append: _mt_base -%}{%- endif -%}
 {%- assign _mt_key = "|" | append: _mt_alt | append: "|" -%}
 {%- if mt_page_urls contains _mt_key %}
 <link rel="alternate" hreflang="{{ _l }}" href="{{ _mt_alt | absolute_url }}">
@@ -68,7 +70,7 @@ SEO and theme-init head tags (needs modootoday/config.html first). Liquid only,
 <meta property="og:description" content="{{ page.description | default: site.description | strip_html | normalize_whitespace | escape }}">
 {%- endif -%}
 {%- if site.title %}
-<meta property="og:site_name" content="{{ site.title | escape }}">
+<meta property="og:site_name" content="{{ mt_site_title | default: site.title | escape }}">
 {%- endif -%}
 {%- if site.url %}
 <meta property="og:url" content="{{ _mt_url }}">

data/_includes/modootoday/jsonld/breadcrumb.html

@@ -4,7 +4,7 @@ is a page, then the page. Not printed on the home page or a /<lang>/ home.{%- en
 {%- if _ld_segs[1] == _ld_lang and _ld_lang != site.lang -%}{%- assign _ld_home = "/" | append: _ld_lang | append: "/" -%}{%- assign _ld_start = 1 -%}{%- endif -%}
 {%- if page.url != _ld_home and page.url != "/" -%}
 {%- assign _ld_hp = site.pages | where: "url", _ld_home | first -%}{%- assign _ld_n = 1 -%}
-,{"@type":"BreadcrumbList","@id":{{ _ld_url | append: "#breadcrumb" | jsonify }},"itemListElement":[{"@type":"ListItem","position":1,"name":{{ _ld_hp.short_title | default: _ld_hp.title | default: site.title | default: "Home" | strip_html | jsonify }},"item":{{ _ld_home | absolute_url | jsonify }}}
+,{"@type":"BreadcrumbList","@id":{{ _ld_url | append: "#breadcrumb" | jsonify }},"itemListElement":[{"@type":"ListItem","position":1,"name":{{ _ld_hp.short_title | default: _ld_hp.title | default: mt_site_title | default: site.title | default: "Home" | strip_html | jsonify }},"item":{{ _ld_home | absolute_url | jsonify }}}
 {%- assign _ld_acc = _ld_home -%}
 {%- for _s in _ld_segs offset: 1 -%}{%- if forloop.index > _ld_start and _s != "" and _s != "index.html" -%}
 {%- assign _ld_acc = _ld_acc | append: _s | append: "/" -%}

data/_includes/modootoday/jsonld/publisher.html

@@ -3,7 +3,7 @@ Defaults: Organization named site.title; logo from publisher.logo, or the brand
 {%- assign _ld_p = _ld.publisher -%}
 {%- assign _ld_pt = _ld_p.type | default: "Organization" -%}
 {%- assign _ld_pl = _ld_p.logo -%}{%- if _ld_pl == nil and site.modootoday.logo == "brand" -%}{%- assign _ld_pl = "/assets/modootoday/apple-touch-icon.png" -%}{%- elsif _ld_pl == nil -%}{%- assign _ld_pl = site.modootoday.logo -%}{%- endif -%}
-,{"@type":{{ _ld_pt | jsonify }},"@id":{{ _ld_root | append: "#publisher" | jsonify }},"name":{{ _ld_p.name | default: site.title | default: _ld_title | jsonify }},"url":{{ _ld_p.url | default: "/" | absolute_url | jsonify }}
+,{"@type":{{ _ld_pt | jsonify }},"@id":{{ _ld_root | append: "#publisher" | jsonify }},"name":{{ _ld_p.name | default: mt_site_title | default: site.title | default: _ld_title | jsonify }},"url":{{ _ld_p.url | default: "/" | absolute_url | jsonify }}
 {%- if _ld_pl -%}{%- assign _ld_plu = _ld_pl | absolute_url -%}
 {%- if _ld_pt == "Person" %},"image":{{ _ld_plu | jsonify }}{% else %},"logo":{"@type":"ImageObject","url":{{ _ld_plu | jsonify }}}{% endif -%}
 {%- endif -%}

data/_includes/modootoday/jsonld/website.html

@@ -1,5 +1,5 @@
 {%- comment -%}WebSite node (#website). site.modootoday.schema.search_url (a URL with {search_term_string}) adds a SearchAction.{%- endcomment -%}
-{"@type":"WebSite","@id":{{ _ld_root | append: "#website" | jsonify }},"url":{{ _ld_root | jsonify }},"name":{{ site.title | default: _ld_title | jsonify }}
+{"@type":"WebSite","@id":{{ _ld_root | append: "#website" | jsonify }},"url":{{ _ld_root | jsonify }},"name":{{ mt_site_title | default: site.title | default: _ld_title | jsonify }}
 {%- if site.description %},"description":{{ site.description | strip_html | normalize_whitespace | jsonify }}{% endif -%}
 ,"inLanguage":{{ site.lang | default: "en" | jsonify }},"publisher":{"@id":{{ _ld_root | append: "#publisher" | jsonify }}}
 {%- if _ld.search_url -%}

data/_includes/modootoday/lang-switch.html

@@ -1,5 +1,6 @@
 {%- comment -%}
-  Language switcher, built from modootoday.languages (the same alternates as the hreflang links).
+  Language switcher, built from modootoday.languages (the same alternates as the hreflang links; pages with ref: use the
+  page sharing that ref in each language).
   Each language links to this page's translation when it exists, else to that language's home page.
   Opt in with modootoday.language_switcher: header | footer, or include it in your own footer-custom.html.
   Label text: language (the language's own name) and languages.label (modootoday/i18n.html: site _data/i18n, theme catalog, English).
@@ -16,7 +17,8 @@
 {%- unless mt_page_urls -%}{%- assign mt_page_urls = site.pages | map: "url" | join: "|" | prepend: "|" | append: "|" -%}{%- endunless -%}
 {%- capture _ls_items -%}
 {%- for _l in site.modootoday.languages -%}
-{%- if _l == _ls_def -%}{%- assign _ls_alt = _ls_base -%}{%- else -%}{%- assign _ls_alt = "/" | append: _l | append: _ls_base -%}{%- endif -%}
+{%- if page.ref -%}{%- include modootoday/ref-url.html ref=page.ref lang=_l exact=true -%}{%- assign _ls_alt = mt_ref_url | default: "/-none-/" -%}
+{%- elsif _l == _ls_def -%}{%- assign _ls_alt = _ls_base -%}{%- else -%}{%- assign _ls_alt = "/" | append: _l | append: _ls_base -%}{%- endif -%}
 {%- assign _ls_key = "|" | append: _ls_alt | append: "|" -%}
 {%- unless mt_page_urls contains _ls_key -%}{%- if _l == _ls_def -%}{%- assign _ls_alt = "/" -%}{%- else -%}{%- assign _ls_alt = "/" | append: _l | append: "/" -%}{%- endif -%}{%- endunless -%}
 {%- capture _ls_name -%}{%- include modootoday/i18n/name.html code=_l -%}{%- endcapture -%}{%- assign _ls_name = site.data.i18n[_l].language | default: _ls_name -%}

data/_includes/modootoday/link.html

@@ -1,3 +1,6 @@
 {%- comment -%}URL for include.url: full URLs as they are, site paths through relative_url (absolute=true: absolute_url).
-  A bare "#" sample link stays "#" (absolute=true: this page's absolute URL, for JSON-LD).{%- endcomment -%}
-{%- if include.url == "#" and include.absolute -%}{{ page.url | absolute_url }}{%- elsif include.url == "#" or include.url contains "://" or include.url contains "mailto:" or include.url contains "tel:" -%}{{ include.url }}{%- elsif include.absolute -%}{{ include.url | absolute_url }}{%- else -%}{{ include.url | relative_url }}{%- endif -%}
+  A bare "#" sample link stays "#" (absolute=true: this page's absolute URL, for JSON-LD).
+  include.ref instead of url: the page with that front matter ref: in this page's language (lang= to choose another),
+  else the default-language one (modootoday/ref-url.html); modootoday-check rejects a ref no page defines.{%- endcomment -%}
+{%- if include.ref -%}{%- include modootoday/ref-url.html ref=include.ref lang=include.lang -%}{%- if include.absolute -%}{{ mt_ref_url | absolute_url }}{%- else -%}{{ mt_ref_url | relative_url }}{%- endif -%}
+{%- elsif include.url == "#" and include.absolute -%}{{ page.url | absolute_url }}{%- elsif include.url == "#" or include.url contains "://" or include.url contains "mailto:" or include.url contains "tel:" -%}{{ include.url }}{%- elsif include.absolute -%}{{ include.url | absolute_url }}{%- else -%}{{ include.url | relative_url }}{%- endif -%}

data/_includes/modootoday/markdown/lists.html

@@ -0,0 +1,26 @@
+{%- comment -%}
+md-components v1 — optional list styles (site.modootoday.lists; the lists sheet styles them). Prints include.html with:
+  link_chips: true    a list whose every item is one link and nothing else → ul.mt-chips (a row of chips)
+  titled_items: true  an item that starts with **Title**: → li > strong.mt-item-title + span.mt-item-sep, then the text
+Applied to the hero, to sections without c: and to pages without sections; component sections keep their own lists.
+{%- endcomment -%}
+{%- assign _lh = include.html -%}
+{%- if site.modootoday.lists.titled_items == true and _lh contains "<li><strong>" -%}
+{%- assign _lp = _lh | split: "<li><strong>" -%}
+{%- capture _lh -%}{{ _lp[0] }}{%- for _x in _lp offset:1 -%}
+{%- assign _t = _x | split: "</strong>: " -%}{%- assign _tt = _t[0] -%}
+{%- if _t.size > 1 -%}{%- unless _tt contains "</li>" or _tt contains "<li" -%}{%- assign _ok = true -%}{%- else -%}{%- assign _ok = false -%}{%- endunless -%}{%- else -%}{%- assign _ok = false -%}{%- endif -%}
+{%- if _ok -%}<li><strong class="mt-item-title">{{ _tt }}</strong><span class="mt-item-sep">: </span>{{ _x | remove_first: _tt | remove_first: "</strong>: " }}{%- else -%}<li><strong>{{ _x }}{%- endif -%}
+{%- endfor -%}{%- endcapture -%}
+{%- endif -%}
+{%- if site.modootoday.lists.link_chips == true and _lh contains "<ul>" -%}
+{%- assign _nl = "
+" -%}{%- assign _us = "<ul>" | append: _nl -%}
+{%- assign _lp = _lh | split: _us -%}
+{%- capture _lh -%}{{ _lp[0] }}{%- for _x in _lp offset:1 -%}
+{%- assign _in = _x | split: "</ul>" | first -%}
+{%- assign _n1 = _in | split: "<li>" | size -%}{%- assign _n2 = _in | split: "<li><a " | size -%}{%- assign _n3 = _in | split: "</a></li>" | size -%}{%- assign _n4 = _in | split: "<a " | size -%}
+{%- if _n1 > 1 and _n1 == _n2 and _n1 == _n3 and _n1 == _n4 -%}<ul class="mt-chips">{{ _nl }}{%- else -%}{{ _us }}{%- endif -%}{{ _x }}
+{%- endfor -%}{%- endcapture -%}
+{%- endif -%}
+{{- _lh -}}

data/_includes/modootoday/markdown/sections.html

@@ -7,7 +7,15 @@ Only top-level h2 split: kramdown prints them at column 0 ("\n<h2 "), nested one
 alert) are indented and stay inside their section. modootoday-check rejects nested/setext/indented ##.
 Item: "name" or {c: component, name: key, ...params}. c: tabs → data-tabs, c: cta → (on the section, or on its [data-mt-result] element when it holds one, so a showcase box only frames the result).
 visual: <name> on an item (or include.hero.visual for the hero) appends the site's
-_includes/sections/<name>.html at the end of that section, called with section=<item> (hero=<hero>).
+_includes/sections/<name>.html at the end of that section, called with section=<item> (hero=<hero>); every other key
+on the item (e.g. scene: 2) reaches the include as include.section.<key>.
+c: split wraps the section in div.mt-section-in > div.mt-section-body (h2 and text) + div.mt-section-visual (the visual
+include): two columns from 48rem (side: start|end puts the visual first or last, ratio: "1:1"|"5:7" text:visual), one below.
+Only split gets the wrappers, so child selectors of the other components keep working.
+decor: <name> (item or hero) adds _includes/sections/<name>.html in div.mt-section-decor[aria-hidden=true], placed in
+the section's top end corner (section gets .mt-has-decor); for ornaments only, never content.
+The hero's first p after the h1 gets .mt-hero-lead; hero checks: true adds .mt-hero-checks (its first ul is a ✓ row, lists sheet).
+site.modootoday.lists (link_chips, titled_items) runs markdown/lists.html on the hero, plain sections and section-less pages.
 modootoday-check fails when the item count differs from the h2 count.
 {%- endcomment -%}
 {%- assign _lang = include.lang | default: site.lang | default: "en" -%}
@@ -23,21 +31,27 @@ modootoday-check fails when the item count differs from the h2 count.
 {%- if _fparts.size > 1 -%}{%- assign _notes = include.content | remove_first: _main | strip -%}{%- endif -%}
 {%- assign _parts = _main | prepend: _nl | split: _sep -%}
 {%- assign mt_c_transforms = "|filetree|linkcards|details|faq|params|quote|gallery|pricing|subscribe|" -%}
-{%- assign _p0 = _parts[0] -%}{%- capture _hero %}{% include modootoday/actions.html html=_p0 %}{% endcapture -%}
-<section class="mt-hero">{{ _hero }}{% if include.hero.visual %}{% include sections/{{ include.hero.visual }}.html section=include.hero %}{% endif %}</section>
+{%- assign _p0 = _parts[0] -%}{%- if site.modootoday.lists -%}{%- capture _p0 %}{% include modootoday/markdown/lists.html html=_p0 %}{% endcapture -%}{%- endif -%}
+{%- capture _hero %}{% include modootoday/actions.html html=_p0 %}{% endcapture -%}{%- assign _hl = "</h1>" | append: _nl | append: _nl -%}{%- assign _hlp = _hl | append: "<p>" -%}{%- assign _hlc = _hl | append: '<p class="mt-hero-lead">' -%}{%- assign _hero = _hero | replace_first: _hlp, _hlc -%}
+<section class="mt-hero{% if include.hero.checks == true %} mt-hero-checks{% endif %}{% if include.hero.decor %} mt-has-decor{% endif %}{% if include.hero.reveal == true %} mt-reveal{% endif %}">{{ _hero }}{% if include.hero.visual %}{% include sections/{{ include.hero.visual }}.html section=include.hero %}{% endif %}{% if include.hero.decor %}<div class="mt-section-decor" aria-hidden="true">{% include sections/{{ include.hero.decor }}.html section=include.hero %}</div>{% endif %}</section>
 {%- for _p in _parts offset:1 -%}
 {%- assign _s = include.sections[forloop.index0] -%}
 {%- if _s.name or _s.c -%}{%- assign _n = _s.name -%}{%- assign _cc = _s.c -%}{%- else -%}{%- assign _n = _s -%}{%- assign _cc = nil -%}{%- endif -%}
 {%- assign _body = _p -%}
+{%- if site.modootoday.lists and _cc == nil -%}{%- capture _body %}{% include modootoday/markdown/lists.html html=_p %}{% endcapture -%}{%- endif -%}
 {%- if _cc == 'cta' -%}{%- capture _body %}{% include modootoday/actions.html html=_p %}{% endcapture -%}{%- endif -%}
 {%- if _cc == 'features' -%}{%- assign _body = _body | replace: "</strong> — ", "</strong> " | replace: "</strong> – ", "</strong> " | replace: "</strong> - ", "</strong> " -%}{%- endif -%}
 {%- if _cc and mt_c_transforms contains _cc -%}{%- capture _body %}{% include modootoday/markdown/c/{{ _cc }}.html html=_body s=_s i=forloop.index id=_n %}{% endcapture -%}{%- endif -%}
-<section class="mt-section{% if _cc %} mt-c-{{ _cc }}{% endif %}{% if _cc == 'cta' %}{% unless _body contains 'data-mt-result' %} mt-cta{% endunless %}{% endif %}{% if _s.cols %} mt-cols-{{ _s.cols }}{% endif %}" data-section="{{ _n | default: forloop.index0 }}"{% if _cc %} data-c="{{ _cc }}"{% endif %}{% if _cc == 'tabs' %} data-tabs data-tabs-label="{{ _tl }}"{% endif %}>
-<h2 {{ _body }}{% if _s.visual %}{% include sections/{{ _s.visual }}.html section=_s %}{% endif %}</section>
+<section class="mt-section{% if _cc %} mt-c-{{ _cc }}{% endif %}{% if _cc == 'cta' %}{% unless _body contains 'data-mt-result' %} mt-cta{% endunless %}{% endif %}{% if _s.cols %} mt-cols-{{ _s.cols }}{% endif %}{% if _s.decor %} mt-has-decor{% endif %}{% if _s.reveal == true %} mt-reveal{% endif %}{% if _cc == 'features' and _s.badge == 'bottom' %} mt-badge-bottom{% endif %}{% if _cc == 'split' %}{% if _s.side == 'start' %} mt-split-start{% endif %}{% if _s.ratio == '5:7' %} mt-split-5-7{% endif %}{% endif %}" data-section="{{ _n | default: forloop.index0 }}"{% if _cc %} data-c="{{ _cc }}"{% endif %}{% if _cc == 'tabs' %} data-tabs data-tabs-label="{{ _tl }}"{% endif %}>
+{%- if _cc == 'split' %}
+<div class="mt-section-in"><div class="mt-section-body"><h2 {{ _body }}</div>{% if _s.visual %}<div class="mt-section-visual">{% include sections/{{ _s.visual }}.html section=_s %}</div>{% endif %}</div>{% if _s.decor %}<div class="mt-section-decor" aria-hidden="true">{% include sections/{{ _s.decor }}.html section=_s %}</div>{% endif %}</section>
+{%- else %}
+<h2 {{ _body }}{% if _s.visual %}{% include sections/{{ _s.visual }}.html section=_s %}{% endif %}{% if _s.decor %}<div class="mt-section-decor" aria-hidden="true">{% include sections/{{ _s.decor }}.html section=_s %}</div>{% endif %}</section>
+{%- endif -%}
 {%- endfor -%}
 {%- if _notes != "" %}
 <div class="mt-endnotes">{{ _notes }}</div>
 {%- endif -%}
 {%- else -%}
-<div class="mt-prose">{{ include.content }}</div>
+{%- if site.modootoday.lists -%}<div class="mt-prose">{% include modootoday/markdown/lists.html html=include.content %}</div>{%- else -%}<div class="mt-prose">{{ include.content }}</div>{%- endif -%}
 {%- endif -%}

data/_includes/modootoday/ref-url.html

@@ -0,0 +1,12 @@
+{%- comment -%}Sets mt_ref_url to the URL (site path, before relative_url) of the page whose front matter ref: is include.ref,
+in include.lang (default: this page's lang, then site.lang). Without one in that language it falls back to the
+default-language page, unless include.exact is true; mt_ref_url is nil when nothing matches.
+A page's language is its lang: (front matter or defaults), else site.lang.{%- endcomment -%}
+{%- assign mt_ref_url = nil -%}
+{%- assign _rf_def = site.lang | default: "en" -%}
+{%- assign _rf_lang = include.lang | default: page.lang | default: _rf_def -%}
+{%- assign _rf_pages = site.pages | where: "ref", include.ref -%}
+{%- for _rf_p in _rf_pages -%}{%- assign _rf_l = _rf_p.lang | default: _rf_def -%}{%- if _rf_l == _rf_lang -%}{%- assign mt_ref_url = _rf_p.url -%}{%- break -%}{%- endif -%}{%- endfor -%}
+{%- unless mt_ref_url or include.exact -%}
+{%- for _rf_p in _rf_pages -%}{%- assign _rf_l = _rf_p.lang | default: _rf_def -%}{%- if _rf_l == _rf_def -%}{%- assign mt_ref_url = _rf_p.url -%}{%- break -%}{%- endif -%}{%- endfor -%}
+{%- endunless -%}

data/_includes/modootoday/stylesheets.html

@@ -10,6 +10,7 @@ Stylesheet links (needs modootoday/config.html first). Sets mt_page_c ("|tabs|fa
 {%- if mt_components contains "search" and mt_search_index -%}{%- assign mt_page_c = mt_page_c | append: "search|" -%}{%- endif -%}
 {%- if site.modootoday.loading or content contains 'class="mt-spinner' or content contains 'class="mt-skeleton' or content contains 'class="mt-topbar' -%}{%- assign mt_page_c = mt_page_c | append: "loading|" -%}{%- endif -%}
 {%- if content contains 'class="mt-figure mt-figure-svg' -%}{%- assign mt_page_c = mt_page_c | append: "figure|" -%}{%- endif -%}
+{%- if content contains 'class="mt-hero mt-hero-checks' or content contains 'class="mt-chips"' or content contains 'class="mt-item-title"' -%}{%- assign mt_page_c = mt_page_c | append: "lists|" -%}{%- endif -%}
 {%- for _x in layout.mt_css -%}{%- assign mt_page_c = mt_page_c | append: _x | append: "|" -%}{%- endfor -%}
 {%- for _x in page.css -%}{%- assign mt_page_c = mt_page_c | append: _x | append: "|" -%}{%- endfor %}
 {%- comment -%}Blog, news and archive layouts add the separate blog sheet (both modes); front matter blog_css: true opts any page in.{%- endcomment -%}

data/_layouts/default.html

@@ -3,6 +3,8 @@
 {%- assign _lang = page.lang | default: site.lang | default: "en" -%}
 {%- include modootoday/config.html -%}
 {%- include modootoday/i18n.html lang=_lang -%}
+{%- comment -%}mt_site_title: the brand name shown in the header, <title>, og:site_name and JSON-LD; site.data.i18n[lang].site_title localises it, else site.title.{%- endcomment -%}
+{%- assign mt_site_title = site.data.i18n[_lang].site_title | default: site.title -%}
 {%- comment -%}mt_home: this language's home (/<lang>/ when that page exists), else the site root; used by the brand link and footers.{%- endcomment -%}
 {%- assign mt_home = "/" -%}{%- assign _def_lang = site.lang | default: "en" -%}
 {%- if _lang != _def_lang -%}{%- assign _lh = "/" | append: _lang | append: "/" -%}{%- assign _lhp = site.pages | where: "url", _lh | first -%}{%- if _lhp -%}{%- assign mt_home = _lh -%}{%- endif -%}{%- endif -%}
@@ -14,7 +16,7 @@
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1{% unless site.modootoday.viewport_fit == "auto" %}, viewport-fit=cover{% endunless %}">
-<title>{% if page.title %}{{ page.title }}{% if site.title %} · {{ site.title }}{% endif %}{% else %}{{ site.title }}{% endif %}</title>
+<title>{% if page.title %}{{ page.title }}{% if site.title %} · {{ mt_site_title }}{% endif %}{% else %}{{ mt_site_title }}{% endif %}</title>
 {%- if page.description or site.description %}
 <meta name="description" content="{{ page.description | default: site.description | strip_html | normalize_whitespace | escape }}">
 {%- endif %}
@@ -45,7 +47,7 @@
 {%- endif %}
 {%- assign _chrome = true -%}{%- if layout.mt_chrome == false or page.chrome == false -%}{%- assign _chrome = false -%}{%- endif -%}
 {%- if site.title and _chrome %}
-<header class="mt-header"><div class="mt-header-inner"><a class="mt-site-title{% if site.modootoday.logo %} mt-has-logo{% endif %}" href="{{ mt_home | relative_url }}">{% include modootoday/brand/logo.html %}{{ site.title }}</a>{% include modootoday/nav.html %}{% if mt_components contains "search" and mt_search_index %}<div class="mt-search" role="search" data-index="{{ '/search.json' | relative_url }}" data-lang="{{ site.lang | default: 'en' }}" hidden>{% include modootoday/brand/icon.html name="search" size=16 %}<input type="search" aria-keyshortcuts="/ Control+K Meta+K" aria-controls="mt-search-results" aria-label="{{ mt_t_search_label }}" placeholder="{{ mt_t_search_label }}"><ul class="mt-search-results" id="mt-search-results" aria-live="polite"></ul></div>{% endif %}{% if site.modootoday.language_switcher == "header" %}{% include modootoday/lang-switch.html style="menu" %}{% endif %}{% if mt_components contains "theme-toggle" and mt_theme_toggle %}<button class="mt-theme-toggle" type="button" aria-pressed="false" aria-label="{{ mt_t_theme_toggle }}" title="{{ mt_t_theme_toggle }}" hidden>{% include modootoday/brand/icon.html name="moon" %}{% include modootoday/brand/icon.html name="sun" %}</button>{% endif %}</div></header>
+<header class="mt-header"><div class="mt-header-inner"><a class="mt-site-title{% if site.modootoday.logo %} mt-has-logo{% endif %}" href="{{ mt_home | relative_url }}">{% include modootoday/brand/logo.html %}{{ mt_site_title }}</a>{% include modootoday/nav.html %}{% if mt_components contains "search" and mt_search_index %}<div class="mt-search" role="search" data-index="{{ '/search.json' | relative_url }}" data-lang="{{ site.lang | default: 'en' }}" hidden>{% include modootoday/brand/icon.html name="search" size=16 %}<input type="search" aria-keyshortcuts="/ Control+K Meta+K" aria-controls="mt-search-results" aria-label="{{ mt_t_search_label }}" placeholder="{{ mt_t_search_label }}"><ul class="mt-search-results" id="mt-search-results" aria-live="polite"></ul></div>{% endif %}{% if site.modootoday.language_switcher == "header" %}{% include modootoday/lang-switch.html style="menu" %}{% endif %}{% if mt_components contains "theme-toggle" and mt_theme_toggle %}<button class="mt-theme-toggle" type="button" aria-pressed="false" aria-label="{{ mt_t_theme_toggle }}" title="{{ mt_t_theme_toggle }}" hidden>{% include modootoday/brand/icon.html name="moon" %}{% include modootoday/brand/icon.html name="sun" %}</button>{% endif %}</div></header>
 {%- endif %}
 <main id="mt-main" tabindex="-1" class="mt-main{% if page.full_width %} mt-main-full{% endif %}{% if layout.mt_main %} {{ layout.mt_main }}{% endif %}">
 {% include modootoday/links/content.html html=content %}

data/_sass/modootoday/base/_prose.scss

@@ -8,6 +8,7 @@
   h4 { font-size: 1rem; }
   p, ul, ol, dl { margin: 0 0 1em; }
   :where(:not([class])) > li + li { margin-top: .3em; } // flow lists only: classed grid/flex lists keep item 1 aligned
+  .mt-flat-list li + li { margin-top: 0; } // opt-out on an ancestor, for unclassed Markdown lists made grid/flex (.c-body > ul)
   li > ul, li > ol { margin: .3em 0 0; }
   blockquote { margin: 1.25rem 0; padding: .25rem 1rem; color: mt(muted-foreground); border-inline-start: 3px solid mt(border); }
   blockquote > :last-child { margin-bottom: 0; }

data/_sass/modootoday/components/core/inline/_figure.scss

@@ -6,4 +6,7 @@
   :root[data-theme="dark"] .mt-figure img { filter: brightness(.85); }
   @media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) .mt-figure img { filter: brightness(.85); } }
   .mt-figure figcaption { margin-top: .6rem; color: mt(muted-foreground); font-size: .875rem; text-align: center; }
+  // .mt-illustration: figure[role=img][aria-label] for drawn scenes; .mt-illustration-tag marks it (e.g. "Illustration").
+  .mt-illustration { position: relative; margin: 0 0 1.5rem; }
+  .mt-illustration-tag { position: absolute; inset-block-start: .5rem; inset-inline-start: .5rem; padding: .125rem .5rem; border: 1px solid mt(border); border-radius: 999px; background: mt(background); color: mt(foreground); font-size: .75rem; }
 }

data/_sass/modootoday/components/core/inline/_hero.scss

@@ -5,4 +5,7 @@
   .mt-hero > p:first-of-type { font-size: 1.2rem; line-height: 1.6; color: mt(muted-foreground); max-width: 40rem; }
   .mt-section { padding: mt(space-section) 0 0; }
   .mt-section > h2:first-child { margin-top: 0; }
+  // decor: an aria-hidden ornament in the top end corner; it never takes clicks.
+  .mt-has-decor { position: relative; }
+  .mt-section-decor { position: absolute; inset-block-start: 0; inset-inline-end: 0; pointer-events: none; }
 }

data/_sass/modootoday/components/core/inline/_reveal.scss

@@ -0,0 +1,10 @@
+// Scroll reveal: .mt-reveal (reveal: true on a section or hero:). CSS only, no script.
+// It runs only where scroll-driven animations exist and the reader allows motion; otherwise content is shown as is.
+@include mt-layer(components) {
+  @supports (animation-timeline: view()) {
+    @media screen and (prefers-reduced-motion: no-preference) {
+      @keyframes mt-reveal { from { opacity: 0; translate: 0 1.5rem; } to { opacity: 1; translate: none; } }
+      .mt-reveal { animation: mt-reveal linear both; animation-timeline: view(); animation-range: entry 0% entry 60%; }
+    }
+  }
+}

data/_sass/modootoday/components/lists/_lists.scss

@@ -0,0 +1,16 @@
+// Optional list styles (lists sheet): linked only by pages with .mt-hero-checks, ul.mt-chips or .mt-item-title.
+// .mt-hero-checks: the hero's first ul is a row of ✓ chips in --mt-ok (default: the status-available colour; a site may set its own). ul.mt-chips: link-only items as 44px chips with →.
+// .mt-item-title: **Title**: items get a bold title and a muted separator.
+@include mt-layer(components) {
+  :where(:root) { --mt-ok: #{mt(status-available)}; }
+  .mt-hero-checks > ul:first-of-type, ul.mt-chips { display: flex; flex-wrap: wrap; gap: .5rem; padding: 0; list-style: none; }
+  .mt-hero-checks > ul:first-of-type > li { display: inline-flex; align-items: center; gap: .375rem; margin: 0; padding: .25rem .75rem; border: 1px solid mt(border); border-radius: 999px; }
+  .mt-hero-checks > ul:first-of-type > li::before { content: "✓" / ""; color: var(--mt-ok); font-weight: 700; }
+  ul.mt-chips > li { margin: 0; }
+  ul.mt-chips a { display: inline-flex; align-items: center; gap: .375rem; min-height: 44px; padding: 0 1rem; border: 1px solid mt(border); border-radius: 999px; color: mt(foreground); text-decoration: none; }
+  ul.mt-chips a::after { content: "→" / ""; color: mt(muted-foreground); }
+  :dir(rtl) ul.mt-chips a::after, [dir="rtl"] ul.mt-chips a::after { content: "←" / ""; }
+  ul.mt-chips a:hover { border-color: mt(primary); }
+  .mt-item-title { font-weight: 700; }
+  .mt-item-sep { color: mt(muted-foreground); }
+}

data/_sass/modootoday/components/section/showcase/_card.scss

@@ -8,6 +8,9 @@
   .mt-c-features > ul > li code { white-space: nowrap; }
   .mt-c-features > ul > li:hover { border-color: color-mix(in srgb, #{mt(primary)} 40%, #{mt(border)}); box-shadow: mt(shadow); }
   .mt-c-features > ul > li > strong:first-child { display: block; margin-bottom: .35rem; color: mt(card-foreground); font-size: 1rem; }
+  // badge: bottom: a status badge (.mt-badge) written as a direct child of the item sits at the card's bottom edge.
+  .mt-badge-bottom > ul > li:has(> .mt-badge) { position: relative; padding-block-end: calc(var(--mt-card-padding) + 2rem); }
+  .mt-badge-bottom > ul > li > .mt-badge { position: absolute; inset-block-end: var(--mt-card-padding); inset-inline-start: var(--mt-card-padding); }
   @media (min-width: 48rem) {
     .mt-cols-2 > ul { grid-template-columns: repeat(2, minmax(0, 1fr)); }
     .mt-cols-3 > ul { grid-template-columns: repeat(3, minmax(0, 1fr)); }

data/_sass/modootoday/components/section/structure/_split.scss

@@ -0,0 +1,14 @@
+// Split: c: split; text (.mt-section-body) and the visual: include (.mt-section-visual) side by side from 48rem,
+// stacked below. Grid columns follow the writing direction, so start/end flip in RTL. DOM order stays text first.
+@include mt-layer(components) {
+  .mt-section-in { display: grid; gap: 2rem; }
+  .mt-section-in > * { min-width: 0; }
+  .mt-section-body > :last-child, .mt-section-visual > :last-child { margin-bottom: 0; }
+  .mt-section-visual img, .mt-section-visual svg { display: block; max-width: 100%; height: auto; }
+  @media (min-width: 48rem) {
+    .mt-c-split > .mt-section-in { grid-template-columns: var(--mt-split-body, 1fr) var(--mt-split-visual, 1fr); align-items: center; }
+    .mt-split-5-7 { --mt-split-body: 5fr; --mt-split-visual: 7fr; }
+    .mt-split-start > .mt-section-in { grid-template-columns: var(--mt-split-visual, 1fr) var(--mt-split-body, 1fr); }
+    .mt-split-start .mt-section-visual { grid-row: 1; grid-column: 1; }
+  }
+}

data/_sass/modootoday.scss

@@ -7,6 +7,7 @@
 @import "modootoday/components/core/inline/figure";
 @import "modootoday/components/core/inline/code-copy";
 @import "modootoday/components/core/inline/hero";
+@import "modootoday/components/core/inline/reveal";
 @import "modootoday/components/core/inline/cta";
 @import "modootoday/components/section/showcase/cta";
 @import "modootoday/components/core/inline/code";
@@ -37,4 +38,5 @@
 @import "modootoday/components/section/structure/details";
 @import "modootoday/components/section/structure/faq";
 @import "modootoday/components/section/structure/params";
+@import "modootoday/components/section/structure/split";
 @import "modootoday/access";

data/assets/css/modootoday/lists.scss

@@ -0,0 +1,8 @@
+---
+# md-components v1 — jekyll-theme-modootoday optional sheet (hero check row, link chips, titled items). Linked only by pages that use it.
+---
+{%- include modootoday/config.html -%}
+$mt-css-layers: {{ mt_css_layers }};
+@import "modootoday/sheet";
+{% if mt_components contains "lists" %}@import "modootoday/components/lists/lists";
+{% endif %}

data/assets/css/modootoday/structure/split.scss

@@ -0,0 +1,7 @@
+---
+# md-components v1 — jekyll-theme-modootoday section sheet (c: split). Linked only by pages that use it.
+---
+{%- include modootoday/config.html -%}
+$mt-css-layers: {{ mt_css_layers }};
+@import "modootoday/sheet";
+@import "modootoday/components/section/structure/split";

data/i18n/glossary.yml

@@ -6,7 +6,10 @@ register:
   ko: {docs: 합니다체, ui: 해요체, labels: noun phrase}
   ja: {docs: です・ます, ui: です・ます, labels: 体言止め, table_cells: 体言止め or 常体}
 # Pages whose front matter has `noindex: true` are sample content (demo posts) and keep their genre voice.
+# Brand: the theme's visible name always carries the word for theme (the plain name is a separate service).
+# Gem, repository and code names (jekyll-theme-modootoday, modootoday-check) are not translated.
 terms:
+  - {en: modoo.today theme (brand name), ko: 모두의오늘 테마, ja: modoo.today テーマ}
   - {en: Markdown twin, ko: Markdown 버전, ja: Markdown 版, avoid: {ko: [쌍둥이, 트윈], ja: [ツイン, 双子]}}
   - {en: front matter, ko: front matter, ja: front matter, avoid: {ko: [머리말, 프런트 매터, 프론트 매터], ja: [フロントマター]}}
   - {en: breadcrumb, ko: 이동 경로, ja: パンくずリスト, avoid: {ko: [브레드크럼, 빵 부스러기], ja: [ブレッドクラム]}}

data/lib/modootoday/check/a11y/illustration.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Modootoday
+  module Check
+    # .mt-illustration (WCAG 1.1.1): a drawn scene is one image to assistive technology, so it must be
+    # <figure role="img"> with a non-empty aria-label; its children (and any .mt-illustration-tag) are not read.
+    module Illustration
+      OPEN = /<([a-z][a-z0-9]*)\b[^>]*\bclass="[^"]*\bmt-illustration\b(?!-)[^"]*"[^>]*>/i
+
+      module_function
+
+      def call(ctx)
+        Dir.glob("#{ctx.site}/**/*.html").each do |f|
+          File.read(f).gsub(%r{<pre\b.*?</pre>}m, "").scan(OPEN) do
+            tag, el = Regexp.last_match(1), Regexp.last_match(0)
+            label = el[/\baria-label="([^"]*)"/, 1].to_s.strip
+            next if tag.casecmp?("figure") && el =~ /\brole="img"/ && !label.empty?
+            ctx.errs << "#{f}: .mt-illustration must be <figure role=\"img\" aria-label=\"…\"> with a non-empty label (got #{el[0, 120]})"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/modootoday/check/cli.rb

@@ -4,7 +4,7 @@ module Modootoday
   module Check
     # Command line: usage, --help/--version, running the rule groups in order, reporting.
     module CLI
-      USAGE = "usage: modootoday-check SRC SITE [--twins] [--github-pages[=VERSION]] [--gh] [--strict] [--schema-recommended] [--i18n] [--i18n-init=LANG,...]"
+      USAGE = "usage: modootoday-check SRC SITE [--twins] [--github-pages[=VERSION]] [--gh] [--strict] [--schema-recommended] [--i18n] [--i18n-pages] [--i18n-init=LANG,...]"
       # Single source for --help and the README "Commands" table (script/readme-commands, test/project/readme_test.rb).
       OPTIONS = [
         ["SRC SITE", "always: front matter, forbidden syntax, alerts, fence info strings, `status:`/`tag:`/`kbd:` values (`since:` is rejected), `sections:` count, `_data/i18n/<lang>.yml` keys against the default language and translated pages against default-language pages, `_data/components.yml` (keys, slot contract counts per section, `parts` against `api.md` and the built HTML), Sass/CSS rules, unconverted markers in the build, schema.org JSON-LD in the build (valid JSON, vocabulary, required properties per type, absolute URLs, ISO 8601 dates, one graph per page, agreement with Open Graph)"],
@@ -13,6 +13,7 @@ module Modootoday
         ["--schema-recommended", "also warn about schema.org properties Google Search recommends (author, image, dates, ...) that a JSON-LD node lacks"],
         ["--strict", "warnings fail the run"],
         ["--i18n", "`_data/i18n/<lang>.yml` against the theme registry (`i18n/en.yml` in the gem): unknown keys, `%{name}` placeholder mismatches, and pages marked `translation: pending`"],
+        ["--i18n-pages", "warn about default-language pages with no translation in a `modootoday.full_languages` language (the page with the same `ref:`, else the same path under `<lang>/`); with `--strict` they fail"],
         ["--i18n-init=LANG,...", "copy the theme's catalogs (`i18n/<lang>.yml`, 23 languages) into `SRC/_data/i18n/` as a starting point for overrides (optional; the theme already uses them), and list keys an existing catalog lacks"],
         ["--gh", "also render each page with `gh api markdown` (network, `gh` login)"],
         ["--help, -h", "print usage and options (`--help=markdown` prints the README table)"],
@@ -20,7 +21,7 @@ module Modootoday
       ].freeze
       # Rule groups in report order.
       RULES = [Registry, SiteConfig.method(:source_mode), Pages, Layouts, I18n, Registry.method(:i18n_keys), BuiltParts,
-               BuildOutput.method(:residue), NewWindow.method(:built), StructuredData, Stylesheets, BuildOutput.method(:css), SiteConfig, Renderers, Blog, GithubPages, Twins, GhRender].freeze
+               BuildOutput.method(:residue), NewWindow.method(:built), Illustration, StructuredData, Stylesheets, BuildOutput.method(:css), SiteConfig, Renderers, Blog, GithubPages, Twins, GhRender].freeze
 
       module_function
 

data/lib/modootoday/check/component_rules.rb

@@ -3,7 +3,7 @@
 module Modootoday
   module Check
     # Values the transforms need (Rule 2b): inline `file:`, `progress:`, `embed:` code spans, and per-section
-    # content rules for c: gallery, quote, pricing and subscribe that slot counts cannot express.
+    # content rules for c: gallery, quote, pricing, split and subscribe that slot counts cannot express.
     module ComponentRules
       SKELETONS = %w[text card image avatar row].freeze
 
@@ -43,6 +43,8 @@ module Modootoday
           n = m.scan(/^###(?: |$)/).size
           rec = s["recommended"]
           errs << "#{w}: recommended: must be a plan number from 1 to #{n}" if s.key?("recommended") && !(rec.is_a?(Integer) && rec.between?(1, n))
+        when "split"
+          errs << "#{w}: needs visual: <name> (the _includes/sections/<name>.html shown beside the text)" unless s["visual"].is_a?(String) && !s["visual"].strip.empty?
         when "subscribe"
           act = ctx.mtc.is_a?(Hash) && ctx.mtc.dig("subscribe", "action")
           ctx.warns << "#{w}: no form is shown until _config.yml sets modootoday.subscribe.action" unless act

data/lib/modootoday/check/i18n.rb

@@ -32,6 +32,49 @@ module Modootoday
         init(ctx) if ctx.argv.any? { |a| a.start_with?("--i18n-init") }
         follow_default(ctx)
         registry(ctx) if ctx.option?("--i18n") && File.exist?("#{THEME}/en.yml")
+        refs(ctx)
+        pages(ctx) if ctx.option?("--i18n-pages")
+      end
+
+      # Each page as [rel path, front matter, language]: lang: from front matter, else the /<lang>/ folder
+      # when that code is in modootoday.languages, else the default language (site lang).
+      def page_index(ctx)
+        langs = Array(ctx.mtc["languages"]).map(&:to_s)
+        default = ctx.site_cfg["lang"].to_s.empty? ? "en" : ctx.site_cfg["lang"].to_s
+        ctx.mds.map do |f|
+          r = ctx.rel(f)
+          fm = (Markdown.fm(File.read(f)) rescue {}) || {}
+          dir = r.split("/").first
+          [r, fm, (fm["lang"] || (langs.include?(dir) && r.include?("/") ? dir : default)).to_s]
+        end
+      end
+
+      # {% include modootoday/link.html ref="x" %} needs a page with front matter ref: x.
+      def refs(ctx)
+        files = (ctx.mds + Dir.glob("#{ctx.src}/{_includes,_layouts}/**/*.html")).reject { |f| f.include?("/_site/") }
+        uses = files.flat_map { |f| Markdown.strip_fences(File.read(f)).gsub(/`[^`\n]*`/, "").scan(/\{%-?\s*include\s+modootoday\/link\.html\b[^%]*\bref=["']([^"']+)["']/).flatten.map { |x| [ctx.rel(f), x] } }
+        return if uses.empty?
+        known = page_index(ctx).map { |_, fm, _| fm["ref"].to_s }.reject(&:empty?)
+        uses.each { |r, x| ctx.errs << "#{r}: link.html ref=\"#{x}\": no page has front matter ref: #{x}" unless known.include?(x) }
+      end
+
+      # --i18n-pages: every default-language page has a translation in each modootoday.full_languages language
+      # (the page with the same ref:, or without ref: the same path under <lang>/). Warnings; --strict fails.
+      def pages(ctx)
+        full = Array(ctx.mtc["full_languages"]).map(&:to_s)
+        default = ctx.site_cfg["lang"].to_s.empty? ? "en" : ctx.site_cfg["lang"].to_s
+        return ctx.warns << "--i18n-pages: set modootoday.full_languages to the languages that translate every page" if full.empty?
+        idx = page_index(ctx)
+        have = idx.to_h { |r, fm, l| [[l, fm["ref"] ? "ref:#{fm['ref']}" : r], true] }
+        idx.each do |r, fm, l|
+          next unless l == default && fm["layout"] != "twin"
+          full.each do |fl|
+            next if fl == default
+            key = fm["ref"] ? "ref:#{fm['ref']}" : "#{fl}/#{r}"
+            next if have[[fl, key]]
+            ctx.warns << "#{r}: no #{fl} page (#{fm['ref'] ? "ref: #{fm['ref']}" : "#{fl}/#{r}"}); #{fl} is in modootoday.full_languages"
+          end
+        end
       end
 
       def init(ctx)

data/lib/modootoday/check/page_sections.rb

@@ -22,18 +22,23 @@ module Modootoday
         components(ctx, r, secs, sec_md) if ctx.comps
         hero = meta["hero"]
         errs << "#{r}: hero: must be a map such as {visual: name}" if hero && !hero.is_a?(Hash)
+        errs << "#{r}: hero.checks must be true or false" if hero.is_a?(Hash) && hero.key?("checks") && ![true, false].include?(hero["checks"])
         visuals(ctx, r, secs, hero.is_a?(Hash) ? hero : nil)
       end
 
-      # visual: <name> on a section item or on hero: needs _includes/sections/<name>.html in the site or the theme (showcase).
+      # reveal: is a boolean. visual: <name> and decor: <name> on a section item or on hero: needs _includes/sections/<name>.html in the site or the theme (showcase).
       def visuals(ctx, r, secs, hero)
         items = secs.each_with_index.map { |s, i| [s, "sections[#{i}]"] }
         items << [hero, "hero"] if hero
         items.each do |s, where|
-          next unless s.is_a?(Hash) && s.key?("visual")
-          v = s["visual"].to_s
-          next ctx.errs << "#{r}: #{where}.visual must be an include name [a-z0-9_-] (got #{s['visual'].inspect})" unless v =~ /\A[a-z0-9][a-z0-9_-]*\z/
-          ctx.errs << "#{r}: #{where}.visual: _includes/sections/#{v}.html not found" unless [ctx.src, THEME].any? { |d| File.exist?(File.join(d, "_includes/sections/#{v}.html")) }
+          next unless s.is_a?(Hash)
+          ctx.errs << "#{r}: #{where}.reveal must be true or false" if s.key?("reveal") && ![true, false].include?(s["reveal"])
+          %w[visual decor].each do |key|
+            next unless s.key?(key)
+            v = s[key].to_s
+            next ctx.errs << "#{r}: #{where}.#{key} must be an include name [a-z0-9_-] (got #{s[key].inspect})" unless v =~ /\A[a-z0-9][a-z0-9_-]*\z/
+            ctx.errs << "#{r}: #{where}.#{key}: _includes/sections/#{v}.html not found" unless [ctx.src, THEME].any? { |d| File.exist?(File.join(d, "_includes/sections/#{v}.html")) }
+          end
         end
       end
 
@@ -57,7 +62,9 @@ module Modootoday
           params = spec["params"] || {}
           Slots.check_section(errs, r, i, s["c"], spec["slots"], sec_md[i])
           (ctx.part_uses[s["c"]] ||= []) << r if spec.is_a?(Hash) && spec["parts"].is_a?(Array)
-          (s.keys - %w[c name visual]).each do |k|
+          (s.keys - %w[c name visual decor reveal]).each do |k|
+            # with visual:, other keys are the visual include's own params (include.section.<key>)
+            next if !params.key?(k) && s.key?("visual")
             next errs << "#{r}: sections[#{i}] #{s['c']}: unknown param '#{k}'" unless params.key?(k)
             allowed = params[k].is_a?(Hash) && params[k]["allowed"]
             errs << "#{r}: sections[#{i}] #{s['c']}.#{k}=#{s[k].inspect} not in #{allowed.inspect}" if allowed && !allowed.include?(s[k])

data/lib/modootoday/check/page_syntax.rb

@@ -52,13 +52,16 @@ module Modootoday
 
       # Tool-generated region markers on their own line, e.g. <!-- spec:toc:begin --> / <!-- spec:toc:end -->
       MARKER = /^[ \t]*<!--[ \t]*[a-z][a-z0-9-]*(?::[a-z0-9._-]+)*:(?:begin|end)[ \t]*-->[ \t]*$/
-      # specfold generated values, own-line or inline, one line each: <!-- spec:count -->12<!-- /spec:count -->
-      SPEC = %r{<!--[ \t]*/?spec:[a-z0-9._-]+(?::[a-z0-9._-]+)*[ \t]*-->}
+      # specfold generated values, own-line or inline, one line each: <!-- spec:count -->12<!-- /spec:count -->.
+      # Arguments may follow the name after a space (<!-- spec:count rows="All commands" -->) up to the closing -->;
+      # they stay on one line and contain no `>`, `--` or `##` (also inside quotes).
+      SPEC = %r{<!--[ \t]*/?spec:[a-z0-9._-]+(?::[a-z0-9._-]+)*(?:[ \t]+(?:(?!--|\#\#)[^>\n])*)?-->}
 
       # 1c. forbidden syntax outside code
       def forbidden(ctx, f, code, html_free)
         r = ctx.rel(f)
-        ctx.errs << "#{r}: HTML comment <!-- --> (hidden on GitHub, emitted by kramdown); remove it" if code.gsub(MARKER, "").gsub(SPEC, "").include?("<!--")
+        left = code.gsub(MARKER, "").gsub(SPEC, "")[/<!--[^\n]{0,60}/]
+        ctx.errs << "#{r}: HTML comment <!-- --> (hidden on GitHub, emitted by kramdown); remove it (first: `#{left.strip}`)" if left
         html_free.each_line.with_index(1) do |l, n|
           linkless = l.gsub(/\]\([^)]*\)/, "]()").gsub(/<(https?:|mailto:)[^>]*>|<[^@\s>]+@[^>\s]+>/, "<>").sub(/^ {0,3}\[[^\]]+\]:\s*\S+/, "")
           why = case l

data/lib/modootoday/check/pages.rb

@@ -6,6 +6,7 @@ require_relative "component_rules"
 require_relative "page_sections"
 require_relative "a11y/content"
 require_relative "a11y/new_window"
+require_relative "a11y/illustration"
 
 module Modootoday
   module Check

data/lib/modootoday/check/site_config.rb

@@ -4,7 +4,7 @@ module Modootoday
   module Check
     # The modootoday: settings in the site's _config.yml.
     module SiteConfig
-      COMPONENTS = %w[callout badge hero cta card tabs code-copy nav sidebar page-actions pagination theme-toggle breadcrumb toc accordion steps figure timeline kbd search code footnotes progress embed banner filetree details faq params linkcards quote gallery pricing subscribe loading].freeze
+      COMPONENTS = %w[callout badge hero cta card tabs code-copy nav sidebar page-actions pagination theme-toggle breadcrumb toc accordion steps figure timeline kbd search code footnotes progress embed banner filetree details faq params linkcards quote gallery pricing subscribe split loading lists reveal].freeze
       SEMANTIC = %w[background foreground muted muted-foreground card card-foreground primary primary-foreground brand accent
                     accent-foreground border ring note tip important warning caution status-available status-partial
                     status-planned font-sans font-mono font-size line-height measure space radius].freeze
@@ -25,6 +25,12 @@ module Modootoday
         return errs << "_config.yml: modootoday: must be a map" if mtc && !mtc.is_a?(Hash)
         return unless mtc.is_a?(Hash)
         enums(mtc, errs)
+        full_languages(mtc, errs)
+        if mtc.key?("lists")
+          l = mtc["lists"]
+          ok = l.is_a?(Hash) && (l.keys - %w[link_chips titled_items]).empty? && l.values.all? { |v| [true, false].include?(v) }
+          errs << "_config.yml: modootoday.lists must be a map of link_chips and titled_items set to true or false" unless ok
+        end
         if mtc.key?("archive")
           a = mtc["archive"]
           if !a.is_a?(Hash) || !(a.keys - %w[tags categories]).empty?
@@ -53,6 +59,14 @@ module Modootoday
         errs << "_config.yml: modootoday.languages must be a list of language codes such as [en, ko]" if mtc.key?("languages") && !(mtc["languages"].is_a?(Array) && mtc["languages"].all? { |l| l.to_s =~ /\A[a-z]{2,3}(-[A-Za-z0-9]+)*\z/ })
       end
 
+      # full_languages: the languages that must translate every default-language page (modootoday-check --i18n-pages).
+      def full_languages(mtc, errs)
+        return unless mtc.key?("full_languages")
+        fl, langs = mtc["full_languages"], Array(mtc["languages"]).map(&:to_s)
+        return errs << "_config.yml: modootoday.full_languages must be a list of codes from modootoday.languages" unless fl.is_a?(Array)
+        (fl.map(&:to_s) - langs).each { |l| errs << "_config.yml: modootoday.full_languages: '#{l}' is not in modootoday.languages" }
+      end
+
       def tokens(ctx)
         mtc, errs = ctx.mtc, ctx.errs
         %w[tokens tokens_dark].each do |k|

data/lib/modootoday/check/structured_data.rb

@@ -12,6 +12,10 @@ module Modootoday
     module StructuredData
       BLOCK = %r{<script type="application/ld\+json">(.*?)</script>}m
       CONTEXT = %r{\Ahttps?://schema\.org/?\z}
+      # jekyll-seo-tag output (sites with seo: false that bring the plugin). Its JSON-LD is third-party markup the kit
+      # does not write: it is checked only for valid JSON and noted as a warning, not held to the kit's rules
+      # (for example WebPage with headline but no name). schema.org itself marks no property as required.
+      SEO_TAG = /<!-- Begin Jekyll SEO tag.*?<!-- End Jekyll SEO tag -->/m
 
       module_function
 
@@ -20,6 +24,15 @@ module Modootoday
       end
 
       def page(ctx, f, html)
+        html.scan(SEO_TAG).each do |seo|
+          seo.scan(BLOCK).flatten.each do |b|
+            JSON.parse(b)
+            ctx.warns << "#{f}: JSON-LD from jekyll-seo-tag not checked against the kit's schema rules (third-party markup)"
+          rescue JSON::ParserError => e
+            ctx.errs << "#{f}: jekyll-seo-tag JSON-LD is not valid JSON (#{e.message[0, 80]})"
+          end
+        end
+        html = html.gsub(SEO_TAG, "")
         blocks = html.scan(BLOCK).flatten
         return if blocks.empty?
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-modootoday
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - modootoday
@@ -129,6 +129,7 @@ files:
 - _includes/modootoday/markdown/c/subscribe.html
 - _includes/modootoday/markdown/components.html
 - _includes/modootoday/markdown/inline.html
+- _includes/modootoday/markdown/lists.html
 - _includes/modootoday/markdown/llms-pages.html
 - _includes/modootoday/markdown/raw-body.html
 - _includes/modootoday/markdown/sections.html
@@ -148,6 +149,7 @@ files:
 - _includes/modootoday/pages/hero/scene.html
 - _includes/modootoday/pages/hero/sparks.html
 - _includes/modootoday/pages/search-form.html
+- _includes/modootoday/ref-url.html
 - _includes/modootoday/render/asset.html
 - _includes/modootoday/render/math.html
 - _includes/modootoday/render/mermaid.html
@@ -236,10 +238,12 @@ files:
 - _sass/modootoday/components/core/inline/_hero.scss
 - _sass/modootoday/components/core/inline/_kbd.scss
 - _sass/modootoday/components/core/inline/_progress.scss
+- _sass/modootoday/components/core/inline/_reveal.scss
 - _sass/modootoday/components/doc/_page-actions.scss
 - _sass/modootoday/components/doc/_sidebar.scss
 - _sass/modootoday/components/doc/_toc.scss
 - _sass/modootoday/components/figure/_figure-svg.scss
+- _sass/modootoday/components/lists/_lists.scss
 - _sass/modootoday/components/loading/_loading.scss
 - _sass/modootoday/components/search/_search.scss
 - _sass/modootoday/components/section/showcase/_card.scss
@@ -254,6 +258,7 @@ files:
 - _sass/modootoday/components/section/structure/_faq.scss
 - _sass/modootoday/components/section/structure/_filetree.scss
 - _sass/modootoday/components/section/structure/_params.scss
+- _sass/modootoday/components/section/structure/_split.scss
 - _sass/modootoday/components/section/structure/_steps.scss
 - _sass/modootoday/components/section/structure/_tabs.scss
 - _sass/modootoday/components/section/structure/_timeline.scss
@@ -301,6 +306,7 @@ files:
 - assets/css/modootoday.scss
 - assets/css/modootoday/doc.scss
 - assets/css/modootoday/figure.scss
+- assets/css/modootoday/lists.scss
 - assets/css/modootoday/loading.scss
 - assets/css/modootoday/search.scss
 - assets/css/modootoday/showcase/card.scss
@@ -315,6 +321,7 @@ files:
 - assets/css/modootoday/structure/faq.scss
 - assets/css/modootoday/structure/filetree.scss
 - assets/css/modootoday/structure/params.scss
+- assets/css/modootoday/structure/split.scss
 - assets/css/modootoday/structure/steps.scss
 - assets/css/modootoday/structure/tabs.scss
 - assets/css/modootoday/structure/timeline.scss
@@ -365,6 +372,7 @@ files:
 - lib/jekyll-theme-modootoday.rb
 - lib/modootoday/check.rb
 - lib/modootoday/check/a11y/content.rb
+- lib/modootoday/check/a11y/illustration.rb
 - lib/modootoday/check/a11y/new_window.rb
 - lib/modootoday/check/blog.rb
 - lib/modootoday/check/build_output.rb