slipway-theme 0.1.0 → 0.2.0

data/assets/css/slipway.css

@@ -1,4 +1,4 @@
-/* Base styles. Every value comes from assets/css/tokens.css. Logical properties only. */
+/* Base styles from tokens.css. Logical properties. */
 @layer base {
   html {
     background: var(--sl-color-canvas);
@@ -503,6 +503,47 @@
   }
 }
 
+/* Post reading progress: a scroll-driven bar at the top of the viewport, pure CSS with no JavaScript.
+   Without `animation-timeline` support the fill stays at scaleX(0) and nothing shows. */
+@layer components {
+  .sl-progress {
+    position: fixed;
+    inset-block-start: 0;
+    inset-inline: 0;
+    block-size: 2px;
+    z-index: 10;
+    pointer-events: none;
+  }
+
+  .sl-progress-fill {
+    block-size: 100%;
+    background: var(--sl-color-rose);
+    transform: scaleX(0);
+    transform-origin: 0 50%;
+  }
+
+  [dir="rtl"] .sl-progress-fill {
+    transform-origin: 100% 50%;
+  }
+
+  @supports (animation-timeline: scroll()) {
+    .sl-progress-fill {
+      animation: sl-progress linear both;
+      animation-timeline: scroll(root block);
+    }
+  }
+}
+
+@keyframes sl-progress {
+  from {
+    transform: scaleX(0);
+  }
+
+  to {
+    transform: scaleX(1);
+  }
+}
+
 /* Post series: the box after the post header with the parts and the previous and next part. */
 @layer components {
   .sl-series {
@@ -557,6 +598,18 @@
   }
 }
 
+/* Comments: the giscus embed at the end of a post. */
+@layer components {
+  .sl-comments {
+    margin-block-start: var(--sl-space-12);
+  }
+
+  .sl-comments h2 {
+    margin-block-end: var(--sl-space-4);
+    font-size: var(--sl-step-lg);
+  }
+}
+
 /* Authors: the byline, the author box after a post, and the author page. */
 @layer components {
   .sl-authors {

data/assets/js/copy-code.js

@@ -30,7 +30,7 @@
     btn.type = "button";
     btn.className = "sl-copy";
     var orig = btn.textContent = label(lang, "copy", data);
-    bind(btn, lang, data, orig, function(c) { return c.writeText(pre.textContent); });
+    bind(btn, lang, data, orig, function(c) { var m=pre.querySelector(".sl-commands");return c.writeText(m?m.textContent:pre.textContent) });
     pre.parentNode.insertBefore(wrap, pre);
     wrap.appendChild(pre);
     wrap.appendChild(btn);

data/assets/js/search.js

@@ -1,6 +1,7 @@
-/* Client-side search over the language's search.json. The field is hidden until this script runs, so a page
-   needs no JavaScript to be read. Persian-aware: ي/ك become ی/ک, ZWNJ and diacritics are dropped, digits are
-   Latin. */
+/* Client-side search over the language's search.json. The field is hidden until this script runs, and the
+   index is fetched only when the field is first focused or typed in, so a page needs no JavaScript to be
+   read and pays for the index only when search is used. Persian-aware: ي/ك become ی/ک, ZWNJ and diacritics
+   are dropped, digits are Latin. */
 (function () {
   function normalize(text) {
     return String(text || "")
@@ -22,7 +23,7 @@
     return item[key];
   }
 
-  /* Every query word must appear somewhere; title beats description beats text, and word starts beat the middle. */
+  /* Every query word must appear somewhere; title beats headings beats text, and word starts beat the middle. */
   function search(index, query, limit) {
     var terms = words(query);
     if (!terms.length) return [];
@@ -32,7 +33,7 @@
       var score = 0;
       for (var t = 0; t < terms.length; t++) {
         var s = 0;
-        var parts = [["title", 6], ["description", 3], ["text", 1]];
+        var parts = [["title", 6], ["headings", 3], ["text", 1]];
         for (var p = 0; p < parts.length; p++) {
           var haystack = field(item, parts[p][0]);
           if (haystack.indexOf(" " + terms[t]) >= 0) s += parts[p][1] * 2;
@@ -62,7 +63,7 @@
       if (!loading) {
         loading = fetch(form.getAttribute("data-search"))
           .then(function (r) { return r.json(); })
-          .then(function (data) { index = data; form.hidden = false; return data; });
+          .then(function (data) { index = data; return data; });
       }
       return loading;
     }
@@ -82,7 +83,7 @@
         var note = document.createElement("span");
         a.href = item.url;
         a.textContent = item.title;
-        note.textContent = item.description || item.text.slice(0, 100);
+        note.textContent = item.text.slice(0, 100);
         li.appendChild(a);
         li.appendChild(note);
         list.appendChild(li);
@@ -91,8 +92,8 @@
 
     function links() { return Array.prototype.slice.call(list.querySelectorAll("a")); }
 
-    input.addEventListener("input", function () { show(index ? search(index, input.value) : []); });
-    input.addEventListener("focus", function () { load().then(function () { show(search(index, input.value)); }, function () {}); });
+    input.addEventListener("input", firstUse);
+    input.addEventListener("focus", firstUse);
     form.addEventListener("submit", function (event) {
       event.preventDefault();
       var first = links()[0];
@@ -106,7 +107,8 @@
       else if (event.key === "ArrowUp" && at >= 0) { event.preventDefault(); (items[at - 1] || input).focus(); }
     });
     document.addEventListener("click", function (event) { if (!form.contains(event.target)) panel.hidden = true; });
-    load().then(function () {}, function () {});
+    form.hidden = false;
+    function firstUse() { load().then(function () { show(search(index, input.value)); }, function () {}); }
   }
 
   globalThis.slipwaySearch = { normalize: normalize, search: search };

data/assets/og/template.svg

@@ -0,0 +1,39 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" role="img" aria-labelledby="title">
+  <title id="title">Slipway social card template</title>
+  <!-- Placeholders: ${site}, ${section}, ${title.line1}, ${title.line2}, ${title.line3}, ${url}.
+       Fill them with XML-escaped values and remove the title lines a page does not need.
+       The three line positions are the maximum; a filler moves the remaining lines down so the last sits at y=468.
+       RTL pages: direction="rtl" text-anchor="start" (the right edge) on the title, x=1120 on every tspan, and no letter-spacing on the title or the section.
+       Colors and the mark come from brand/tokens.json and tools/brand/mark.mjs; see docs/adr/0020-social-cards.md. -->
+  <defs>
+    <clipPath id="og-above"><polygon points="-112.6,-51.4 378.9,292.7 545.8,54.3 54.3,-289.8"/></clipPath>
+    <clipPath id="og-below"><polygon points="-122.9,-36.7 368.6,307.4 201.7,545.8 -289.8,201.7"/></clipPath>
+  </defs>
+
+  <rect width="1200" height="630" fill="#17130F"/>
+
+  <g transform="translate(80 64) scale(0.46)" fill="none" stroke-width="16">
+    <g clip-path="url(#og-above)" stroke="#F4EFE4">
+      <circle cx="128" cy="128" r="88"/>
+      <circle cx="128" cy="128" r="58"/>
+    </g>
+    <g clip-path="url(#og-below)" stroke="#B8975A">
+      <circle cx="128" cy="128" r="88"/>
+      <circle cx="128" cy="128" r="58"/>
+    </g>
+  </g>
+
+  <text x="224" y="120" fill="#F4EFE4" font-family="Inter, Vazirmatn, ui-sans-serif, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="34" font-weight="700" letter-spacing="1.2">${site}</text>
+
+  <text x="1120" y="120" fill="#B8975A" font-family="'IBM Plex Mono', Vazirmatn, 'SFMono-Regular', Consolas, 'Liberation Mono', monospace" font-size="22" letter-spacing="3" text-anchor="end">${section}</text>
+
+  <text fill="#F4EFE4" font-family="Inter, Vazirmatn, ui-sans-serif, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="72" font-weight="700" letter-spacing="-1">
+    <tspan x="80" y="300">${title.line1}</tspan>
+    <tspan x="80" y="384">${title.line2}</tspan>
+    <tspan x="80" y="468">${title.line3}</tspan>
+  </text>
+
+  <line x1="80" y1="508" x2="1120" y2="508" stroke="#B8975A" stroke-opacity="0.35" stroke-width="2"/>
+
+  <text x="80" y="545" fill="#A39880" font-family="'IBM Plex Mono', Vazirmatn, 'SFMono-Regular', Consolas, 'Liberation Mono', monospace" font-size="22">${url}</text>
+</svg>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: slipway-theme
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Slipway contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-27 00:00:00.000000000 Z
+date: 2026-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -41,8 +41,33 @@ files:
 - _includes/author-card.html
 - _includes/author-ids.html
 - _includes/author-url.html
+- _includes/blocks/annotations.html
+- _includes/blocks/audio.html
+- _includes/blocks/badge.html
+- _includes/blocks/chart.html
+- _includes/blocks/citation.html
+- _includes/blocks/code-group.html
+- _includes/blocks/compare.html
+- _includes/blocks/diff.html
+- _includes/blocks/download.html
+- _includes/blocks/endpoint.html
+- _includes/blocks/file-tree.html
+- _includes/blocks/gallery.html
+- _includes/blocks/hero.html
+- _includes/blocks/kbd.html
+- _includes/blocks/logos.html
+- _includes/blocks/people.html
+- _includes/blocks/pricing.html
+- _includes/blocks/pull-quote.html
+- _includes/blocks/stats.html
+- _includes/blocks/steps.html
+- _includes/blocks/terminal.html
+- _includes/blocks/testimonial.html
+- _includes/blocks/timeline.html
 - _includes/breadcrumbs.html
 - _includes/byline.html
+- _includes/changelog-version.html
+- _includes/comments.html
 - _includes/compat.html
 - _includes/component-css.html
 - _includes/copy-page.html
@@ -57,18 +82,45 @@ files:
 - _includes/header.html
 - _includes/i18n-builtin.html
 - _includes/i18n/ar.html
+- _includes/i18n/az.html
+- _includes/i18n/bn.html
+- _includes/i18n/ckb.html
+- _includes/i18n/cs.html
+- _includes/i18n/da.html
 - _includes/i18n/de.html
+- _includes/i18n/dv.html
+- _includes/i18n/el.html
 - _includes/i18n/en.html
 - _includes/i18n/es.html
 - _includes/i18n/fa.html
+- _includes/i18n/fi.html
 - _includes/i18n/fr.html
 - _includes/i18n/he.html
+- _includes/i18n/hi.html
+- _includes/i18n/hu.html
+- _includes/i18n/id.html
 - _includes/i18n/it.html
 - _includes/i18n/ja.html
+- _includes/i18n/ko.html
+- _includes/i18n/ms.html
+- _includes/i18n/nb.html
 - _includes/i18n/nl.html
+- _includes/i18n/pl.html
+- _includes/i18n/ps.html
 - _includes/i18n/pt.html
+- _includes/i18n/ro.html
 - _includes/i18n/ru.html
+- _includes/i18n/sd.html
+- _includes/i18n/sv.html
+- _includes/i18n/sw.html
+- _includes/i18n/ta.html
+- _includes/i18n/th.html
 - _includes/i18n/tr.html
+- _includes/i18n/ug.html
+- _includes/i18n/uk.html
+- _includes/i18n/ur.html
+- _includes/i18n/vi.html
+- _includes/i18n/yi.html
 - _includes/i18n/zh.html
 - _includes/icons/github.svg
 - _includes/icons/linkedin.svg
@@ -78,29 +130,38 @@ files:
 - _includes/icons/youtube.svg
 - _includes/jsonld.html
 - _includes/lang-switcher.html
+- _includes/last-updated.html
 - _includes/layout-url.html
 - _includes/llms-item.html
 - _includes/num.html
+- _includes/page-status.html
 - _includes/post-item.html
 - _includes/related-posts.html
+- _includes/schema-table.html
 - _includes/search.html
 - _includes/seo.html
 - _includes/series.html
 - _includes/skip-link.html
+- _includes/snippet.html
 - _includes/t.html
 - _includes/taxonomy.html
 - _includes/term.html
 - _includes/theme-init.html
 - _includes/theme-var.html
 - _includes/theme-vars.html
+- _layouts/adr-index.html
+- _layouts/adr.html
 - _layouts/archive.html
 - _layouts/author.html
 - _layouts/base.html
+- _layouts/changelog-feed.html
+- _layouts/changelog.html
 - _layouts/default.html
 - _layouts/doc.html
 - _layouts/feed.html
 - _layouts/glossary.html
 - _layouts/home.html
+- _layouts/links.html
 - _layouts/llms-full.html
 - _layouts/llms.html
 - _layouts/not-found.html
@@ -111,8 +172,43 @@ files:
 - _layouts/sourcemap.html
 - _layouts/tags.html
 - _layouts/translation-status.html
+- assets/css/components/adr.css
+- assets/css/components/annotations.css
+- assets/css/components/audio.css
+- assets/css/components/badge.css
+- assets/css/components/changelog.css
+- assets/css/components/chart.css
+- assets/css/components/citation.css
+- assets/css/components/code-group.css
+- assets/css/components/compare.css
+- assets/css/components/diff.css
+- assets/css/components/download.css
+- assets/css/components/endpoint.css
+- assets/css/components/file-tree.css
+- assets/css/components/gallery.css
 - assets/css/components/glossary.css
+- assets/css/components/hero.css
+- assets/css/components/kbd.css
+- assets/css/components/logos.css
+- assets/css/components/mirror.css
+- assets/css/components/page-status.css
+- assets/css/components/people.css
+- assets/css/components/pricing.css
+- assets/css/components/pull-quote.css
+- assets/css/components/schema-table.css
+- assets/css/components/stats.css
+- assets/css/components/steps.css
+- assets/css/components/terminal.css
+- assets/css/components/testimonial.css
+- assets/css/components/timeline.css
 - assets/css/fonts.css
+- assets/css/lang/ckb.css
+- assets/css/lang/dv.css
+- assets/css/lang/ps.css
+- assets/css/lang/sd.css
+- assets/css/lang/ug.css
+- assets/css/lang/ur.css
+- assets/css/lang/yi.css
 - assets/css/nav.css
 - assets/css/print.css
 - assets/css/slipway.css
@@ -130,6 +226,7 @@ files:
 - assets/js/edit-prompt.js
 - assets/js/search.js
 - assets/js/theme-toggle.js
+- assets/og/template.svg
 homepage: https://github.com/arminazimi/slipway
 licenses:
 - MIT