jekyll-theme-modootoday 1.2.2 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67e8a88d61c5558082ea15e0708087ba58f746b25c96e6e9a7a551548a56796e
-  data.tar.gz: b9c58c0639beae968c207837f0433e7f41dc90a13053ceb50180425d68a6c403
+  metadata.gz: 9eb1c4e782cdbaba12079575f273b74a14e9a0e701139858cbf72bf665409d2d
+  data.tar.gz: 41b86c06c720c2ca4077aed45c2e1cf8457aa2774630ffc3e28c8e8aa1041afa
 SHA512:
-  metadata.gz: bd0016d4f7ff9d31ea3c50f312348402aba195ecae900b5eb51fb942edf09d4067e05ec4d73ebc4e733a624378f878a2f9b9241f0b90bc30cf2cf545826b32fe
-  data.tar.gz: b0c6ad0227548f39fb8fb5429695c6c13985714cdd3cb730756601a1f322d0d580d02f6ce98da9ead3f5d997d678d120e84addbf139d938666fd937ede73c674
+  metadata.gz: fd67889b39a19ad4d5e462543d8eb237d8e5823a2713aeeb9d7189d72ab71bbaf252f83e97a406edfb75ba760b822d9137bd211d8670f8cd47264d39a9c6d197
+  data.tar.gz: b7185e039610c3d5641eb29bf34a91bc436bdf3113645dd4ed07036e5d2d55d388bb1ffc74ea932d2ad0c88e70235ac2c123f45a002f902f5da2b3abde263dcf

data/CHANGELOG.md

@@ -6,6 +6,33 @@ The content rules have their own version header (`md-components v1`) in [RULES.m
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-10-31
+
+### Added
+
+- `reference` layout, opt-in API sidebar: `sidebar: true` puts the member list in a side column that stays in view from 64rem up, with members grouped under their `group:` label (in order of first use); narrower screens show the same list above the page. CSS only, in the docs-extra bundle.
+- `reference` layout, opt-in package table: `packages: [{name, version, text, url, links: [{label, url}]}]` (and an optional `packages_title:` caption) lists packages or crates with name, version, description and links before the body; rows stack into cards on small screens. The table is also available as `{% include modootoday/docs-extra/packages.html items=… %}`. A page with `packages:` may leave out `members:`.
+- `modootoday-check` reports a `sidebar:` that is not true or false, a package with no `name`, and a package link with no `url`.
+- API reference demo (en, ko, ja) and docs for both parts; the docs audit covers the new demo page.
+
+## [1.2.3] - 2026-10-31
+
+### Changed
+
+- In a `c: features` card, the separator after a bold title written as `**Title**: text` or `**Title**：text` is not shown, the same as ` — ` already was. Only the one separator right after an item's opening title goes; `**Title**::`, `**Title**:text` with no space, colons later in the text and bold text mid-item are unchanged.
+
+### Fixed
+
+- The `redirect` layout reads the target from `page.redirect.to`, where jekyll-redirect-from 0.16 puts it, as well as from `redirect_to`; redirect stubs had an empty refresh `url=`, an empty canonical and an empty "Continue to the new page" link. The refresh, canonical and link use the same target, and the docs audit flags empty ones.
+- On a site without search the header's language menu and theme toggle sit at the inline end of the row (the first trailing control takes `margin-inline-start: auto`), in LTR and RTL; headers with search are unchanged. The docs audit checks the gap at 1440px and 390px.
+- `modootoday-check` accepts a link whose text is a code span, such as [`file.tsx`](…); the code text is its accessible name. Links with no text, or only emphasis marks, are still an "empty link text" error.
+
+### Documentation
+
+- README (English and Korean): the page layout families, section options (`c: split`, `bleed:`, `reveal:`), the 23 label languages with RTL, and the optional extras (search, light/dark toggle, Mermaid, KaTeX, JSON-LD); the guide list links Layouts, Recipes, Math and diagrams, Translation rules and Structured data. The gem description names the layouts and languages.
+- Migrate and upgrade: a 1.0/1.1 → 1.2 row (en, ko, ja). The example home page shows a `bleed:` band.
+- Install (en, ko, ja): running the checker on a `remote_theme` site, where `bundle exec modootoday-check` is not available: `gem install jekyll-theme-modootoday -v '~> 1.2'`, `ruby -S` when the script is not on `PATH`, `GEM_PATH="$(gem env gemdir)"` for `Gem::GemNotFoundException`, and running `exe/modootoday-check` from the release source without installing a gem.
+
 ## [1.2.2] - 2026-10-31
 
 ### Fixed
@@ -248,7 +275,9 @@ 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.2.2...HEAD
+[Unreleased]: https://github.com/modootoday/jekyll-theme-modootoday/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.3.0
+[1.2.3]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.2.3
 [1.2.2]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.2.2
 [1.2.1]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.2.1
 [1.2.0]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.2.0

data/README.ko.md

@@ -16,9 +16,13 @@
 - **페이지에는 표준 Markdown만.** GFM과 GitHub 알림만 쓰므로 같은 파일이 github.com에서도 잘 읽힙니다.
 - **GitHub Pages에서 동작.** 레이아웃과 include가 Liquid만 쓰므로 기본 빌드의 `remote_theme`도 되고, Jekyll 4도 됩니다.
 - **마크업 없는 컴포넌트.** 알림, 상태 배지, 카드, 탭, 버튼, 아코디언, 단계, 타임라인 등이 평범한 Markdown 패턴에서 나옵니다.
+- **페이지 계열.** 문서 외에도 레이아웃이 40개쯤 있습니다. 홈, 블로그와 뉴스, 디렉터리(팀, 채용, 행사, 후원사, 포트폴리오), 상세 페이지, 마케팅(가격, 기능, 문의, 링크 모음), 문서(약관, 이력서), 문서 부가 페이지(레퍼런스, 변경 기록, 로드맵, 용어집, 강좌, 책)가 있습니다.
+- **디자인된 듯한 섹션.** `sections:` 항목에 `visual:` include나 코드와 함께 쓰는 `c: split`, 전체 너비 `bleed:` 띠, `reveal:` 페이드인, 4열 카드 같은 옵션을 줄 수 있고, 분할 히어로도 같은 방식으로 씁니다.
+- **23개 언어, LTR과 RTL.** 테마 문구가 23개 언어로 현지화되어 있고 언어 메뉴, `hreflang`, 오른쪽에서 왼쪽으로 쓰는 레이아웃을 지원합니다.
 - **에이전트가 읽기 쉬움.** 페이지마다 바이트 단위로 같은 Markdown 버전과 `llms.txt`, `llms-full.txt`를 둘 수 있습니다.
 - **접근성.** 키보드 단축키, 보이는 포커스, 휴대폰 안전 영역, 44 px 터치 대상, 고대비와 동작 줄이기가 기본으로 들어 있습니다.
 - **검사기.** `modootoday-check`가 원문과 빌드 결과를 검사합니다.
+- **선택 기능.** 검색, 라이트/다크 전환, Mermaid 다이어그램과 KaTeX 수식(기본은 꺼져 있고 쓰는 페이지에서만 불러옵니다), schema.org JSON-LD를 제공합니다.
 
 ## 설치
 
@@ -26,7 +30,7 @@ gem 방식(`theme:`):
 
 ```ruby
 # Gemfile
-gem "jekyll-theme-modootoday", "~> 1.2"
+gem "jekyll-theme-modootoday", "~> 1.3"
 ```
 
 ```yaml
@@ -38,7 +42,7 @@ Gemfile 없이 GitHub Pages에서(`remote_theme:`):
 
 ```yaml
 # _config.yml
-remote_theme: modootoday/jekyll-theme-modootoday@v1.2.2
+remote_theme: modootoday/jekyll-theme-modootoday@v1.3.0
 plugins:
   - jekyll-remote-theme
 ```
@@ -49,7 +53,7 @@ plugins:
 
 ```sh
 mkdir my-docs && cd my-docs
-printf 'source "https://rubygems.org"\ngem "jekyll", "~> 4.4"\ngem "jekyll-theme-modootoday", "~> 1.2"\n' > Gemfile
+printf 'source "https://rubygems.org"\ngem "jekyll", "~> 4.4"\ngem "jekyll-theme-modootoday", "~> 1.3"\n' > Gemfile
 printf 'theme: jekyll-theme-modootoday\nmarkdown: kramdown\nkramdown: {input: GFM}\nsass: {style: compressed, silence_deprecations: [import, global-builtin]}\n' > _config.yml
 printf -- '---\nlayout: doc\ntitle: Home\n---\n# Hello\n\n> [!TIP]\n> Plain Markdown, styled.\n' > index.md
 bundle install && bundle exec jekyll build
@@ -96,7 +100,7 @@ bundle exec modootoday-check . _site
 ## 가이드
 
 - [문서 사이트](https://modootoday.github.io/jekyll-theme-modootoday/ko/) ([`docs/`](docs/)에서 이 테마로 빌드)
-- [설치](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/install/) · [첫 페이지](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/first-page/) · [컴포넌트](https://modootoday.github.io/jekyll-theme-modootoday/ko/components/) · [설정](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/configuration/) · [커스터마이즈](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/customize/) · [블로그와 뉴스](https://modootoday.github.io/jekyll-theme-modootoday/ko/layouts/blog-news/) · [공개 API](https://modootoday.github.io/jekyll-theme-modootoday/ko/reference/api/) · [이전과 업그레이드](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/upgrade/) · [CSP](https://modootoday.github.io/jekyll-theme-modootoday/ko/recipes/csp/) · [접근성](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/accessibility/) · [로드맵](https://modootoday.github.io/jekyll-theme-modootoday/ko/reference/roadmap/) · [변경 기록](CHANGELOG.md)
+- [설치](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/install/) · [첫 페이지](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/first-page/) · [컴포넌트](https://modootoday.github.io/jekyll-theme-modootoday/ko/components/) · [설정](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/configuration/) · [커스터마이즈](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/customize/) · [레이아웃](https://modootoday.github.io/jekyll-theme-modootoday/ko/layouts/) · [블로그와 뉴스](https://modootoday.github.io/jekyll-theme-modootoday/ko/layouts/blog-news/) · [레시피](https://modootoday.github.io/jekyll-theme-modootoday/ko/recipes/) · [수식과 다이어그램](https://modootoday.github.io/jekyll-theme-modootoday/ko/recipes/math-diagrams/) · [번역 규칙](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/translation/) · [구조화 데이터](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/structured-data/) · [공개 API](https://modootoday.github.io/jekyll-theme-modootoday/ko/reference/api/) · [이전과 업그레이드](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/upgrade/) · [CSP](https://modootoday.github.io/jekyll-theme-modootoday/ko/recipes/csp/) · [접근성](https://modootoday.github.io/jekyll-theme-modootoday/ko/guides/accessibility/) · [로드맵](https://modootoday.github.io/jekyll-theme-modootoday/ko/reference/roadmap/) · [변경 기록](CHANGELOG.md)
 - 지원 스택: GitHub Pages(`github-pages` 232, Jekyll 3.10, Ruby 3.3.4)와 Jekyll 4.4(Ruby 3.2~3.4), 모두 CI에서 테스트합니다. Jekyll 3.9를 하한으로 테스트합니다.
 - [보안 정책](SECURITY.md) · [행동 강령](CODE_OF_CONDUCT.md)
 

data/README.md

@@ -13,9 +13,13 @@ A Jekyll theme that keeps page bodies in plain GitHub Markdown and styles them w
 - **Only standard Markdown in your pages.** GFM plus GitHub alerts; the same file reads well on github.com.
 - **Works on GitHub Pages.** Layouts and includes are Liquid only, so `remote_theme` works on the classic build; Jekyll 4 works too.
 - **Components without markup.** Alerts, status badges, card grids, tabs, buttons, accordion, steps, timeline and more come from plain Markdown patterns.
+- **Page families.** About 40 layouts beyond docs: home, blog and news, directory (team, jobs, events, sponsors, portfolio), detail pages, marketing (pricing, feature, contact, links), documents (legal, resume) and docs extras (reference, changelog, roadmap, glossary, course, book).
+- **Sections that look designed.** `sections:` items take options such as `c: split` with a `visual:` include or code, full-width `bleed:` bands, `reveal:` fade-ins and four-column cards; a split hero works the same way.
+- **23 languages, LTR and RTL.** Theme labels ship localized for 23 languages, with a language menu, `hreflang` and right-to-left layouts.
 - **Readable by agents.** Every page can have a byte-identical Markdown twin, plus `llms.txt` and `llms-full.txt`.
 - **Accessible.** Keyboard shortcuts, visible focus, safe areas on phones, 44 px touch targets, high contrast and reduced motion are built in.
 - **Checked.** `modootoday-check` validates the sources and the built site.
+- **Optional extras.** Search, a light/dark toggle, Mermaid diagrams and KaTeX math (off by default, loaded only on pages that use them) and schema.org JSON-LD.
 
 ## Install
 
@@ -23,7 +27,7 @@ As a gem (`theme:`):
 
 ```ruby
 # Gemfile
-gem "jekyll-theme-modootoday", "~> 1.2"
+gem "jekyll-theme-modootoday", "~> 1.3"
 ```
 
 ```yaml
@@ -35,7 +39,7 @@ On GitHub Pages without a Gemfile (`remote_theme:`):
 
 ```yaml
 # _config.yml
-remote_theme: modootoday/jekyll-theme-modootoday@v1.2.2
+remote_theme: modootoday/jekyll-theme-modootoday@v1.3.0
 plugins:
   - jekyll-remote-theme
 ```
@@ -46,7 +50,7 @@ Pin a tag or a commit. More options: [Install guide](https://modootoday.github.i
 
 ```sh
 mkdir my-docs && cd my-docs
-printf 'source "https://rubygems.org"\ngem "jekyll", "~> 4.4"\ngem "jekyll-theme-modootoday", "~> 1.2"\n' > Gemfile
+printf 'source "https://rubygems.org"\ngem "jekyll", "~> 4.4"\ngem "jekyll-theme-modootoday", "~> 1.3"\n' > Gemfile
 printf 'theme: jekyll-theme-modootoday\nmarkdown: kramdown\nkramdown: {input: GFM}\nsass: {style: compressed, silence_deprecations: [import, global-builtin]}\n' > _config.yml
 printf -- '---\nlayout: doc\ntitle: Home\n---\n# Hello\n\n> [!TIP]\n> Plain Markdown, styled.\n' > index.md
 bundle install && bundle exec jekyll build
@@ -93,7 +97,7 @@ Walkthrough: [Write your first page](https://modootoday.github.io/jekyll-theme-m
 ## Guides
 
 - [Documentation site](https://modootoday.github.io/jekyll-theme-modootoday/) (built with this theme from [`docs/`](docs/))
-- [Install](https://modootoday.github.io/jekyll-theme-modootoday/guides/install/) · [First page](https://modootoday.github.io/jekyll-theme-modootoday/guides/first-page/) · [Components](https://modootoday.github.io/jekyll-theme-modootoday/components/) · [Configuration](https://modootoday.github.io/jekyll-theme-modootoday/guides/configuration/) · [Customize](https://modootoday.github.io/jekyll-theme-modootoday/guides/customize/) · [Blog and news](https://modootoday.github.io/jekyll-theme-modootoday/layouts/blog-news/) · [Public API](https://modootoday.github.io/jekyll-theme-modootoday/reference/api/) · [Migrate and upgrade](https://modootoday.github.io/jekyll-theme-modootoday/guides/upgrade/) · [CSP](https://modootoday.github.io/jekyll-theme-modootoday/recipes/csp/) · [Accessibility](https://modootoday.github.io/jekyll-theme-modootoday/guides/accessibility/) · [Roadmap](https://modootoday.github.io/jekyll-theme-modootoday/reference/roadmap/) · [Changelog](CHANGELOG.md)
+- [Install](https://modootoday.github.io/jekyll-theme-modootoday/guides/install/) · [First page](https://modootoday.github.io/jekyll-theme-modootoday/guides/first-page/) · [Components](https://modootoday.github.io/jekyll-theme-modootoday/components/) · [Configuration](https://modootoday.github.io/jekyll-theme-modootoday/guides/configuration/) · [Customize](https://modootoday.github.io/jekyll-theme-modootoday/guides/customize/) · [Layouts](https://modootoday.github.io/jekyll-theme-modootoday/layouts/) · [Blog and news](https://modootoday.github.io/jekyll-theme-modootoday/layouts/blog-news/) · [Recipes](https://modootoday.github.io/jekyll-theme-modootoday/recipes/) · [Math and diagrams](https://modootoday.github.io/jekyll-theme-modootoday/recipes/math-diagrams/) · [Translation rules](https://modootoday.github.io/jekyll-theme-modootoday/guides/translation/) · [Structured data](https://modootoday.github.io/jekyll-theme-modootoday/guides/structured-data/) · [Public API](https://modootoday.github.io/jekyll-theme-modootoday/reference/api/) · [Migrate and upgrade](https://modootoday.github.io/jekyll-theme-modootoday/guides/upgrade/) · [CSP](https://modootoday.github.io/jekyll-theme-modootoday/recipes/csp/) · [Accessibility](https://modootoday.github.io/jekyll-theme-modootoday/guides/accessibility/) · [Roadmap](https://modootoday.github.io/jekyll-theme-modootoday/reference/roadmap/) · [Changelog](CHANGELOG.md)
 - Supported stacks: GitHub Pages (`github-pages` 232, Jekyll 3.10, Ruby 3.3.4) and Jekyll 4.4 on Ruby 3.2 to 3.4, all tested in CI; Jekyll 3.9 is the tested floor.
 - [Security policy](SECURITY.md) · [Code of conduct](CODE_OF_CONDUCT.md)
 

data/RULES.md

@@ -22,7 +22,7 @@ Every content page starts with front matter; an empty block (`---` then `---`) i
 | Full-width band | front matter `bleed: true` or `bleed: wide` on `hero:` or a section item | `.mt-bleed` (plus `.mt-bleed-wide`) on the section, no wrapper; the optional `bleed` sheet paints `--mt-bleed-bg` to the viewport edges, `wide` widens the content up to the container | other values are checker errors |
 | 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 |
+| Card grid | under `##`, list items `- **Title** — text` or `- **Title**: text` (the separator after the title is not shown) | 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 |
 | Install tabs | in a `c: tabs` section, repeated `### name` + fenced code block (info string = one language word) | `data-tabs` + i18n `tabs.label`; `assets/js/modootoday/tabs.js` builds WAI-ARIA tabs (arrows, Home, End) | all blocks in order |
 | Diagrams, math | ```` ```mermaid ```` / ```` ```math ````, a `$$` block on its own lines; inline `$…$` only with `modootoday.math.inline: true` (otherwise a checker warning) | off by default. `modootoday.mermaid` / `modootoday.math` load a version-pinned renderer with SRI `integrity` (or a self-hosted path) plus `assets/js/modootoday-{mermaid,math}.js`, only on pages with a block; front matter `mermaid: false` / `math: false` skips a page. A CDN adds its origin to `script-src` (math also `style-src`, `font-src`) and receives visitors' IP addresses; Mermaid needs `style-src 'unsafe-inline'`. Any other third-party script or stylesheet, or one without matching `integrity` and `crossorigin="anonymous"`, is a checker error (docs: Math and diagrams) | code / GitHub mermaid, math |

data/_includes/modootoday/docs-extra/packages.html

@@ -0,0 +1,14 @@
+{%- include modootoday/i18n.html -%}
+{%- comment -%}Package table: include.items is [{name, version, text, url, links: [{label, url}]}]; include.caption is optional.
+One row per package (the name is the row header, the text under it); rows stack into cards on narrow screens. CSS in docs-extra.{%- endcomment -%}
+<table class="mt-dx-pkgs">
+{%- if include.caption %}<caption>{{ include.caption }}</caption>{% endif %}
+<thead><tr><th scope="col">{{ mt_t_layouts_name }}</th><th scope="col">{{ mt_t_layouts_version }}</th><th scope="col">{{ mt_t_layouts_links }}</th></tr></thead>
+<tbody>
+{%- for p in include.items %}
+<tr id="{{ p.id | default: p.name | slugify }}"><th scope="row"><code>{% if p.url %}<a href="{% include modootoday/link.html url=p.url %}">{{ p.name }}</a>{% else %}{{ p.name }}{% endif %}</code>{% if p.text %}<span>{{ p.text | markdownify | remove: "<p>" | remove: "</p>" | strip }}</span>{% endif %}</th>
+<td data-label="{{ mt_t_layouts_version }}">{% if p.version %}<code>{{ p.version }}</code>{% endif %}</td>
+<td data-label="{{ mt_t_layouts_links }}">{% if p.links.size > 0 %}<ul>{% for l in p.links %}<li><a href="{% include modootoday/link.html url=l.url %}"{% include modootoday/links/attrs.html on=l.new_window target=l.target url=l.url %}>{{ l.label }}</a></li>{% endfor %}</ul>{% endif %}</td></tr>
+{%- endfor %}
+</tbody>
+</table>

data/_includes/modootoday/markdown/sections.html

@@ -44,6 +44,11 @@ modootoday-check fails when the item count differs from the h2 count.
 {%- 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 -%}
+{%- comment -%}features: a card that starts with **Title**: or **Title**： drops that one separator (the title is its own line); later colons and other bold text stay.{%- endcomment -%}
+{%- if _cc == 'features' and _body contains "<li><strong>" -%}{%- assign _fp = _body | split: "<li><strong>" -%}
+{%- capture _body -%}{{ _fp[0] }}{%- for _x in _fp offset:1 -%}{%- assign _tt = _x | split: "</strong>" | first -%}{%- assign _ra = _x | remove_first: _tt | slice: 0, 11 -%}{%- assign _rb = _x | remove_first: _tt | slice: 0, 10 -%}
+{%- if _tt contains "<li" or _tt contains "</li>" -%}<li><strong>{{ _x }}{%- elsif _ra == "</strong>: " -%}<li><strong>{{ _tt }}</strong> {{ _x | remove_first: _tt | remove_first: "</strong>: " }}{%- elsif _rb == "</strong>：" -%}<li><strong>{{ _tt }}</strong> {{ _x | remove_first: _tt | remove_first: "</strong>：" | lstrip }}{%- else -%}<li><strong>{{ _x }}{%- endif -%}
+{%- endfor -%}{%- endcapture -%}{%- 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 %}{% if _s.decor %} mt-has-decor{% endif %}{% if _s.reveal == true %} mt-reveal{% endif %}{% if _s.bleed %} mt-bleed{% if _s.bleed == 'wide' %} mt-bleed-wide{% endif %}{% 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' %}

data/_layouts/redirect.html

@@ -1,10 +1,14 @@
-{%- comment -%}redirect: standalone page that sends visitors to page.redirect_to (meta refresh, no script, so it
+{%- comment -%}redirect: standalone page that sends visitors to page.redirect.to (jekyll-redirect-from) or page.redirect_to (meta refresh, no script, so it
   works under a strict CSP), with a canonical link for search engines and a visible link for everyone else.{%- endcomment -%}
 {%- assign _lang = page.lang | default: site.lang | default: "en" -%}
 {%- include modootoday/i18n.html lang=_lang -%}
 {%- assign _rtl = "ar fa he ur yi ps sd ug dv ckb" | split: " " -%}{%- assign _b = _lang | split: "-" | first -%}
 {%- if _rtl contains _b %}{% assign _dir = "rtl" %}{% else %}{% assign _dir = nil %}{% endif %}{%- assign _dir = mt_t_direction | default: _dir -%}
-{%- assign _to = page.redirect_to -%}{%- unless _to contains "://" -%}{%- assign _to = _to | relative_url -%}{%- endunless -%}
+{%- comment -%}jekyll-redirect-from gives page.redirect.to already resolved (site.url + baseurl); a hand-written
+  redirect_to is a site path or a full URL. The refresh, canonical and link all use the same target.{%- endcomment -%}
+{%- if page.redirect.to -%}{%- assign _to = page.redirect.to -%}{%- assign _abs = _to -%}
+{%- elsif page.redirect_to contains "://" -%}{%- assign _to = page.redirect_to -%}{%- assign _abs = _to -%}
+{%- else -%}{%- assign _to = page.redirect_to | relative_url -%}{%- assign _abs = page.redirect_to | absolute_url -%}{%- endif -%}
 <!doctype html>
 <html lang="{{ _lang }}"{% if _dir %} dir="{{ _dir }}"{% endif %}>
 <head>
@@ -12,7 +16,7 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>{{ mt_t_pages_moved }}</title>
 <meta name="robots" content="noindex">
-<link rel="canonical" href="{% if page.redirect_to contains '://' %}{{ _to }}{% else %}{{ page.redirect_to | absolute_url }}{% endif %}">
+<link rel="canonical" href="{{ _abs }}">
 <meta http-equiv="refresh" content="0; url={{ _to }}">
 </head>
 <body>

data/_layouts/reference.html

@@ -3,13 +3,22 @@ layout: default
 mt_bundle: docs-extra
 mt_main: mt-dx mt-dx-reference
 ---
-{%- comment -%}reference: an API or option reference. members: [{name, signature, text, since, deprecated, id}] become a contents
-list and one section each (h2 with the name in code, the signature, the text, since / deprecated notes); the body comes first.{%- endcomment -%}
-<article aria-labelledby="mt-dx-title">
+{%- comment -%}reference: an API or option reference. members: [{name, signature, text, since, deprecated, id, group}] become a contents
+list and one section each (h2 with the name in code, the signature, the text, since / deprecated notes); the body comes first.
+Opt-in: sidebar: true puts the contents in a sticky side column (members grouped by group, in order of first use; CSS only, a plain
+list on narrow screens). packages: [{name, version, text, url, links: [{label, url}]}] adds a package table (packages.html) before the body.{%- endcomment -%}
+<article aria-labelledby="mt-dx-title"{% if page.sidebar %} class="mt-dx-api"{% endif %}>
 {%- include modootoday/docs-extra/head.html %}
-{%- if page.members.size > 1 %}
+{%- if page.sidebar and page.members.size > 0 %}
+<nav class="mt-dx-side" aria-label="{{ mt_t_layouts_contents }}"><ul>
+{%- assign _groups = page.members | group_by: "group" %}{% for g in _groups %}
+{%- capture _links %}{% for m in g.items %}<li><a href="#{{ m.id | default: m.name | slugify }}"><code>{{ m.name }}</code></a></li>{% endfor %}{% endcapture %}
+{%- if g.name != "" %}<li><span class="mt-dx-side-h">{{ g.name }}</span><ul>{{ _links }}</ul></li>{% else %}{{ _links }}{% endif %}
+{%- endfor %}</ul></nav>
+{%- elsif page.members.size > 1 %}
 <nav class="mt-dx-toc" aria-label="{{ mt_t_layouts_contents }}"><ul>{% for m in page.members %}<li><a href="#{{ m.id | default: m.name | slugify }}"><code>{{ m.name }}</code></a></li>{% endfor %}</ul></nav>
 {%- endif %}
+{%- if page.packages %}{% include modootoday/docs-extra/packages.html items=page.packages caption=page.packages_title %}{% endif %}
 <div class="mt-dx-body">
 {{ content }}
 </div>

data/_sass/modootoday/docs-extra/_page.scss

@@ -35,3 +35,36 @@
   .mt-dx-chapters li { padding: .5rem 0; border-bottom: 1px solid mt(border); }
   @media print { .mt-dx-toc, .mt-dx-letters { display: none; } .mt-dx-col, .mt-dx-member, .mt-dx-release { break-inside: avoid; } }
 }
+// Opt-in reference parts: the API sidebar (sidebar: true) and the package table (packages:).
+@include mt-layer(components) {
+  .mt-dx-side ul { margin: 0 0 1.5rem; padding: 0; list-style: none; }
+  .mt-dx-side ul ul { margin: .25rem 0 .75rem; }
+  .mt-dx-side a { display: block; padding: .25rem .5rem; border-radius: mt(radius); text-decoration: none; }
+  .mt-dx-side a:hover { background: mt(muted); }
+  .mt-dx-side-h { display: block; padding: .5rem .5rem .25rem; font-size: .8125rem; font-weight: 600; color: mt(muted-foreground); }
+  @media (min-width: 64rem) {
+    .mt-dx-api { display: grid; grid-template-columns: 14rem minmax(0, 1fr); column-gap: 2.5rem; }
+    .mt-dx-api > * { grid-column: 2; }
+    .mt-dx-api > .mt-dx-side { grid-column: 1; grid-row: 1 / span 999; align-self: start; position: sticky; top: 4.5rem; max-height: calc(100vh - 6rem); overflow-y: auto; padding-inline-end: .5rem; border-inline-end: 1px solid mt(border); }
+    .mt-dx-api > .mt-dx-side ul { margin-bottom: 0; }
+  }
+  .mt-dx-pkgs { display: table; width: 100%; margin-bottom: 2rem; }
+  .mt-dx-pkgs caption { padding: .75rem .9rem 0; font-weight: 600; text-align: start; }
+  .mt-dx-pkgs thead th { color: mt(muted-foreground); }
+  .mt-dx-pkgs tbody th { white-space: normal; background: none; font-size: inherit; font-weight: 400; }
+  .mt-dx-pkgs tr:last-child > th { border-bottom: 0; }
+  .mt-dx-pkgs tbody th > code { font-weight: 600; }
+  .mt-dx-pkgs tbody th > span { display: block; margin-top: .25rem; color: mt(muted-foreground); }
+  .mt-dx-pkgs ul { display: flex; flex-wrap: wrap; gap: .25rem .75rem; margin: 0; padding: 0; list-style: none; }
+  .mt-dx-pkgs li { margin: 0; }
+  @media (max-width: 39.99rem) {
+    .mt-dx-pkgs, .mt-dx-pkgs caption, .mt-dx-pkgs tbody, .mt-dx-pkgs tr, .mt-dx-pkgs th, .mt-dx-pkgs td { display: block; }
+    .mt-dx-pkgs thead { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); }
+    .mt-dx-pkgs tr { padding: .5rem .9rem; border-bottom: 1px solid mt(border); }
+    .mt-dx-pkgs tr:last-child { border-bottom: 0; }
+    .mt-dx-pkgs tbody th, .mt-dx-pkgs td { padding: .25rem 0; border: 0; }
+    .mt-dx-pkgs td:empty { display: none; }
+    .mt-dx-pkgs td::before { content: attr(data-label) ": "; color: mt(muted-foreground); font-size: .8125rem; }
+  }
+  @media print { .mt-dx-side { display: none; } .mt-dx-api { display: block; } }
+}

data/_sass/modootoday/layout/_shell.scss

@@ -8,6 +8,8 @@
   .mt-header-inner, .mt-main, .mt-footer-inner { width: 100%; max-width: mt(container); margin: 0 auto;
     padding-left: calc(var(--mt-gutter) + var(--mt-safe-left)); padding-right: calc(var(--mt-gutter) + var(--mt-safe-right)); }
   .mt-header-inner { display: flex; align-items: center; gap: .5rem 1.25rem; min-height: mt(header-height); }
+  // The first trailing control (search, language menu or theme toggle) pushes the group to the inline end, with or without search.
+  .mt-header-inner > :is(.mt-search, details.mt-lang, .mt-theme-toggle):not(:is(.mt-search, details.mt-lang, .mt-theme-toggle) ~ *) { margin-inline-start: auto; }
   .mt-site-title { flex: none; display: inline-flex; align-items: center; gap: .55rem; font-weight: 700; letter-spacing: -.01em;
     text-decoration: none; color: mt(foreground); white-space: nowrap; }
   .mt-site-title:not(.mt-has-logo)::before { content: ""; width: 1.4rem; height: 1.4rem; border-radius: .4rem; flex: none;

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

@@ -30,6 +30,8 @@ module Modootoday
 
       def links(ctx, r, code)
         each_line(code, /(?<!!)\[([^\]]*)\]\([^)]*\)/) do |n, m|
+          # Inline code arrives as a `` placeholder: [`file.tsx`](…) has a name (the code text), so it is not empty.
+          next if m[1].include?("``")
           t = m[1].gsub(/[*_`]/, "").strip
           next ctx.errs << "#{r}:#{n}: empty link text [](…) (announced as just \"link\"); write what it opens" if t.empty?
           ctx.warns << "#{r}:#{n}: vague link text \"#{t}\"; name the destination so it makes sense out of context" if t.match?(VAGUE)

data/lib/modootoday/check/layouts/docs_extra.rb

@@ -17,7 +17,16 @@ module Modootoday
           send(fm["layout"], errs, w, fm)
         end
 
-        def reference(errs, w, fm) = Shape.list(errs, w, "members", fm["members"], any: %w[name], optional: false)
+        # members is required unless the page lists packages; sidebar: is true or false; packages need a name, links a label and url.
+        def reference(errs, w, fm)
+          Shape.list(errs, w, "members", fm["members"], any: %w[name], optional: fm.key?("packages"))
+          errs << "#{w}: sidebar must be true or false" unless [nil, true, false].include?(fm["sidebar"])
+          Shape.list(errs, w, "packages", fm["packages"], any: %w[name]) do |p, i|
+            Shape.list(errs, w, "packages[#{i}].links", p["links"], any: %w[label]) do |l, j|
+              errs << "#{w}: packages[#{i}].links[#{j}].url is required" unless Shape.url?(l["url"])
+            end
+          end
+        end
 
         def changelog(errs, w, fm)
           Shape.list(errs, w, "releases", fm["releases"], any: %w[version], optional: false) do |r, i|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-modootoday
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.3.0
 platform: ruby
 authors:
 - modootoday
@@ -30,8 +30,10 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '5.0'
-description: GitHub alerts, status badges, sectioned pages, install tabs and agent-readable
-  Markdown twins for Jekyll and GitHub Pages, plus a checker (modootoday-check).
+description: GitHub alerts, status badges, sectioned pages, install tabs, about 40
+  page layouts (blog, news, directory, marketing, documents), labels in 23 languages
+  with RTL, and agent-readable Markdown twins for Jekyll and GitHub Pages, plus a
+  checker (modootoday-check).
 email:
 executables:
 - modootoday-check
@@ -77,6 +79,7 @@ files:
 - _includes/modootoday/doc/twin.html
 - _includes/modootoday/docs-extra/head.html
 - _includes/modootoday/docs-extra/jsonld.html
+- _includes/modootoday/docs-extra/packages.html
 - _includes/modootoday/head-meta.html
 - _includes/modootoday/home-url.html
 - _includes/modootoday/i18n.html