jekyll-theme-modootoday 1.4.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56331c6dac359c696c167df9919dc66dbe9616362e056b597aa95c57ca11bcb2
-  data.tar.gz: ec6fca55ae534ff1326c889fbbdb4f477aed4c759b99b26659012b738a4d06c3
+  metadata.gz: ba068af52c4217d7469bbaf5d086362b4704281f9a3ce7b9a96ca826e66c6f11
+  data.tar.gz: ea56a35d36bbb798fabe491a206314227f6253f0228370f62330a3bb0f4aa040
 SHA512:
-  metadata.gz: afe53d2405f415fa08cb9f590512b804e9ca4c7128ef7005d0a1f0d128784fd84ef7db7a7350d59475e45799d218443c0aa10384a6a6e95c80f570e16b859ea4
-  data.tar.gz: 0c2fee882f3647b394dd5bcf2c17683880b2336862d868c6ff194a7ce8e172786c0b0b0101b54f91271b4e9af61876a88983ff11290649f00686034b816a1235
+  metadata.gz: 9cb0516b1496e14dc54c91c99f08b490eb3b314f62e1946e647a02d9377f7f19331d3ac979ab483285a97b4322eedd28168b1cc7483ea798596d61578a1c2b2a
+  data.tar.gz: 33f345936a60b53e2097eb4a6177bf6490f43711143584fd361ad6caa2ac8a93497efa5ee8f9de85f44441195154ceefefd4f1048f0545c5dda8bc451f09f80d

data/CHANGELOG.md

@@ -6,6 +6,12 @@ The content rules have their own version header (`md-components v1`) in [RULES.m
 
 ## [Unreleased]
 
+## [1.4.1] - 2026-10-31
+
+### Fixed
+
+- Markdown twins and `llms-full.txt` now include a `reference` page's `packages:` table as a Markdown table (with `packages_title`, before or after the body as `packages_position` sets, without the text when `packages_compact: true`); pipes in cells are escaped. `modootoday-check --twins` accepts that table around the byte-identical body. Pages without `packages:` are unchanged.
+
 ## [1.4.0] - 2026-10-31
 
 ### Added
@@ -287,7 +293,8 @@ 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.4.0...HEAD
+[Unreleased]: https://github.com/modootoday/jekyll-theme-modootoday/compare/v1.4.1...HEAD
+[1.4.1]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.4.1
 [1.4.0]: https://github.com/modootoday/jekyll-theme-modootoday/releases/tag/v1.4.0
 [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

data/README.ko.md

@@ -42,7 +42,7 @@ Gemfile 없이 GitHub Pages에서(`remote_theme:`):
 
 ```yaml
 # _config.yml
-remote_theme: modootoday/jekyll-theme-modootoday@v1.4.0
+remote_theme: modootoday/jekyll-theme-modootoday@v1.4.1
 plugins:
   - jekyll-remote-theme
 ```

data/README.md

@@ -39,7 +39,7 @@ On GitHub Pages without a Gemfile (`remote_theme:`):
 
 ```yaml
 # _config.yml
-remote_theme: modootoday/jekyll-theme-modootoday@v1.4.0
+remote_theme: modootoday/jekyll-theme-modootoday@v1.4.1
 plugins:
   - jekyll-remote-theme
 ```

data/_includes/modootoday/markdown/packages.html

@@ -0,0 +1,22 @@
+{%- comment -%}md-components v1: the package table of include.page (reference layout, packages:) as Markdown, for the twin and
+llms-full layouts. Optional bold packages_title line, then | Name | Version | Links |; the name links to url, its text follows
+after ": " unless packages_compact; pipes are escaped and newlines become spaces. Ends with a newline. Empty without packages.{%- endcomment -%}
+{%- assign _pp = include.page -%}
+{%- if _pp.layout == "reference" and _pp.packages.size > 0 -%}
+{%- include modootoday/i18n.html -%}
+{%- assign _nl = "
+" -%}
+{%- if _pp.packages_title %}**{{ _pp.packages_title | replace: _nl, " " | replace: "|", "\|" }}**
+
+{% endif -%}
+| {{ mt_t_layouts_name }} | {{ mt_t_layouts_version }} | {{ mt_t_layouts_links }} |
+| --- | --- | --- |
+{% for p in _pp.packages -%}
+{%- capture _n %}`{{ p.name }}`{% endcapture -%}
+{%- if p.url %}{% capture _u %}{% include modootoday/link.html url=p.url %}{% endcapture %}{% assign _n = "[" | append: _n | append: "](" | append: _u | append: ")" %}{% endif -%}
+{%- if p.text and _pp.packages_compact != true %}{% assign _n = _n | append: ": " | append: p.text %}{% endif -%}
+{%- capture _ls %}{% for l in p.links %}{% unless forloop.first %}, {% endunless %}[{{ l.label }}]({% include modootoday/link.html url=l.url %}){% endfor %}{% endcapture -%}
+{%- capture _v %}{% if p.version %}`{{ p.version }}`{% endif %}{% endcapture -%}
+| {{ _n | replace: _nl, " " | replace: "|", "\|" }} | {{ _v | replace: "|", "\|" }} | {{ _ls | replace: _nl, " " | replace: "|", "\|" }} |
+{% endfor -%}
+{%- endif -%}

data/_includes/modootoday/markdown/raw-body.html

@@ -1,6 +1,14 @@
-{%- comment -%}md-components v1: the source body of include.file (path relative to the current page), front matter removed. Used by the twin and llms-full layouts.{%- endcomment -%}
+{%- comment -%}md-components v1: the source body of include.file (path relative to the current page), front matter removed. Used by the twin and llms-full layouts.
+With include.page (the source page), a reference page's packages: table is added before the body, or after it with packages_position: after.{%- endcomment -%}
 {%- capture _raw -%}{% include_relative {{ include.file }} %}{%- endcapture -%}
 {%- assign _fm = _raw | split: "---" -%}
 {%- assign _front = "---" | append: _fm[1] | append: "---
 " -%}
-{{- _raw | remove_first: _front -}}
+{%- assign _body = _raw | remove_first: _front -%}
+{%- capture _pkmd %}{% if include.page %}{% include modootoday/markdown/packages.html page=include.page %}{% endif %}{% endcapture -%}
+{%- if _pkmd == "" -%}{{- _body -}}
+{%- elsif include.page.packages_position == "after" -%}{{- _body }}
+{{ _pkmd -}}
+{%- else -%}{{- _pkmd }}
+{{ _body -}}
+{%- endif -%}

data/_layouts/llms-full.html

@@ -1,8 +1,8 @@
-{%- comment -%}md-components v1 llms-full.txt: the source body of every page of this language under this directory, byte-for-byte, separated by a blank line. Use from a stub: front matter `layout: llms-full` only.{%- endcomment -%}
+{%- comment -%}md-components v1 llms-full.txt: the source body of every page of this language under this directory, byte-for-byte (plus a reference page's packages: table as Markdown), separated by a blank line. Use from a stub: front matter `layout: llms-full` only.{%- endcomment -%}
 {%- include modootoday/markdown/llms-pages.html -%}
 {%- for _p in _llms_pages -%}
 {%- assign _rel = _p.path | remove_first: _llms_dir -%}
 {%- unless forloop.first %}
 {% endunless -%}
-{%- include modootoday/markdown/raw-body.html file=_rel -%}
+{%- include modootoday/markdown/raw-body.html file=_rel page=_p -%}
 {%- endfor -%}

data/_layouts/twin.html

@@ -1,2 +1,5 @@
-{%- comment -%}md-components v1 twin: outputs the source body of page.twin_of byte-for-byte.{%- endcomment -%}
-{%- include modootoday/markdown/raw-body.html file=page.twin_of -%}
+{%- comment -%}md-components v1 twin: outputs the source body of page.twin_of byte-for-byte (a reference page's packages: table is added as Markdown).{%- endcomment -%}
+{%- assign _tdir = page.path | split: "/" | pop | join: "/" -%}{%- if _tdir != "" -%}{%- assign _tdir = _tdir | append: "/" -%}{%- endif -%}
+{%- assign _tpath = _tdir | append: page.twin_of -%}
+{%- assign _tpage = site.pages | where: "path", _tpath | first -%}
+{%- include modootoday/markdown/raw-body.html file=page.twin_of page=_tpage -%}

data/lib/modootoday/check/twins.rb

@@ -6,6 +6,8 @@ module Modootoday
     #    (/index.md for index.md), byte-identical to its source body. It comes from a stub <name>.md.txt
     #    (layout: twin; works on GitHub Pages) or from the opt-in plugin (plugins: [jekyll-theme-modootoday]).
     #    With modootoday.twins: source, a page without front matter is its own twin at /<path>.md.
+    #    A reference page's packages: table is added to its twin as Markdown, before the body (or after it with
+    #    packages_position: after); the body itself must still be there byte-for-byte.
     #    llms.txt / llms-full.txt exist at / and at each /<lang>/; llms-full.txt contains every page body.
     module Twins
       HINT = "add a stub %s (front matter `layout: twin`, `twin_of`, `permalink`) or enable `plugins: [jekyll-theme-modootoday]` (not on classic GitHub Pages)"
@@ -43,10 +45,20 @@ module Modootoday
           return
         end
         out = File.basename(r) == "index" ? "#{site}/#{r}.md" : "#{site}/#{r}/index.md"
-        b = Markdown.body(File.read(f))
+        src = File.read(f)
+        b = Markdown.body(src)
         bodies[ctx.lang_of(r).to_s] << [rf, b]
         return errs << "#{rf}: twin missing at #{out}: #{format(HINT, "#{rf}.txt")}" unless File.exist?(out)
-        errs << "#{out}: twin is not byte-identical to the body of #{rf}" unless File.binread(out) == b.b
+        tw = File.binread(out)
+        fm = (Markdown.fm(src) rescue {})
+        pk = fm["layout"] == "reference" && fm["packages"].is_a?(Array) && !fm["packages"].empty? ? fm["packages"] : nil
+        return errs << "#{out}: twin is not byte-identical to the body of #{rf}" unless pk || tw == b.b
+        return unless pk
+        after = fm["packages_position"] == "after"
+        ok = after ? tw.start_with?(b.b) : tw.end_with?(b.b)
+        names = pk.map { |x| x.is_a?(Hash) ? x["name"].to_s : "" }
+        ok &&= names.all? { |n| tw.include?("`#{n}`".b) }
+        errs << "#{out}: twin must be the body of #{rf} with its packages: table #{after ? 'after' : 'before'} it" unless ok
       end
 
       def llms(ctx, bodies)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-modootoday
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.4.1
 platform: ruby
 authors:
 - modootoday
@@ -134,6 +134,7 @@ files:
 - _includes/modootoday/markdown/inline.html
 - _includes/modootoday/markdown/lists.html
 - _includes/modootoday/markdown/llms-pages.html
+- _includes/modootoday/markdown/packages.html
 - _includes/modootoday/markdown/raw-body.html
 - _includes/modootoday/markdown/sections.html
 - _includes/modootoday/markdown/split.html