slipway-theme 0.1.0

data/_includes/seo.html

@@ -0,0 +1,42 @@
+{%- comment %} Canonical, Open Graph, Twitter card, and hreflang alternates. Plain Liquid, so classic Pages needs no jekyll-seo-tag. Expects sl_desc from head.html. {% endcomment %}
+{%- assign sl_seo_lang = page.lang | default: site.lang | default: 'en' %}
+{%- assign sl_seo_url = page.url | absolute_url %}
+{%- assign sl_seo_title = page.title | default: site.title %}
+  <link rel="canonical" href="{{ sl_seo_url }}">
+  <meta property="og:type" content="{% if page.collection == 'posts' %}article{% else %}website{% endif %}">
+  <meta property="og:url" content="{{ sl_seo_url }}">
+  {%- if sl_seo_title %}
+  <meta property="og:title" content="{{ sl_seo_title | escape }}">
+  {%- endif %}
+  {%- if site.title %}
+  <meta property="og:site_name" content="{{ site.title | escape }}">
+  {%- endif %}
+  {%- if sl_desc != '' %}
+  <meta property="og:description" content="{{ sl_desc | escape }}">
+  {%- endif %}
+  <meta property="og:image" content="{{ '/assets/images/social.png' | absolute_url }}">
+  <meta property="og:image:width" content="1200">
+  <meta property="og:image:height" content="630">
+  <meta property="og:locale" content="{{ sl_seo_lang | replace: '-', '_' }}">
+  {%- if page.collection == 'posts' and page.date %}
+  <meta property="article:published_time" content="{{ page.date | date_to_xmlschema }}">
+  {%- for tag in page.tags %}
+  <meta property="article:tag" content="{{ tag | escape }}">
+  {%- endfor %}
+  {%- endif %}
+  <meta name="twitter:card" content="summary">
+  {%- if page.translation_key %}
+  {%- assign sl_seo_alts = site.pages | concat: site.documents | where: 'translation_key', page.translation_key %}
+  {%- if sl_seo_alts.size > 1 %}
+  {%- for alt in sl_seo_alts %}
+  {%- assign sl_alt_lang = alt.lang | default: site.lang | default: 'en' %}
+  <link rel="alternate" hreflang="{{ sl_alt_lang }}" href="{{ alt.url | absolute_url }}">
+  {%- if sl_alt_lang != sl_seo_lang %}
+  <meta property="og:locale:alternate" content="{{ sl_alt_lang | replace: '-', '_' }}">
+  {%- endif %}
+  {%- if sl_alt_lang == site.lang %}
+  <link rel="alternate" hreflang="x-default" href="{{ alt.url | absolute_url }}">
+  {%- endif %}
+  {%- endfor %}
+  {%- endif %}
+  {%- endif %}

data/_includes/series.html

@@ -0,0 +1,47 @@
+{%- comment -%} The series box of a post: every post with the same `series` in the same language, oldest first, this post's part, and the previous and next part. Prints nothing when the post is alone in its series. {%- endcomment -%}
+{%- if page.series -%}
+{%- assign sl_s_lang = page.lang | default: site.lang | default: 'en' -%}
+{%- assign sl_s_all = site.posts | where: 'series', page.series | reverse -%}
+{%- assign sl_s_posts = '' | split: '' -%}
+{%- for post in sl_s_all -%}
+  {%- assign sl_s_post_lang = post.lang | default: site.lang | default: 'en' -%}
+  {%- if sl_s_post_lang == sl_s_lang %}{% assign sl_s_posts = sl_s_posts | push: post %}{% endif -%}
+{%- endfor -%}
+{%- assign sl_s_index = 0 -%}
+{%- for post in sl_s_posts -%}
+  {%- if post.url == page.url %}{% assign sl_s_index = forloop.index %}{% endif -%}
+{%- endfor -%}
+{%- if sl_s_index > 0 and sl_s_posts.size > 1 -%}
+{%- assign sl_s_prev = nil -%}
+{%- assign sl_s_next = nil -%}
+{%- if sl_s_index > 1 %}{% assign sl_s_i = sl_s_index | minus: 2 %}{% assign sl_s_prev = sl_s_posts[sl_s_i] %}{% endif -%}
+{%- if sl_s_index < sl_s_posts.size %}{% assign sl_s_next = sl_s_posts[sl_s_index] %}{% endif -%}
+{%- capture sl_s_n %}{% include num.html value=sl_s_index %}{% endcapture -%}
+{%- capture sl_s_total %}{% include num.html value=sl_s_posts.size %}{% endcapture -%}
+{%- capture sl_s_part %}{% include t.html key='series_part' %}{% endcapture -%}
+{%- assign sl_s_ph_n = '{n}' -%}
+{%- assign sl_s_ph_total = '{total}' -%}
+{%- assign sl_s_part = sl_s_part | replace: sl_s_ph_n, sl_s_n | replace: sl_s_ph_total, sl_s_total %}
+<aside class="sl-series" aria-labelledby="sl-series-title">
+  <p class="sl-series-title" id="sl-series-title"><span>{% include t.html key='series' %}</span> {{ page.series | escape }}</p>
+  <p class="sl-series-part">{{ sl_s_part }}</p>
+  <ol class="sl-series-list">
+    {%- for post in sl_s_posts %}
+    {%- if forloop.index == sl_s_index %}
+    <li aria-current="page">{{ post.title }}</li>
+    {%- else %}
+    <li><a href="{{ post.url | relative_url }}">{{ post.title }}</a></li>
+    {%- endif %}
+    {%- endfor %}
+  </ol>
+  <nav class="sl-series-pager" aria-label="{% include t.html key='series_pager' %}">
+    {%- if sl_s_prev %}
+    <a class="sl-series-prev" href="{{ sl_s_prev.url | relative_url }}"><span>{% include t.html key='previous' %}</span> {{ sl_s_prev.title }}</a>
+    {%- endif %}
+    {%- if sl_s_next %}
+    <a class="sl-series-next" href="{{ sl_s_next.url | relative_url }}"><span>{% include t.html key='next' %}</span> {{ sl_s_next.title }}</a>
+    {%- endif %}
+  </nav>
+</aside>
+{%- endif -%}
+{%- endif -%}

data/_includes/skip-link.html

@@ -0,0 +1 @@
+<a class="sl-skip-link" href="#main">{% include t.html key='skip' %}</a>

data/_includes/t.html

@@ -0,0 +1,4 @@
+{%- assign sl_t_lang = include.lang | default: page.lang | default: site.lang | default: 'en' -%}
+{%- assign sl_t_base = sl_t_lang | split: '-' | first -%}
+{%- assign sl_t_value = site.data.i18n[sl_t_lang][include.key] | default: site.data.i18n[sl_t_base][include.key] -%}
+{%- if sl_t_value -%}{{ sl_t_value }}{%- else -%}{% include i18n-builtin.html lang=sl_t_base key=include.key %}{%- endif -%}

data/_includes/taxonomy.html

@@ -0,0 +1,22 @@
+{%- comment -%}
+  One section per term of include.terms (site.tags or site.categories), with the posts of the current language.
+  include.kind is "tag" or "category"; headings get the id "<kind>-<slug>" so posts can link to them.
+{%- endcomment -%}
+{%- assign sl_x_lang = page.lang | default: site.lang | default: 'en' -%}
+{%- assign sl_x_pairs = include.terms | sort -%}
+{%- for pair in sl_x_pairs -%}
+  {%- assign sl_x_count = 0 -%}
+  {%- capture sl_x_items -%}
+    {%- for post in pair[1] -%}
+      {%- assign sl_x_post_lang = post.lang | default: site.lang | default: 'en' -%}
+      {%- if sl_x_post_lang != sl_x_lang %}{% continue %}{% endif -%}
+      {%- assign sl_x_count = sl_x_count | plus: 1 %}
+  {% include post-item.html post=post %}
+    {%- endfor -%}
+  {%- endcapture -%}
+  {%- if sl_x_count > 0 %}
+<h3 id="{{ include.kind }}-{{ pair[0] | slugify }}">{{ pair[0] }} <span class="sl-count">({% include num.html value=sl_x_count %})</span></h3>
+<ul class="sl-post-list">{{ sl_x_items }}
+</ul>
+  {%- endif -%}
+{%- endfor -%}

data/_includes/term.html

@@ -0,0 +1,7 @@
+{%- comment -%} Renders a link to a glossary term. {%- endcomment -%}
+{%- assign sl_term = site.data.glossary | where: "id", include.id | first -%}
+{%- if sl_term -%}
+{%- include component-css.html name="glossary" -%}
+{%- capture sl_glossary_url -%}{% include layout-url.html layout="glossary" %}{%- endcapture -%}
+<a href="{{ sl_glossary_url | strip }}#{{ sl_term.id }}" class="sl-term" title="{{ sl_term.definition | escape }}">{{ sl_term.term }}</a>
+{%- endif -%}

data/_includes/theme-init.html

@@ -0,0 +1 @@
+<script>try{var t=localStorage.getItem("slipway-theme");if(t==="light"||t==="dark")document.documentElement.dataset.theme=t}catch(e){}</script>

data/_includes/theme-var.html

@@ -0,0 +1,4 @@
+{%- if include.value -%}
+{%- assign v = include.value | remove: "<" | remove: ">" | remove: "{" | remove: "}" | remove: ";" | remove: "\" -%}
+ {{ include.name }}: {{ v }};
+{%- endif -%}

data/_includes/theme-vars.html

@@ -0,0 +1,17 @@
+{%- assign t = site.slipway.tokens -%}
+{%- assign fonts = site.slipway.fonts -%}
+{%- if t or fonts == "system" -%}
+<style>:root {
+{%- if fonts == "system" -%}
+  --sl-font-display: var(--sl-font-ui);
+  --sl-font-body: var(--sl-font-ui);
+  --sl-font-persian: var(--sl-font-arabic);
+{%- endif -%}
+{%- include theme-var.html name="--sl-color-rose" value=t.accent -%}
+{%- include theme-var.html name="--sl-color-rose-fill" value=t.accent -%}
+{%- include theme-var.html name="--sl-color-canvas" value=t.canvas -%}
+{%- include theme-var.html name="--sl-color-text" value=t.text -%}
+{%- include theme-var.html name="--sl-font-display" value=t.font_display -%}
+{%- include theme-var.html name="--sl-font-body" value=t.font_body -%}
+{%- include theme-var.html name="--sl-radius-card" value=t.radius %} }</style>
+{%- endif -%}

data/_layouts/archive.html

@@ -0,0 +1,32 @@
+---
+layout: base
+---
+{%- assign sl_lang = page.lang | default: site.lang | default: 'en' -%}
+<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 }}
+  {%- comment -%} Posts come newest first; a new heading starts whenever the year (Jalali when opted in) changes. {%- endcomment %}
+  {%- assign sl_year = '' -%}
+  {%- for post in site.posts -%}
+    {%- assign sl_post_lang = post.lang | default: site.lang | default: 'en' -%}
+    {%- if sl_post_lang != sl_lang %}{% continue %}{% endif -%}
+    {%- capture sl_date_unused %}{% include date.html date=post.date %}{% endcapture -%}
+    {%- if sl_d_year != sl_year -%}
+      {%- unless sl_year == '' %}
+  </ul>
+      {%- endunless %}
+  <h2 id="year-{{ sl_d_year }}">{% include num.html value=sl_d_year %}</h2>
+  <ul class="sl-post-list">
+      {%- assign sl_year = sl_d_year -%}
+    {%- endif %}
+  {% include post-item.html post=post %}
+  {%- endfor %}
+  {%- unless sl_year == '' %}
+  </ul>
+  {%- endunless %}
+</article>

data/_layouts/author.html

@@ -0,0 +1,31 @@
+---
+layout: base
+---
+{%- comment -%} One author's page: `author` in the front matter is a key of _data/authors.yml. Lists that author's posts in the page's language. {%- endcomment -%}
+{%- assign sl_lang = page.lang | default: site.lang | default: 'en' -%}
+<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 %}
+    {% include author-card.html id=page.author %}
+  </header>
+  {{ content }}
+  {%- assign sl_count = 0 -%}
+  {%- capture sl_items -%}
+    {%- for post in site.posts -%}
+      {%- assign sl_post_lang = post.lang | default: site.lang | default: 'en' -%}
+      {%- if sl_post_lang != sl_lang %}{% continue %}{% endif -%}
+      {%- include author-ids.html page=post -%}
+      {%- unless sl_ai_ids contains page.author %}{% continue %}{% endunless -%}
+      {%- assign sl_count = sl_count | plus: 1 %}
+  {% include post-item.html post=post %}
+    {%- endfor -%}
+  {%- endcapture -%}
+  {%- if sl_count > 0 %}
+  <h2 id="posts">{% include t.html key='posts' %} <span class="sl-count">({% include num.html value=sl_count %})</span></h2>
+  <ul class="sl-post-list">{{ sl_items }}
+  </ul>
+  {%- endif %}
+</article>

data/_layouts/base.html

@@ -0,0 +1,19 @@
+{%- assign sl_lang = page.lang | default: site.lang | default: 'en' -%}
+{%- assign sl_base = sl_lang | split: '-' | first -%}
+{%- assign sl_dir = page.direction | default: site.direction -%}
+{%- unless sl_dir -%}
+  {%- capture sl_dir %}{% include dir.html lang=sl_lang %}{% endcapture -%}
+{%- endunless -%}
+<!doctype html>
+<html lang="{{ sl_lang }}" dir="{{ sl_dir }}">
+{% include head.html %}
+<body{% if sl_base == 'fa' and site.slipway.persian.digits %} class="sl-fa-digits"{% elsif sl_base == 'ar' and site.slipway.arabic.digits %} class="sl-ar-digits"{% endif %} data-copy="{% include t.html key='copy' %}" data-copied="{% include t.html key='copied' %}" data-copy-failed="{% include t.html key='copy_failed' %}">
+  {% include skip-link.html %}
+  {% include header.html %}
+  {%- assign sl_width = page.width | downcase -%}
+  <main id="main" class="sl-sections sl-layout-{{ page.layout }}{% if sl_width == 'narrow' or sl_width == 'wide' or sl_width == 'full' %} sl-width-{{ sl_width }}{% endif %}" tabindex="-1">
+    {{ content }}
+  </main>
+  {% include footer.html %}
+</body>
+</html>

data/_layouts/default.html

@@ -0,0 +1,4 @@
+---
+layout: base
+---
+{{ content }}

data/_layouts/doc.html

@@ -0,0 +1,89 @@
+---
+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_nav_lang = page.lang | default: site.lang | default: 'en' | split: '-' | first -%}
+{%- assign sl_nav_key = 'docs_' | append: sl_nav_lang -%}
+{%- assign sl_tree = site.data.navigation[sl_nav_key] | default: site.data.navigation.docs -%}
+{%- comment -%} Flatten the leaves, in reading order, to "url||title" entries for the previous/next links. {%- endcomment -%}
+{%- capture sl_flat_text -%}
+  {%- for item in sl_tree -%}
+    {%- if item.children -%}
+      {%- for child in item.children -%}{{ child.url }}||{{ child.title }}@@{%- endfor -%}
+    {%- else -%}{{ item.url }}||{{ item.title }}@@{%- endif -%}
+  {%- endfor -%}
+{%- endcapture -%}
+{%- assign sl_items = sl_flat_text | split: '@@' -%}
+{%- assign sl_index = -1 -%}
+{%- for entry in sl_items -%}
+  {%- assign sl_entry_url = entry | split: '||' | first -%}
+  {%- if sl_entry_url == page.url %}{% assign sl_index = forloop.index0 %}{% endif -%}
+{%- endfor -%}
+<div class="sl-doc">
+  {%- if sl_tree.size > 0 %}
+  <details class="sl-doc-nav">
+    <summary>{% include t.html key='docs_nav' %}</summary>
+    <nav aria-label="{% include t.html key='docs_nav' %}">
+      <ul>
+        {%- for item in sl_tree %}
+        {%- if item.children %}
+        <li class="sl-doc-group">{{ item.title }}
+          <ul>
+            {%- for child in item.children %}
+            <li><a href="{{ child.url | relative_url }}"{% if child.url == page.url %} aria-current="page"{% endif %}>{{ child.title }}</a></li>
+            {%- endfor %}
+          </ul>
+        </li>
+        {%- else %}
+        <li><a href="{{ item.url | relative_url }}"{% if item.url == page.url %} aria-current="page"{% endif %}>{{ item.title }}</a></li>
+        {%- endif %}
+        {%- endfor %}
+      </ul>
+    </nav>
+  </details>
+  {%- endif %}
+
+  <article class="sl-doc-body" data-edit-label="{{ sl_edit_label | escape }}" data-edit-prompt="{{ sl_edit_prompt | escape }}">
+    {% include breadcrumbs.html %}
+    <h1>{{ page.title }}</h1>{% include copy-page.html %}
+    {%- assign sl_parts = content | split: '<h' -%}
+    {%- capture sl_toc_html -%}
+      {%- for part in sl_parts offset: 1 -%}
+        {%- assign sl_level = part | slice: 0, 1 -%}
+        {%- if sl_level == '2' or sl_level == '3' -%}
+          {%- assign sl_head = part | split: '</h' | first -%}
+          {%- assign sl_id = sl_head | split: 'id="' | last | split: '"' | first -%}
+          {%- if sl_head contains 'id="' %}
+          <li class="sl-toc-{{ sl_level }}"><a href="#{{ sl_id }}">{{ sl_head | split: '">' | last | strip_html }}</a></li>
+          {%- endif -%}
+        {%- endif -%}
+      {%- endfor -%}
+    {%- endcapture -%}
+    {%- assign sl_toc_trim = sl_toc_html | strip -%}
+    {%- if sl_toc_trim != '' %}
+    <nav class="sl-toc" aria-label="{% include t.html key='on_this_page' %}">
+      <p class="sl-toc-title">{% include t.html key='on_this_page' %}</p>
+      <ul>{{ sl_toc_html }}
+      </ul>
+    </nav>
+    {%- endif %}
+    {% include edit-sources.html html=content %}
+    {% include feedback.html %}
+
+    {%- if sl_index >= 0 %}
+    {%- assign sl_prev_index = sl_index | minus: 1 -%}
+    {%- assign sl_next_index = sl_index | plus: 1 %}
+    <nav class="sl-pager" aria-label="{% include t.html key='pager' %}">
+      {%- if sl_index > 0 %}
+      {%- assign sl_prev = sl_items[sl_prev_index] | split: '||' %}
+      <a class="sl-pager-prev" rel="prev" href="{{ sl_prev[0] | relative_url }}"><span>{% include t.html key='previous' %}</span> {{ sl_prev[1] }}</a>
+      {%- endif %}
+      {%- if sl_next_index < sl_items.size and sl_items[sl_next_index] != '' %}
+      {%- assign sl_next = sl_items[sl_next_index] | split: '||' %}
+      <a class="sl-pager-next" rel="next" href="{{ sl_next[0] | relative_url }}"><span>{% include t.html key='next' %}</span> {{ sl_next[1] }}</a>
+      {%- endif %}
+    </nav>
+    {%- endif %}
+  </article>
+</div>

data/_layouts/feed.html

@@ -0,0 +1,37 @@
+{%- assign sl_f_lang = page.lang | default: site.lang | default: 'en' -%}
+{%- assign sl_f_prefix = '' -%}
+{%- for l in site.slipway.languages -%}
+  {%- if l.code == sl_f_lang -%}{%- assign sl_f_prefix = l.prefix -%}{%- endif -%}
+{%- endfor -%}
+{%- assign sl_f_count = 0 -%}
+{%- assign sl_f_updated = site.time -%}
+{%- capture sl_f_entries -%}
+  {%- for post in site.posts -%}
+    {%- assign sl_f_post_lang = post.lang | default: site.lang | default: 'en' -%}
+    {%- if sl_f_post_lang != sl_f_lang %}{% continue %}{% endif -%}
+    {%- if sl_f_count == 0 %}{% assign sl_f_updated = post.last_modified_at | default: post.date %}{% endif -%}
+    {%- if sl_f_count == 20 %}{% break %}{% endif -%}
+    {%- assign sl_f_count = sl_f_count | plus: 1 %}
+  <entry>
+    <title>{{ post.title | xml_escape }}</title>
+    <link href="{{ post.url | absolute_url }}" rel="alternate" type="text/html"/>
+    <id>{{ post.url | absolute_url }}</id>
+    <published>{{ post.date | date_to_xmlschema }}</published>
+    <updated>{{ post.last_modified_at | default: post.date | date_to_xmlschema }}</updated>
+    {%- if post.description %}
+    <summary>{{ post.description | xml_escape }}</summary>
+    {%- endif %}
+  </entry>
+  {%- endfor -%}
+{%- endcapture -%}
+<?xml version="1.0" encoding="utf-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="{{ sl_f_lang }}">
+  <title>{{ site.title | xml_escape }}</title>
+  <link href="{{ page.url | absolute_url }}" rel="self" type="application/atom+xml"/>
+  <link href="{{ sl_f_prefix | append: '/' | absolute_url }}" rel="alternate" type="text/html"/>
+  <id>{{ page.url | absolute_url }}</id>
+  <updated>{{ sl_f_updated | date_to_xmlschema }}</updated>
+  <author>
+    <name>{{ site.author.name | default: site.author | default: site.title | xml_escape }}</name>
+  </author>{{ sl_f_entries }}
+</feed>

data/_layouts/glossary.html

@@ -0,0 +1,23 @@
+---
+layout: base
+---
+{% include component-css.html name="glossary" %}
+<article class="sl-page">
+  <header class="sl-page-header">
+    {% include breadcrumbs.html %}
+    <h1>{{ page.title }}</h1>{% include copy-page.html %}
+    {%- if page.description %}
+    <p class="sl-page-lead">{{ page.description }}</p>
+    {%- endif %}
+  </header>
+  {{ content }}
+  {%- if site.data.glossary %}
+  <dl class="sl-glossary">
+    {%- assign sl_terms = site.data.glossary | sort: "term" %}
+    {%- for sl_term in sl_terms %}
+    <dt id="{{ sl_term.id }}">{{ sl_term.term }}</dt>
+    <dd>{{ sl_term.definition }}</dd>
+    {%- endfor %}
+  </dl>
+  {%- endif %}
+</article>

data/_layouts/home.html

@@ -0,0 +1,96 @@
+---
+layout: base
+---
+{%- comment -%}
+  Four variants, picked by `variant` in the front matter:
+  editorial (the default): a large hero, the body, then the latest posts;
+  landing: the hero, the body, a grid of `features`, and the call to action again;
+  blog: a compact heading, the body, then every post (or `posts_limit` of them);
+  docs: the hero, the body, then the docs navigation as cards.
+{%- endcomment -%}
+{%- assign sl_variant = page.variant | default: 'editorial' -%}
+{%- assign sl_lang = page.lang | default: site.lang | default: 'en' -%}
+{%- if sl_variant == 'blog' %}
+<header class="sl-home-head">
+  <h1 class="sl-home-title">{{ page.title }}</h1>
+  {%- if page.description %}
+  <p class="sl-hero-lead">{{ page.description }}</p>
+  {%- endif %}
+  {%- if page.cta_text and page.cta_url %}
+  <p><a class="sl-button" href="{{ page.cta_url | relative_url }}">{{ page.cta_text }}</a></p>
+  {%- endif %}
+</header>
+{%- else %}
+<section class="sl-hero sl-hero-{{ sl_variant }}">
+  <h1 class="sl-hero-title">{{ page.title }}</h1>
+  {%- if page.description %}
+  <p class="sl-hero-lead">{{ page.description }}</p>
+  {%- endif %}
+  {%- if page.cta_text and page.cta_url %}
+  <p><a class="sl-button" href="{{ page.cta_url | relative_url }}">{{ page.cta_text }}</a></p>
+  {%- endif %}
+</section>
+{%- endif %}
+{{ content }}
+{%- if sl_variant == 'landing' %}
+{%- if page.features.size > 0 %}
+<ul class="sl-features">
+  {%- for feature in page.features %}
+  <li class="sl-feature">
+    <h2 class="sl-feature-title">{% if feature.url %}<a href="{{ feature.url | relative_url }}">{{ feature.title }}</a>{% else %}{{ feature.title }}{% endif %}</h2>
+    {%- if feature.text %}
+    <p>{{ feature.text }}</p>
+    {%- endif %}
+  </li>
+  {%- endfor %}
+</ul>
+{%- endif %}
+{%- if page.cta_text and page.cta_url %}
+<p class="sl-cta-band"><a class="sl-button" href="{{ page.cta_url | relative_url }}">{{ page.cta_text }}</a></p>
+{%- endif %}
+{%- elsif sl_variant == 'docs' %}
+{%- assign sl_nav_lang = sl_lang | split: '-' | first -%}
+{%- assign sl_nav_key = 'docs_' | append: sl_nav_lang -%}
+{%- assign sl_tree = site.data.navigation[sl_nav_key] | default: site.data.navigation.docs -%}
+{%- if sl_tree.size > 0 %}
+<nav class="sl-doc-index" aria-labelledby="sl-doc-index-title">
+  <h2 id="sl-doc-index-title">{% include t.html key='docs_nav' %}</h2>
+  <ul class="sl-features">
+    {%- for item in sl_tree %}
+    <li class="sl-feature">
+      {%- if item.children %}
+      <h3 class="sl-feature-title">{{ item.title }}</h3>
+      <ul>
+        {%- for child in item.children %}
+        <li><a href="{{ child.url | relative_url }}">{{ child.title }}</a></li>
+        {%- endfor %}
+      </ul>
+      {%- else %}
+      <h3 class="sl-feature-title"><a href="{{ item.url | relative_url }}">{{ item.title }}</a></h3>
+      {%- endif %}
+    </li>
+    {%- endfor %}
+  </ul>
+</nav>
+{%- endif %}
+{%- else %}
+{%- if sl_variant == 'blog' -%}
+  {%- assign sl_limit = page.posts_limit | default: site.posts.size -%}
+{%- else -%}
+  {%- assign sl_limit = page.posts_limit | default: 5 -%}
+{%- endif -%}
+{%- assign sl_shown = 0 -%}
+{%- capture sl_items -%}
+  {%- for post in site.posts -%}
+    {%- if post.lang and post.lang != sl_lang %}{% continue %}{% endif -%}
+    {%- if sl_shown >= sl_limit %}{% break %}{% endif -%}
+    {%- assign sl_shown = sl_shown | plus: 1 %}
+  {% include post-item.html post=post %}
+  {%- endfor -%}
+{%- endcapture -%}
+{%- if sl_shown > 0 %}
+<h2>{% if sl_variant == 'blog' %}{% include t.html key='posts' %}{% else %}{% include t.html key='latest_posts' %}{% endif %}</h2>
+<ul class="sl-post-list">{{ sl_items }}
+</ul>
+{%- endif %}
+{%- endif %}

data/_layouts/llms-full.html

@@ -0,0 +1,54 @@
+{%- comment -%}
+  /llms-full.txt: the text of every page that /llms.txt lists, in the same order, each under its
+  title and address. Liquid cannot read a page's Markdown source (ADR 0006), so the text comes from
+  the HTML: headings, list items, and code blocks keep Markdown markers; other tags are removed.
+{%- endcomment -%}
+{%- assign sl_lf_all = site.pages | concat: site.documents -%}
+{%- capture sl_lf_nl %}
+{% endcapture -%}
+{%- assign sl_lf_gap = sl_lf_nl | append: sl_lf_nl -%}
+{%- assign sl_lf_wide = sl_lf_gap | append: sl_lf_nl -%}
+{%- assign sl_lf_open = '```' | append: sl_lf_nl | append: '<pre' -%}
+{%- assign sl_lf_close = '</pre>```' | append: sl_lf_gap -%}
+# {{ site.title | default: 'Untitled' }}
+{%- if site.description %}
+
+> {{ site.description | strip_newlines }}
+{%- endif %}
+{%- for sl_lf_group in (1..3) -%}
+  {%- case sl_lf_group -%}{%- when 1 -%}{%- assign sl_lf_name = 'Docs' -%}{%- when 2 -%}{%- assign sl_lf_name = 'Posts' -%}{%- else -%}{%- assign sl_lf_name = 'Pages' -%}{%- endcase -%}
+  {%- for item in sl_lf_all -%}
+    {%- include llms-item.html item=item -%}
+    {%- if sl_li_group != sl_lf_name -%}{%- continue -%}{%- endif -%}
+    {%- assign sl_lf_text = item.content | markdownify
+      | replace: '<h1', '# <h1' | replace: '<h2', '## <h2' | replace: '<h3', '### <h3'
+      | replace: '<h4', '#### <h4' | replace: '<h5', '##### <h5' | replace: '<h6', '###### <h6'
+      | replace: '<li', '- <li' | replace: '<br', sl_lf_nl
+      | replace: '<pre', sl_lf_open | replace: '</pre>', sl_lf_close
+      | replace: '</p>', sl_lf_gap | replace: '</h1>', sl_lf_gap | replace: '</h2>', sl_lf_gap
+      | replace: '</h3>', sl_lf_gap | replace: '</h4>', sl_lf_gap | replace: '</h5>', sl_lf_gap
+      | replace: '</h6>', sl_lf_gap | replace: '</ul>', sl_lf_gap | replace: '</ol>', sl_lf_gap
+      | replace: '</blockquote>', sl_lf_gap | replace: '</table>', sl_lf_gap | replace: '</div>', sl_lf_nl
+      | strip_html
+      | replace: '&lt;', '<' | replace: '&gt;', '>' | replace: '&quot;', '"' | replace: '&#39;', "'"
+      | replace: '&ldquo;', '“' | replace: '&rdquo;', '”' | replace: '&lsquo;', '‘' | replace: '&rsquo;', '’'
+      | replace: '&hellip;', '…' | replace: '&ndash;', '–' | replace: '&mdash;', '—' | replace: '&nbsp;', ' '
+      | replace: '&laquo;', '«' | replace: '&raquo;', '»' | replace: '&amp;', '&' -%}
+    {%- for i in (1..4) -%}{%- assign sl_lf_text = sl_lf_text | replace: sl_lf_wide, sl_lf_gap -%}{%- endfor -%}
+    {%- assign sl_lf_text = sl_lf_text | strip %}
+
+---
+
+# {{ item.title | default: item.url | strip_newlines }}
+
+Source: {{ item.url | absolute_url }}
+{%- if item.description %}
+
+{{ item.description | strip_newlines }}
+{%- endif %}
+{%- if sl_lf_text != '' %}
+
+{{ sl_lf_text }}
+{%- endif -%}
+  {%- endfor -%}
+{%- endfor %}

data/_layouts/llms.html

@@ -0,0 +1,32 @@
+{%- comment -%}
+  /llms.txt (https://llmstxt.org): the site title, its description, and one link per page with its
+  description, in sections Docs, Posts and Pages. Pages are chosen by llms-item.html.
+{%- endcomment -%}
+{%- assign sl_ll_all = site.pages | concat: site.documents -%}
+{%- assign sl_ll_full = nil -%}
+{%- for p in site.pages -%}{%- if p.layout == 'llms-full' -%}{%- assign sl_ll_full = p -%}{%- break -%}{%- endif -%}{%- endfor -%}
+# {{ site.title | default: 'Untitled' }}
+{%- if site.description %}
+
+> {{ site.description | strip_newlines }}
+{%- endif %}
+{%- if sl_ll_full %}
+
+The full text of every page is in [{{ sl_ll_full.url | remove_first: '/' }}]({{ sl_ll_full.url | absolute_url }}).
+{%- endif %}
+{%- for sl_ll_group in (1..3) -%}
+  {%- case sl_ll_group -%}{%- when 1 -%}{%- assign sl_ll_name = 'Docs' -%}{%- when 2 -%}{%- assign sl_ll_name = 'Posts' -%}{%- else -%}{%- assign sl_ll_name = 'Pages' -%}{%- endcase -%}
+  {%- capture sl_ll_lines -%}
+    {%- for item in sl_ll_all -%}
+      {%- include llms-item.html item=item -%}
+      {%- if sl_li_group != sl_ll_name -%}{%- continue -%}{%- endif %}
+- [{{ item.title | default: item.url | strip_newlines }}]({{ item.url | absolute_url }})
+      {%- if item.description -%}: {{ item.description | strip_newlines }}{%- endif -%}
+    {%- endfor -%}
+  {%- endcapture -%}
+  {%- if sl_ll_lines != '' %}
+
+## {{ sl_ll_name }}
+{{ sl_ll_lines }}
+  {%- endif -%}
+{%- endfor %}

data/_layouts/not-found.html

@@ -0,0 +1,27 @@
+---
+layout: base
+---
+{%- comment -%}
+  GitHub Pages serves one 404.html for the whole site and cannot tell which language the visitor wanted, so this
+  page has a section for every language in slipway.languages (or just the page language) under one heading.
+{%- endcomment -%}
+{%- assign sl_nf_langs = site.slipway.languages -%}
+<article class="sl-not-found">
+  <h1 class="sl-not-found-code">404</h1>
+  {%- if sl_nf_langs.size > 0 %}
+  {%- for l in sl_nf_langs %}
+  {%- capture sl_nf_dir %}{% include dir.html lang=l.code %}{% endcapture %}
+  <section lang="{{ l.code }}" dir="{{ sl_nf_dir }}">
+    <h2>{% include t.html lang=l.code key='not_found_title' %}</h2>
+    <p>{% include t.html lang=l.code key='not_found_text' %}</p>
+    <p><a class="sl-button" href="{{ l.prefix | append: '/' | relative_url }}">{% include t.html lang=l.code key='go_home' %}</a></p>
+  </section>
+  {%- endfor %}
+  {%- else %}
+  <section>
+    <h2>{% include t.html key='not_found_title' %}</h2>
+    <p>{% include t.html key='not_found_text' %}</p>
+    <p><a class="sl-button" href="{{ '/' | relative_url }}">{% include t.html key='go_home' %}</a></p>
+  </section>
+  {%- endif %}
+</article>

data/_layouts/page.html

@@ -0,0 +1,13 @@
+---
+layout: base
+---
+<article class="sl-page">
+  <header class="sl-page-header">
+    {% include breadcrumbs.html %}
+    <h1>{{ page.title }}</h1>{% include copy-page.html %}
+    {%- if page.description %}
+    <p class="sl-page-lead">{{ page.description }}</p>
+    {%- endif %}
+  </header>
+  {{ content }}
+</article>