slipway-theme 0.1.0

data/_layouts/post.html

@@ -0,0 +1,72 @@
+---
+layout: base
+---
+{%- capture sl_edit_label %}{% include t.html key='edit_label' %}{% endcapture -%}
+{%- capture sl_edit_prompt %}{% include t.html key='edit_prompt' %}{% endcapture -%}
+{%- assign sl_words = content | number_of_words -%}
+{%- assign sl_minutes = sl_words | divided_by: 200.0 | ceil -%}
+{%- if sl_minutes < 1 %}{% assign sl_minutes = 1 %}{% endif -%}
+<article class="sl-post" data-edit-label="{{ sl_edit_label | escape }}" data-edit-prompt="{{ sl_edit_prompt | escape }}">
+  <header class="sl-post-header">
+    <h1>{{ page.title }}</h1>{% include copy-page.html %}
+    <p class="sl-post-meta">
+      <time datetime="{{ page.date | date_to_xmlschema }}">{% include date.html date=page.date %}</time>
+      <span>{% include num.html value=sl_minutes %} {% include t.html key='min_read' %}</span>
+      {%- capture sl_byline %}{% include byline.html page=page %}{% endcapture %}
+      {%- assign sl_byline = sl_byline | strip %}
+      {%- if sl_byline != '' %}
+      {{ sl_byline }}
+      {%- endif %}
+      {%- capture sl_tags_url %}{% include layout-url.html layout='tags' %}{% endcapture %}
+      {%- assign sl_tags_url = sl_tags_url | strip %}
+      {%- if page.tags and page.tags.size > 0 %}
+      <span class="sl-post-tags">
+        {%- for tag in page.tags %}
+        {%- if sl_tags_url != '' %}<a class="sl-tag" href="{{ sl_tags_url }}#tag-{{ tag | slugify }}">{{ tag }}</a>{% else %}<span class="sl-tag">{{ tag }}</span>{% endif %}
+        {%- endfor -%}
+      </span>
+      {%- endif %}
+      {%- if page.categories and page.categories.size > 0 %}
+      <span class="sl-post-tags">
+        {%- for category in page.categories %}
+        {%- if sl_tags_url != '' %}<a class="sl-tag" href="{{ sl_tags_url }}#category-{{ category | slugify }}">{{ category }}</a>{% else %}<span class="sl-tag">{{ category }}</span>{% endif %}
+        {%- endfor -%}
+      </span>
+      {%- endif %}
+    </p>
+  </header>
+  {%- include series.html %}
+  {% include edit-sources.html html=content %}
+  {%- include author-ids.html page=page -%}
+  {%- capture sl_author_cards %}{% for id in sl_ai_ids %}{% include author-card.html id=id link=true %}{% endfor %}{% endcapture %}
+  {%- assign sl_author_cards_clean = sl_author_cards | strip %}
+  {%- if sl_author_cards_clean != '' %}
+  <aside class="sl-authors" aria-label="{% include t.html key='about_author' %}">
+    {{ sl_author_cards_clean }}
+  </aside>
+  {%- endif %}
+  {%- include related-posts.html page=page %}
+  {%- comment -%} Neighbours in the same language: site.posts is newest first, so the post seen before this one is newer. {%- endcomment %}
+  {%- assign sl_lang = page.lang | default: site.lang | default: 'en' -%}
+  {%- assign sl_newer = nil -%}
+  {%- assign sl_older = nil -%}
+  {%- assign sl_last = nil -%}
+  {%- assign sl_found = false -%}
+  {%- for post in site.posts -%}
+    {%- assign sl_post_lang = post.lang | default: site.lang | default: 'en' -%}
+    {%- if sl_post_lang != sl_lang %}{% continue %}{% endif -%}
+    {%- if sl_found -%}{%- assign sl_older = post -%}{%- break -%}{%- endif -%}
+    {%- if post.url == page.url -%}{%- assign sl_found = true -%}{%- assign sl_newer = sl_last -%}{%- endif -%}
+    {%- assign sl_last = post -%}
+  {%- endfor -%}
+  {%- if sl_newer or sl_older %}
+  <nav class="sl-pager" aria-label="{% include t.html key='post_pager' %}">
+    {%- if sl_older %}
+    <a class="sl-pager-prev" rel="prev" href="{{ sl_older.url | relative_url }}"><span>{% include t.html key='previous' %}</span> {{ sl_older.title }}</a>
+    {%- endif %}
+    {%- if sl_newer %}
+    <a class="sl-pager-next" rel="next" href="{{ sl_newer.url | relative_url }}"><span>{% include t.html key='next' %}</span> {{ sl_newer.title }}</a>
+    {%- endif %}
+  </nav>
+  {%- endif %}
+</article>

data/_layouts/search-index.html

@@ -0,0 +1,12 @@
+{%- assign sl_ix_lang = page.lang | default: site.lang | default: 'en' -%}
+{%- assign sl_ix_all = site.pages | concat: site.documents -%}
+{%- assign sl_ix_n = 0 -%}
+[
+{%- for item in sl_ix_all -%}
+  {%- assign sl_ix_item_lang = item.lang | default: site.lang | default: 'en' -%}
+  {%- if sl_ix_item_lang != sl_ix_lang or item.search == false or item.layout == 'search-index' or item.title == nil -%}{%- continue -%}{%- endif -%}
+  {%- if sl_ix_n > 0 -%},{%- endif -%}
+  {%- assign sl_ix_n = sl_ix_n | plus: 1 %}
+{"title":{{ item.title | jsonify }},"url":{{ item.url | relative_url | jsonify }},"description":{{ item.description | default: '' | jsonify }},"text":{{ item.content | markdownify | strip_html | normalize_whitespace | truncate: 600 | jsonify }}}
+{%- endfor %}
+]

data/_layouts/sitemap.html

@@ -0,0 +1,24 @@
+{%- assign sl_m_all = site.pages | concat: site.documents -%}
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">
+{%- for item in sl_m_all -%}
+  {%- if item.sitemap == false or item.layout == 'feed' or item.layout == 'sitemap' or item.layout == 'search-index' or item.url == '/404.html' -%}{%- continue -%}{%- endif -%}
+  {%- assign sl_m_last = item.url | slice: -1 -%}
+  {%- assign sl_m_ext = item.url | split: '.' | last -%}
+  {%- if sl_m_last != '/' and sl_m_ext != 'html' -%}{%- continue -%}{%- endif %}
+  <url>
+    <loc>{{ item.url | absolute_url | xml_escape }}</loc>
+    {%- assign sl_m_mod = item.last_modified_at | default: item.date -%}
+    {%- if sl_m_mod %}
+    <lastmod>{{ sl_m_mod | date_to_xmlschema }}</lastmod>
+    {%- endif %}
+    {%- if item.translation_key %}
+    {%- for other in sl_m_all %}
+    {%- if other.translation_key == item.translation_key %}
+    <xhtml:link rel="alternate" hreflang="{{ other.lang | default: site.lang | default: 'en' }}" href="{{ other.url | absolute_url | xml_escape }}"/>
+    {%- endif %}
+    {%- endfor %}
+    {%- endif %}
+  </url>
+{%- endfor %}
+</urlset>

data/_layouts/sourcemap.html

@@ -0,0 +1,28 @@
+{%- comment -%}
+  /sourcemap.json, level 0 (ADR 0007, spec/sourcemap/v0.md): each content page's url and its source file.
+  Generated files are left out: anything under assets/, the feed, sitemap, search index and this map,
+  Markdown twin stubs, and every url that is not a page (ends in neither / nor .html).
+  Lines are not computed here; ADR 0007 rejects a Liquid line map.
+{%- endcomment -%}
+{%- assign sl_sm_all = site.pages | concat: site.documents -%}
+{%- assign sl_sm_n = 0 -%}
+{"version":0,"pages":[
+{%- for item in sl_sm_all -%}
+  {%- if item.path == nil or item.url == nil -%}{%- continue -%}{%- endif -%}
+  {%- if item.layout == 'feed' or item.layout == 'sitemap' or item.layout == 'search-index' or item.layout == 'sourcemap' -%}{%- continue -%}{%- endif -%}
+  {%- assign sl_sm_head = item.path | slice: 0, 7 -%}
+  {%- if sl_sm_head == 'assets/' -%}{%- continue -%}{%- endif -%}
+  {%- assign sl_sm_ext = item.path | split: '.' | last | downcase -%}
+  {%- if sl_sm_ext == 'xml' or sl_sm_ext == 'json' or sl_sm_ext == 'css' or sl_sm_ext == 'scss' or sl_sm_ext == 'js' or sl_sm_ext == 'txt' -%}{%- continue -%}{%- endif -%}
+  {%- assign sl_sm_last = item.url | slice: -1 -%}
+  {%- assign sl_sm_uext = item.url | split: '.' | last -%}
+  {%- if sl_sm_last != '/' and sl_sm_uext != 'html' -%}{%- continue -%}{%- endif -%}
+  {%- if item.collection -%}
+    {%- assign sl_sm_coll = site.collections | where: 'label', item.collection | first -%}
+    {%- if sl_sm_coll.output == false -%}{%- continue -%}{%- endif -%}
+  {%- endif -%}
+  {%- if sl_sm_n > 0 -%},{%- endif -%}
+  {%- assign sl_sm_n = sl_sm_n | plus: 1 %}
+{"url":{{ item.url | jsonify }},"source":{{ item.path | jsonify }}}
+{%- endfor %}
+]}

data/_layouts/tags.html

@@ -0,0 +1,24 @@
+---
+layout: base
+---
+<article class="sl-page">
+  <header class="sl-page-header">
+    <h1>{{ page.title }}</h1>
+    {%- if page.description %}
+    <p class="sl-page-lead">{{ page.description }}</p>
+    {%- endif %}
+  </header>
+  {{ content }}
+  {%- capture sl_tag_sections %}{% include taxonomy.html terms=site.tags kind="tag" %}{% endcapture %}
+  {%- assign sl_tag_sections_clean = sl_tag_sections | strip %}
+  {%- if sl_tag_sections_clean != '' %}
+  <h2 id="tags">{% include t.html key='tags' %}</h2>
+  {{ sl_tag_sections }}
+  {%- endif %}
+  {%- capture sl_cat_sections %}{% include taxonomy.html terms=site.categories kind="category" %}{% endcapture %}
+  {%- assign sl_cat_sections_clean = sl_cat_sections | strip %}
+  {%- if sl_cat_sections_clean != '' %}
+  <h2 id="categories">{% include t.html key='categories' %}</h2>
+  {{ sl_cat_sections }}
+  {%- endif %}
+</article>

data/_layouts/translation-status.html

@@ -0,0 +1,44 @@
+---
+layout: base
+---
+<article class="sl-page">
+  <header class="sl-page-header">
+    <h1>{{ page.title }}</h1>
+    {%- if page.description %}
+    <p class="sl-page-lead">{{ page.description }}</p>
+    {%- endif %}
+  </header>
+  {{ content }}
+
+  {%- assign sl_all = site.pages | concat: site.documents | where_exp: "item", "item.translation_key != nil" -%}
+  {%- assign sl_keys_raw = sl_all | map: "translation_key" | uniq | sort -%}
+  {%- assign sl_langs = site.slipway.languages -%}
+
+  <div class="sl-table-wrapper">
+    <table>
+      <thead>
+        <tr>
+          <th>{% include t.html key='translation_key' %}|{% include t.html key='translation_key' %}</th>
+          {%- for l in sl_langs %}
+          <th>{{ l.name }}</th>
+          {%- endfor %}
+        </tr>
+      </thead>
+      <tbody>
+        {%- for k in sl_keys_raw %}
+        <tr>
+          <td><code>{{ k }}</code></td>
+          {%- for l in sl_langs %}
+          {%- assign sl_match = sl_all | where: "translation_key", k | where: "lang", l.code | first -%}
+          {%- if sl_match %}
+          <td><a href="{{ sl_match.url | relative_url }}">{{ sl_match.title }}</a></td>
+          {%- else %}
+          <td></td>
+          {%- endif %}
+          {%- endfor %}
+        </tr>
+        {%- endfor %}
+      </tbody>
+    </table>
+  </div>
+</article>

data/assets/css/components/glossary.css

@@ -0,0 +1,21 @@
+/* Glossary components */
+.sl-glossary dt {
+  font-weight: bold;
+  margin-block-start: var(--sl-step-base);
+}
+
+.sl-glossary dd {
+  margin-block-start: calc(var(--sl-step-base) / 4);
+  margin-inline-start: var(--sl-step-base);
+}
+
+.sl-term {
+  text-decoration-style: dotted;
+  text-decoration-thickness: 1px;
+  text-underline-offset: 3px;
+  cursor: help;
+}
+
+.sl-term:hover {
+  text-decoration-style: solid;
+}

data/assets/css/fonts.css

@@ -0,0 +1,47 @@
+/* Self-hosted fonts (ADR 0004), all SIL OFL 1.1; licenses are in assets/fonts/LICENSES/.
+   Faces are split by unicode-range, so a page without Persian text never downloads Vazirmatn. */
+@font-face {
+  font-family: "Instrument Serif";
+  font-style: normal;
+  font-weight: 400;
+  font-display: swap;
+  src: url("../fonts/instrument-serif-latin-400-normal.woff2") format("woff2");
+  unicode-range: U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;
+}
+
+@font-face {
+  font-family: "Instrument Serif";
+  font-style: italic;
+  font-weight: 400;
+  font-display: swap;
+  src: url("../fonts/instrument-serif-latin-400-italic.woff2") format("woff2");
+  unicode-range: U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;
+}
+
+@font-face {
+  font-family: "Source Serif 4";
+  font-style: normal;
+  font-weight: 200 900;
+  font-display: swap;
+  src: url("../fonts/source-serif-4-latin-wght-normal.woff2") format("woff2");
+  unicode-range: U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;
+}
+
+@font-face {
+  font-family: "Source Serif 4";
+  font-style: italic;
+  font-weight: 200 900;
+  font-display: swap;
+  src: url("../fonts/source-serif-4-latin-wght-italic.woff2") format("woff2");
+  unicode-range: U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;
+}
+
+/* Arabic script only: Latin letters on a Persian page come from Source Serif 4. */
+@font-face {
+  font-family: "Vazirmatn";
+  font-style: normal;
+  font-weight: 100 900;
+  font-display: swap;
+  src: url("../fonts/vazirmatn-arabic-wght-normal.woff2") format("woff2");
+  unicode-range: U+0600-06FF,U+0750-077F,U+0870-088E,U+0890-0891,U+0897-08E1,U+08E3-08FF,U+200C-200E,U+2010-2011,U+204F,U+2E41,U+FB50-FDFF,U+FE70-FE74,U+FE76-FEFC;
+}

data/assets/css/nav.css

@@ -0,0 +1,104 @@
+/* Mobile navigation drawer. Included after slipway.css. */
+@layer components {
+  /* Hide the toggle and state on desktop. */
+  .sl-nav-state,
+  .sl-nav-toggle,
+  .sl-nav-backdrop {
+    display: none;
+  }
+
+  /* Desktop: The drawer behaves as if it wasn't there so flexbox layout of sl-header works. */
+  .sl-nav-drawer {
+    display: contents;
+  }
+
+  /* Mobile */
+  @media (max-width: 63.99rem) {
+    .sl-header {
+      flex-wrap: wrap;
+    }
+
+    /* The checkbox holds the open/closed state. */
+    .sl-nav-state {
+      display: none;
+    }
+
+    /* The hamburger button. */
+    .sl-nav-toggle {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      cursor: pointer;
+      color: var(--sl-color-heading);
+      padding: var(--sl-space-2);
+      border-radius: var(--sl-radius-compact);
+      margin-inline-start: auto;
+      transition: background-color var(--sl-motion-fast);
+    }
+
+    .sl-nav-toggle:hover {
+      background-color: var(--sl-color-surface);
+    }
+
+    .sl-nav-toggle svg {
+      inline-size: 1.5rem;
+      block-size: 1.5rem;
+      fill: currentColor;
+    }
+
+    /* The drawer that slides in. */
+    .sl-nav-drawer {
+      display: block;
+      position: fixed;
+      inset-block: 0;
+      inset-inline-start: -100%; /* Hidden off-screen logically */
+      inline-size: 80%;
+      max-inline-size: 20rem;
+      background: var(--sl-color-canvas);
+      z-index: 100;
+      padding: var(--sl-space-6) var(--sl-space-4);
+      box-shadow: 0 0 10px rgba(0, 0, 0, 0.2);
+      transition: inset-inline-start var(--sl-motion-normal) ease-in-out;
+      overflow-y: auto;
+    }
+
+    /* The dark overlay behind the drawer. */
+    .sl-nav-backdrop {
+      display: block;
+      position: fixed;
+      inset: 0;
+      background: rgba(0, 0, 0, 0.5);
+      z-index: 90;
+      opacity: 0;
+      pointer-events: none;
+      transition: opacity var(--sl-motion-normal) ease-in-out;
+    }
+
+    /* When the checkbox is checked, slide the drawer in and show the backdrop. */
+    .sl-nav-state:checked ~ .sl-nav-backdrop {
+      opacity: 1;
+      pointer-events: auto;
+      cursor: pointer;
+    }
+
+    .sl-nav-state:checked ~ .sl-nav-drawer {
+      inset-inline-start: 0;
+    }
+
+    /* Force mobile nav items to stack vertically. */
+    .sl-nav-drawer .sl-main-nav {
+      margin-block-start: var(--sl-space-4);
+    }
+
+    .sl-nav-drawer .sl-main-nav ul {
+      flex-direction: column;
+      gap: var(--sl-space-4);
+    }
+
+    .sl-nav-drawer .sl-main-nav a {
+      font-size: var(--sl-step-lg);
+      display: block;
+      padding-block: var(--sl-space-2);
+    }
+  }
+}

data/assets/css/print.css

@@ -0,0 +1,70 @@
+/* Print: the light palette, no chrome, and the address after each external link. Logical properties only. */
+@page {
+  margin: 2cm;
+}
+
+:root,
+:root[data-theme] {
+  color-scheme: light;
+}
+
+html {
+  background: none;
+}
+
+body {
+  font-size: 11pt;
+  line-height: 1.5;
+}
+
+.sl-header,
+.sl-theme-toggle,
+nav {
+  display: none;
+}
+
+main {
+  max-inline-size: none;
+  padding-inline: 0;
+}
+
+.sl-wide,
+.sl-bleed {
+  inline-size: auto;
+  margin-inline: 0;
+}
+
+h1,
+h2,
+h3 {
+  break-after: avoid;
+}
+
+pre,
+img,
+blockquote {
+  break-inside: avoid;
+}
+
+pre {
+  white-space: pre-wrap;
+}
+
+a {
+  color: inherit;
+}
+
+a[href^="http"]::after {
+  content: " (" attr(href) ")";
+  font-size: 0.85em;
+  color: var(--sl-color-muted);
+  overflow-wrap: anywhere;
+}
+
+.sl-copy {
+  display: none;
+}
+
+.sl-edit {
+  display: none;
+}