slipway-theme 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8d0d2d52540ddd0bc4f734b24076c53ad9e68005db52c4842fd48c085cf598a9
+  data.tar.gz: 5bbd56dcba755da1884d0342f7b0362679e42f14fd2fa21eddd0bdad8258f4e8
+SHA512:
+  metadata.gz: ad5b45c3c0328902ddbc3f525474efbbcea4005ea4cc38d67a653fe6bdf96a7c8224a6553cd5d452240cf27b6574449ac80c3266338e44ad5d060422e070977b
+  data.tar.gz: cd0beb748c32d545fafb6d463491d55080b45d5c28def720b80e3947c32640ac3ee3db4339f98be07cf3b2d5f8fd39b570ea3b66a95947261684bc8f6d7b3c7e

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Armin Azimi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/_includes/analytics.html

@@ -0,0 +1,12 @@
+{%- assign sl_analytics = site.slipway.analytics -%}
+{%- if sl_analytics -%}
+  {%- if sl_analytics.plausible -%}
+  <script defer data-domain="{{ sl_analytics.plausible }}" src="https://plausible.io/js/script.js"></script>
+  {%- endif -%}
+  {%- if sl_analytics.goatcounter -%}
+  <script data-goatcounter="{{ sl_analytics.goatcounter }}" async src="//gc.zgo.at/count.js"></script>
+  {%- endif -%}
+  {%- if sl_analytics.umami -%}
+  <script defer src="{{ sl_analytics.umami.url | default: 'https://analytics.umami.is/script.js' }}" data-website-id="{{ sl_analytics.umami.website_id }}"></script>
+  {%- endif -%}
+{%- endif -%}

data/_includes/author-card.html

@@ -0,0 +1,29 @@
+{%- comment -%} Avatar, name, bio, and links of include.id from _data/authors.yml. include.link links the name to the author page. Prints nothing for an unknown id. {%- endcomment -%}
+{%- assign sl_ac = site.data.authors[include.id] -%}
+{%- if sl_ac -%}
+{%- assign sl_ac_name = sl_ac.name | default: include.id -%}
+<div class="sl-author">
+  {%- if sl_ac.avatar %}
+  {%- assign sl_ac_src = sl_ac.avatar -%}
+  {%- unless sl_ac_src contains '://' %}{% assign sl_ac_src = sl_ac_src | relative_url %}{% endunless %}
+  <img class="sl-avatar" src="{{ sl_ac_src }}" alt="" width="64" height="64" loading="lazy">
+  {%- endif %}
+  <div>
+    {%- assign sl_ac_url = '' -%}
+    {%- if include.link %}{% capture sl_ac_url %}{% include author-url.html id=include.id %}{% endcapture %}{% assign sl_ac_url = sl_ac_url | strip %}{% endif %}
+    <p class="sl-author-name">{% if sl_ac_url != '' %}<a rel="author" href="{{ sl_ac_url }}">{{ sl_ac_name | escape }}</a>{% else %}{{ sl_ac_name | escape }}{% endif %}</p>
+    {%- if sl_ac.bio %}
+    <p class="sl-author-bio">{{ sl_ac.bio | escape }}</p>
+    {%- endif %}
+    {%- if sl_ac.links and sl_ac.links.size > 0 %}
+    <ul class="sl-author-links">
+      {%- for link in sl_ac.links %}
+      {%- assign sl_ac_href = link.url -%}
+      {%- unless sl_ac_href contains '://' %}{% assign sl_ac_href = sl_ac_href | relative_url %}{% endunless %}
+      <li><a href="{{ sl_ac_href | escape }}">{{ link.title | escape }}</a></li>
+      {%- endfor %}
+    </ul>
+    {%- endif %}
+  </div>
+</div>
+{%- endif -%}

data/_includes/author-ids.html

@@ -0,0 +1,2 @@
+{%- comment -%} Sets sl_ai_ids to the author ids of include.page: `author` is one id or a list of ids, keys of _data/authors.yml. {%- endcomment -%}
+{%- assign sl_ai_ids = include.page.author | join: ',' | split: ',' -%}

data/_includes/author-url.html

@@ -0,0 +1,11 @@
+{%- comment -%} Prints the url of the author page (layout author) for include.id, in the current language when there is one, or nothing. {%- endcomment -%}
+{%- assign sl_au_lang = page.lang | default: site.lang | default: 'en' -%}
+{%- assign sl_au_url = '' -%}
+{%- for p in site.pages -%}
+  {%- if p.layout == 'author' and p.author == include.id -%}
+    {%- assign sl_au_page_lang = p.lang | default: site.lang | default: 'en' -%}
+    {%- if sl_au_page_lang == sl_au_lang -%}{%- assign sl_au_url = p.url | relative_url -%}{%- break -%}{%- endif -%}
+    {%- if sl_au_url == '' -%}{%- assign sl_au_url = p.url | relative_url -%}{%- endif -%}
+  {%- endif -%}
+{%- endfor -%}
+{{ sl_au_url }}

data/_includes/breadcrumbs.html

@@ -0,0 +1,67 @@
+{%- assign sl_bc_parts = page.url | split: '/' -%}
+{%- assign sl_bc_url = '' -%}
+{%- assign sl_bc_items = '' -%}
+{%- assign sl_bc_count = 0 -%}
+{%- assign sl_all = site.pages | concat: site.documents -%}
+
+{%- for part in sl_bc_parts -%}
+  {%- if part != '' and forloop.last == false -%}
+    {%- assign sl_bc_url = sl_bc_url | append: '/' | append: part -%}
+    {%- assign sl_bc_full = sl_bc_url | append: '/' -%}
+    {%- assign sl_bc_page = sl_all | where: 'url', sl_bc_full | first -%}
+    {%- unless sl_bc_page -%}
+      {%- assign sl_bc_page = sl_all | where: 'url', sl_bc_url | first -%}
+    {%- endunless -%}
+    {%- if sl_bc_page -%}
+      {%- capture sl_bc_item -%}
+        <li>
+          <a href="{{ sl_bc_page.url | relative_url }}">{{ sl_bc_page.title }}</a>
+          <span class="sl-breadcrumb-separator" aria-hidden="true">/</span>
+        </li>
+      {%- endcapture -%}
+      {%- assign sl_bc_items = sl_bc_items | append: sl_bc_item -%}
+      {%- assign sl_bc_count = sl_bc_count | plus: 1 -%}
+    {%- endif -%}
+  {%- endif -%}
+{%- endfor -%}
+
+{%- if sl_bc_count > 0 -%}
+{%- capture sl_bc_label %}{% include t.html key='breadcrumbs' %}{% endcapture -%}
+{%- capture sl_home_label %}{% include t.html key='home' %}{% endcapture -%}
+<nav class="sl-breadcrumbs" aria-label="{{ sl_bc_label | strip | escape }}">
+  <ol>
+    <li>
+      <a href="{{ '/' | relative_url }}">{{ sl_home_label | strip }}</a>
+      <span class="sl-breadcrumb-separator" aria-hidden="true">/</span>
+    </li>
+    {{ sl_bc_items }}
+    <li aria-current="page">{{ page.title }}</li>
+  </ol>
+</nav>
+
+{%- assign sl_bc_url = '' -%}
+{%- assign sl_bc_pos = 1 -%}
+{%- capture sl_bc_json -%}
+{"@type":"ListItem","position":{{ sl_bc_pos }},"name":{{ sl_home_label | strip | jsonify }},"item":{{ '/' | absolute_url | jsonify }}}
+{%- endcapture -%}
+{%- assign sl_bc_pos = sl_bc_pos | plus: 1 -%}
+
+{%- for part in sl_bc_parts -%}
+  {%- if part != '' and forloop.last == false -%}
+    {%- assign sl_bc_url = sl_bc_url | append: '/' | append: part -%}
+    {%- assign sl_bc_full = sl_bc_url | append: '/' -%}
+    {%- assign sl_bc_page = sl_all | where: 'url', sl_bc_full | first -%}
+    {%- unless sl_bc_page -%}
+      {%- assign sl_bc_page = sl_all | where: 'url', sl_bc_url | first -%}
+    {%- endunless -%}
+    {%- if sl_bc_page -%}
+      {%- capture sl_bc_json -%}{{ sl_bc_json }},{"@type":"ListItem","position":{{ sl_bc_pos }},"name":{{ sl_bc_page.title | jsonify }},"item":{{ sl_bc_page.url | absolute_url | jsonify }}}{%- endcapture -%}
+      {%- assign sl_bc_pos = sl_bc_pos | plus: 1 -%}
+    {%- endif -%}
+  {%- endif -%}
+{%- endfor -%}
+
+{%- capture sl_bc_json -%}{{ sl_bc_json }},{"@type":"ListItem","position":{{ sl_bc_pos }},"name":{{ page.title | jsonify }}}{%- endcapture -%}
+{%- capture sl_bc_list -%}{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{{ sl_bc_json }}]}{%- endcapture %}
+<script type="application/ld+json">{{ sl_bc_list | strip_newlines | replace: '<', '\u003c' }}</script>
+{%- endif -%}

data/_includes/byline.html

@@ -0,0 +1,14 @@
+{%- comment -%} "By A, B and C" for include.page, each name linked to its author page when there is one. Unknown ids print as they are. {%- endcomment -%}
+{%- include author-ids.html page=include.page -%}
+{%- if sl_ai_ids.size > 0 -%}
+{%- assign sl_bl_ids = sl_ai_ids -%}
+<span class="sl-byline">{% include t.html key='by' %}
+  {%- for id in sl_bl_ids %}
+  {%- assign sl_bl_author = site.data.authors[id] -%}
+  {%- assign sl_bl_name = sl_bl_author.name | default: id -%}
+  {%- capture sl_bl_url %}{% include author-url.html id=id %}{% endcapture %}{% assign sl_bl_url = sl_bl_url | strip -%}
+  {%- unless forloop.first %}{% if forloop.last %} {% include t.html key='and' %}{% else %}{% include t.html key='comma' %}{% endif %}{% endunless %}
+  {% if sl_bl_url != '' %}<a rel="author" href="{{ sl_bl_url }}">{{ sl_bl_name | escape }}</a>{% else %}<span>{{ sl_bl_name | escape }}</span>{% endif %}
+  {%- endfor -%}
+</span>
+{%- endif -%}

data/_includes/compat.html

@@ -0,0 +1,11 @@
+{%- comment -%}
+  Reads a renamed config key or front-matter field (ADR 0012, rule 4): the new name wins when it is
+  set, else the deprecated old one. The result is in sl_compat. Call it with the include tag,
+  new= the new name and old= the old one (each under site or page), then print sl_compat.
+  Every entry in schema/deprecations.json has one such call; tools/theme/deprecations.test.mjs checks it.
+{%- endcomment -%}
+{%- if include.new == nil -%}
+  {%- assign sl_compat = include.old -%}
+{%- else -%}
+  {%- assign sl_compat = include.new -%}
+{%- endif -%}

data/_includes/component-css.html

@@ -0,0 +1,5 @@
+{%- assign _sl_css_check = "," | append: include.name | append: "," -%}
+{%- unless slipway_components_css contains _sl_css_check -%}
+  {%- assign slipway_components_css = slipway_components_css | default: "," | append: include.name | append: "," -%}
+  <link rel="stylesheet" href="{{ '/assets/css/components/' | append: include.name | append: '.css' | relative_url }}">
+{%- endunless -%}

data/_includes/copy-page.html

@@ -0,0 +1,5 @@
+{%- assign sl_twin = page.slipway_twin %}
+{%- unless sl_twin %}{% assign sl_twin = site.pages | where: 'twin_of', page.path | map: 'url' | first %}{% endunless %}
+{%- if sl_twin %}
+<button type="button" class="sl-copy-page" data-copy-page="{{ sl_twin | relative_url }}" hidden>{% include t.html key='copy_page_md' %}</button>
+{%- endif %}

data/_includes/date.html

@@ -0,0 +1,90 @@
+{%- comment -%}
+  Prints include.date as YYYY-MM-DD, or as "D Month YYYY" in the Jalali calendar when the page is Persian and
+  slipway.persian.jalali is on. Prints in the Hijri calendar when the page is Arabic and slipway.arabic.hijri is on.
+  Integer arithmetic of the 33-year cycle (Borkowski) for Jalali; 30-year tabular (civil epoch) for Hijri.
+  (Tabular Islamic calendar has a known offset of up to 1-2 days from Umm al-Qura).
+  Digits follow slipway.persian.digits or slipway.arabic.digits.
+{%- endcomment -%}
+{%- assign sl_d_lang = page.lang | default: site.lang | default: 'en' | split: '-' | first -%}
+{%- capture sl_d_text -%}
+{%- assign gy = include.date | date: '%Y' | plus: 0 -%}
+{%- if sl_d_lang == 'fa' and site.slipway.persian.jalali and gy > 0 -%}
+  {%- assign gm = include.date | date: '%-m' | plus: 0 -%}
+  {%- assign gd = include.date | date: '%-d' | plus: 0 -%}
+  {%- assign offsets = '0,31,59,90,120,151,181,212,243,273,304,334' | split: ',' -%}
+  {%- assign idx = gm | minus: 1 -%}
+  {%- assign off = offsets[idx] | plus: 0 -%}
+  {%- assign gy2 = gy -%}
+  {%- if gm > 2 -%}{%- assign gy2 = gy | plus: 1 -%}{%- endif -%}
+  {%- assign a = gy2 | plus: 3 | divided_by: 4 -%}
+  {%- assign b = gy2 | plus: 99 | divided_by: 100 -%}
+  {%- assign c = gy2 | plus: 399 | divided_by: 400 -%}
+  {%- assign days = gy | times: 365 | plus: 355666 | plus: a | minus: b | plus: c | plus: gd | plus: off -%}
+  {%- assign jy = days | divided_by: 12053 | times: 33 | minus: 1595 -%}
+  {%- assign days = days | modulo: 12053 -%}
+  {%- assign jy = days | divided_by: 1461 | times: 4 | plus: jy -%}
+  {%- assign days = days | modulo: 1461 -%}
+  {%- if days > 365 -%}
+    {%- assign dm1 = days | minus: 1 -%}
+    {%- assign jy = dm1 | divided_by: 365 | plus: jy -%}
+    {%- assign days = dm1 | modulo: 365 -%}
+  {%- endif -%}
+  {%- if days < 186 -%}
+    {%- assign jm = days | divided_by: 31 | plus: 1 -%}
+    {%- assign jd = days | modulo: 31 | plus: 1 -%}
+  {%- else -%}
+    {%- assign r = days | minus: 186 -%}
+    {%- assign jm = r | divided_by: 30 | plus: 7 -%}
+    {%- assign jd = r | modulo: 30 | plus: 1 -%}
+  {%- endif -%}
+  {%- assign months = 'فروردین,اردیبهشت,خرداد,تیر,مرداد,شهریور,مهر,آبان,آذر,دی,بهمن,اسفند' | split: ',' -%}
+  {%- assign mi = jm | minus: 1 -%}
+  {{- jd }} {{ months[mi] }} {{ jy -}}
+{%- elsif sl_d_lang == 'ar' and site.slipway.arabic.hijri and gy > 0 -%}
+  {%- assign gm = include.date | date: '%-m' | plus: 0 -%}
+  {%- assign gd = include.date | date: '%-d' | plus: 0 -%}
+  {%- assign a = 14 | minus: gm | divided_by: 12 -%}
+  {%- assign y_p = gy | plus: 4800 | minus: a -%}
+  {%- assign m_p = a | times: 12 | plus: gm | minus: 3 -%}
+  {%- assign jd = m_p | times: 153 | plus: 2 | divided_by: 5 | plus: gd -%}
+  {%- assign y_p365 = y_p | times: 365 -%}
+  {%- assign y_p4 = y_p | divided_by: 4 -%}
+  {%- assign y_p100 = y_p | divided_by: 100 -%}
+  {%- assign y_p400 = y_p | divided_by: 400 -%}
+  {%- assign jd = jd | plus: y_p365 | plus: y_p4 | minus: y_p100 | plus: y_p400 | minus: 32045 -%}
+  {%- assign days = jd | minus: 1948440 -%}
+  {%- if days < 0 -%}
+    {{- include.date | date: '%Y-%m-%d' -}}
+    {%- assign hy = gy -%}
+  {%- else -%}
+    {%- assign cycle = days | divided_by: 10631 -%}
+    {%- assign rem = days | modulo: 10631 -%}
+    {%- assign h_year = rem | times: 30 | plus: 10646 | divided_by: 10631 -%}
+    {%- assign h_year_m1 = h_year | minus: 1 -%}
+    {%- assign days_before = h_year_m1 | times: 354 -%}
+    {%- assign leap_days = h_year | times: 11 | plus: 3 | divided_by: 30 -%}
+    {%- assign days_before = days_before | plus: leap_days -%}
+    {%- assign rem_days = rem | minus: days_before -%}
+    {%- assign hm = rem_days | times: 11 | plus: 330 | divided_by: 325 -%}
+    {%- assign hm_m1 = hm | minus: 1 -%}
+    {%- assign days_in_prev = hm_m1 | times: 29 -%}
+    {%- assign days_in_prev_leap = hm | divided_by: 2 -%}
+    {%- assign days_in_prev = days_in_prev | plus: days_in_prev_leap -%}
+    {%- assign hd = rem_days | minus: days_in_prev | plus: 1 -%}
+    {%- assign hy = cycle | times: 30 | plus: h_year -%}
+    {%- assign months = 'محرم,صفر,ربيع الأول,ربيع الثاني,جمادى الأولى,جمادى الآخرة,رجب,شعبان,رمضان,شوال,ذو القعدة,ذو الحجة' | split: ',' -%}
+    {%- assign mi = hm | minus: 1 -%}
+    {{- hd }} {{ months[mi] }} {{ hy -}}
+  {%- endif -%}
+{%- else -%}
+  {{- include.date | date: '%Y-%m-%d' -}}
+{%- endif -%}
+{%- endcapture -%}
+{%- if sl_d_lang == 'fa' and site.slipway.persian.jalali and gy > 0 -%}
+  {%- assign sl_d_year = jy -%}
+{%- elsif sl_d_lang == 'ar' and site.slipway.arabic.hijri and gy > 0 and hy -%}
+  {%- assign sl_d_year = hy -%}
+{%- else -%}
+  {%- assign sl_d_year = include.date | date: '%Y' -%}
+{%- endif -%}
+{%- include num.html value=sl_d_text -%}

data/_includes/dir.html

@@ -0,0 +1,4 @@
+{%- comment -%} Prints rtl or ltr for include.lang. {%- endcomment -%}
+{%- assign sl_dir_rtl = 'ar,arc,ckb,dv,fa,he,ks,ku,ps,sd,syr,ug,ur,yi' | split: ',' -%}
+{%- assign sl_dir_base = include.lang | split: '-' | first -%}
+{%- if sl_dir_rtl contains sl_dir_base -%}rtl{%- else -%}ltr{%- endif -%}

data/_includes/edit-sources.html

@@ -0,0 +1,25 @@
+{%- comment -%}
+  include.html with a data-source attribute on every h2 and h3, for "Edit with your agent"
+  (assets/js/edit-prompt.js): "path:line" when the Actions plugin set page.slipway_sections from the
+  source map, the page's file alone otherwise (classic mode cannot know lines, ADR 0007).
+{%- endcomment -%}
+{%- assign sl_src_path = page.path | escape -%}
+{%- assign sl_src_parts = include.html | split: '<h' -%}
+{%- for part in sl_src_parts -%}
+  {%- if forloop.first %}{{ part }}{% continue %}{% endif -%}
+  {%- assign sl_src_level = part | slice: 0, 1 -%}
+  {%- assign sl_src_next = part | slice: 1, 1 -%}
+  {%- if sl_src_level == '2' or sl_src_level == '3' -%}
+    {%- if sl_src_next == ' ' or sl_src_next == '>' -%}
+      {%- assign sl_src = sl_src_path -%}
+      {%- assign sl_src_tag = part | split: '>' | first -%}
+      {%- if sl_src_tag contains 'id="' -%}
+        {%- assign sl_src_id = sl_src_tag | split: 'id="' | last | split: '"' | first -%}
+        {%- for section in page.slipway_sections -%}
+          {%- if section.id == sl_src_id %}{% assign sl_src = sl_src_path | append: ':' | append: section.line %}{% break %}{% endif -%}
+        {%- endfor -%}
+      {%- endif -%}
+      <h{{ sl_src_level }} data-source="{{ sl_src }}"{{ part | slice: 1, part.size }}
+    {%- else -%}<h{{ part }}{%- endif -%}
+  {%- else -%}<h{{ part }}{%- endif -%}
+{%- endfor -%}

data/_includes/feedback.html

@@ -0,0 +1,12 @@
+{%- assign sl_repo_url = site.github.repository_url -%}
+{%- if sl_repo_url == nil -%}
+{%- assign sl_repo_url = site.repository_url -%}
+{%- endif -%}
+{%- if sl_repo_url -%}
+<div class="sl-feedback">
+  <p>Was this helpful?
+    <a href="{{ sl_repo_url }}/issues/new?assignees=&amp;labels=feedback&amp;projects=&amp;template=feedback.yml&amp;title=Feedback+on+{{ page.url | url_encode }}" target="_blank" rel="noopener noreferrer" class="sl-feedback-link">Yes</a> /
+    <a href="{{ sl_repo_url }}/issues/new?assignees=&amp;labels=feedback&amp;projects=&amp;template=feedback.yml&amp;title=Feedback+on+{{ page.url | url_encode }}" target="_blank" rel="noopener noreferrer" class="sl-feedback-link">No</a>
+  </p>
+</div>
+{%- endif -%}

data/_includes/footer-custom.html

@@ -0,0 +1,5 @@
+{%- comment -%}
+  Override slot: rendered inside <footer> on every page, after the site title. Empty in the theme.
+  To fill it, create _includes/footer-custom.html in your site; your file replaces this one.
+  See docs/overrides.md.
+{%- endcomment -%}

data/_includes/footer.html

@@ -0,0 +1,16 @@
+<footer class="sl-footer">
+  <p>{{ site.title }}</p>
+  {% if site.data.social %}
+  <ul class="sl-social-links">
+    {% for link in site.data.social %}
+    <li>
+      <a href="{{ link.url }}" rel="me" aria-label="{{ link.network }}">
+        {% assign icon_file = "icons/" | append: link.network | append: ".svg" %}
+        {% include {{ icon_file }} %}
+      </a>
+    </li>
+    {% endfor %}
+  </ul>
+  {% endif %}
+  {% include footer-custom.html %}
+</footer>

data/_includes/head-custom.html

@@ -0,0 +1,5 @@
+{%- comment -%}
+  Override slot: rendered at the end of <head> on every page. Empty in the theme.
+  To fill it, create _includes/head-custom.html in your site; your file replaces this one.
+  See docs/overrides.md.
+{%- endcomment -%}

data/_includes/head.html

@@ -0,0 +1,52 @@
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  {% include theme-init.html %}
+  <title>{{ page.title | default: site.title }}</title>
+  {%- comment %} Without a description, the opening words of the page stand in, so a bare site still has one. {% endcomment %}
+  {%- assign sl_desc = page.description %}
+  {%- unless sl_desc %}{% assign sl_desc = content | strip_html | normalize_whitespace | strip | truncate: 160 %}{% endunless %}
+  {%- if sl_desc != '' %}
+  <meta name="description" content="{{ sl_desc | escape }}">
+  {%- endif %}
+  {%- include jsonld.html %}
+  {%- include seo.html %}
+  {%- if site.slipway.fonts != "system" %}
+  <link rel="preload" href="{{ '/assets/fonts/source-serif-4-latin-wght-normal.woff2' | relative_url }}" as="font" type="font/woff2" crossorigin>
+  {%- endif %}
+  {%- capture sl_feed_url %}{% include layout-url.html layout='feed' %}{% endcapture %}
+  {%- assign sl_feed_url = sl_feed_url | strip %}
+  {%- if sl_feed_url != '' %}
+  <link rel="alternate" type="application/atom+xml" href="{{ sl_feed_url }}" title="{{ site.title | escape }}">
+  {%- endif %}
+  {%- if site.slipway.logo.favicon_svg %}
+  <link rel="icon" href="{{ site.slipway.logo.favicon_svg | relative_url }}" type="image/svg+xml">
+  {%- endif %}
+  {%- if site.slipway.logo.touch_icon %}
+  <link rel="apple-touch-icon" href="{{ site.slipway.logo.touch_icon | relative_url }}">
+  {%- endif %}
+  {%- comment %} The Markdown twin (ADR 0006): set by the Actions plugin, or the stub page from `npm run twins` on classic Pages. {% endcomment %}
+  {%- assign sl_twin = page.slipway_twin %}
+  {%- unless sl_twin %}{% assign sl_twin = site.pages | where: 'twin_of', page.path | map: 'url' | first %}{% endunless %}
+  {%- if sl_twin %}
+  <link rel="alternate" type="text/markdown" href="{{ sl_twin | relative_url }}">
+  {%- endif %}
+  {%- if site.slipway.fonts != "system" %}
+  <link rel="stylesheet" href="{{ '/assets/css/fonts.css' | relative_url }}">
+  {%- endif %}
+  <link rel="stylesheet" href="{{ '/assets/css/tokens.css' | relative_url }}">
+  <link rel="stylesheet" href="{{ '/assets/css/slipway.css' | relative_url }}">
+  <link rel="stylesheet" href="{{ '/assets/css/nav.css' | relative_url }}">
+  <link rel="stylesheet" href="{{ '/assets/css/print.css' | relative_url }}" media="print">
+  {% include theme-vars.html %}
+  {%- assign sl_custom_css = site.static_files | where: 'path', '/assets/css/custom.css' | first %}
+  {%- if sl_custom_css %}
+  <link rel="stylesheet" href="{{ '/assets/css/custom.css' | relative_url }}">
+  {%- endif %}
+  <script src="{{ '/assets/js/theme-toggle.js' | relative_url }}" defer></script>
+  <script src="{{ '/assets/js/search.js' | relative_url }}" defer></script>
+  <script src="{{ '/assets/js/copy-code.js' | relative_url }}" defer></script>
+  <script src="{{ '/assets/js/edit-prompt.js' | relative_url }}" defer></script>
+  {% include analytics.html %}
+  {% include head-custom.html %}
+</head>

data/_includes/header.html

@@ -0,0 +1,38 @@
+{%- comment -%} slipway.header picks the variant: classic (title at the start, the rest at the end), centered (stacked and centered), or minimal (title, language switcher, and theme toggle only). {%- endcomment -%}
+{%- assign sl_header = site.slipway.header | default: 'classic' -%}
+<header class="sl-header{% if sl_header == 'centered' or sl_header == 'minimal' %} sl-header-{{ sl_header }}{% endif %}">
+  <a class="sl-site-title" href="{{ '/' | relative_url }}">
+    {%- if site.slipway.logo.light -%}
+    <img src="{{ site.slipway.logo.light | relative_url }}" alt="{{ site.title | escape }}"{% if site.slipway.logo.dark %} class="sl-logo-light"{% endif %}>
+    {%- if site.slipway.logo.dark %}
+    <img src="{{ site.slipway.logo.dark | relative_url }}" alt="{{ site.title | escape }}" class="sl-logo-dark">
+    {%- endif -%}
+    {%- else -%}
+    {{ site.title }}
+    {%- endif -%}
+  </a>
+  {%- assign sl_nav_lang = page.lang | default: site.lang | default: 'en' | split: '-' | first -%}
+  {%- assign sl_nav_key = 'main_' | append: sl_nav_lang -%}
+  {%- assign sl_main = site.data.navigation[sl_nav_key] | default: site.data.navigation.main -%}
+  {%- if sl_main.size > 0 and sl_header != 'minimal' %}
+  <input type="checkbox" id="sl-nav-state" class="sl-nav-state" aria-label="{% include t.html key='main_nav' %}">
+  <label for="sl-nav-state" class="sl-nav-toggle">
+    <svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 18h18v-2H3v2zm0-5h18v-2H3v2zm0-7v2h18V6H3z"/></svg>
+  </label>
+  <label for="sl-nav-state" class="sl-nav-backdrop"></label>
+  <div class="sl-nav-drawer">
+    <nav class="sl-main-nav" aria-label="{% include t.html key='main_nav' %}">
+    <ul>
+      {%- for item in sl_main %}
+      {%- assign sl_here = false %}
+      {%- if page.url == item.url %}{% assign sl_here = true %}{% elsif item.url != '/' and page.url contains item.url %}{% assign sl_here = true %}{% endif %}
+      <li><a href="{{ item.url | relative_url }}"{% if sl_here %} aria-current="page"{% endif %}>{{ item.title }}</a></li>
+      {%- endfor %}
+    </ul>
+    </nav>
+  </div>
+  {%- endif %}
+  {% unless sl_header == 'minimal' %}{% include search.html %}{% endunless %}
+  {% include lang-switcher.html %}
+  <button type="button" class="sl-theme-toggle" data-theme-toggle data-label-auto="{% include t.html key='mode_auto' %}" data-label-light="{% include t.html key='mode_light' %}" data-label-dark="{% include t.html key='mode_dark' %}" hidden>{% include t.html key='theme' %}</button>
+</header>

data/_includes/i18n/ar.html

@@ -0,0 +1,43 @@
+{%- case include.key -%}
+{%- when 'about_author' -%}عن الكاتب
+{%- when 'and' -%}و
+{%- when 'breadcrumbs' -%}مسار التنقل
+{%- when 'by' -%}بقلم
+{%- when 'categories' -%}التصنيفات
+{%- when 'comma' -%}،
+{%- when 'copied' -%}تم النسخ
+{%- when 'copy' -%}نسخ
+{%- when 'copy_failed' -%}اضغط Ctrl+C
+{%- when 'copy_page_md' -%}نسخ الصفحة كماركداون
+{%- when 'docs_nav' -%}التوثيق
+{%- when 'edit_label' -%}التحرير مع وكيلك
+{%- when 'edit_prompt' -%}حرّر الملف {source}. النص الحالي: «{text}». التغيير:
+{%- when 'go_home' -%}الانتقال إلى الصفحة الرئيسية
+{%- when 'home' -%}الرئيسية
+{%- when 'language' -%}اللغة
+{%- when 'latest_posts' -%}أحدث التدوينات
+{%- when 'main_nav' -%}القائمة الرئيسية
+{%- when 'min_read' -%}دقيقة قراءة
+{%- when 'mode_auto' -%}تلقائي
+{%- when 'mode_dark' -%}داكن
+{%- when 'mode_light' -%}فاتح
+{%- when 'next' -%}التالي
+{%- when 'not_found_text' -%}هذا العنوان غير موجود أو نُقل. استخدم حقل البحث أو انتقل إلى الصفحة الرئيسية.
+{%- when 'not_found_title' -%}الصفحة غير موجودة
+{%- when 'on_this_page' -%}في هذه الصفحة
+{%- when 'pager' -%}الصفحة السابقة والتالية
+{%- when 'post_pager' -%}التدوينة السابقة والتالية
+{%- when 'posts' -%}التدوينات
+{%- when 'previous' -%}السابق
+{%- when 'related_posts' -%}تدوينات ذات صلة
+{%- when 'search' -%}بحث
+{%- when 'search_count' -%}{n} نتيجة
+{%- when 'search_none' -%}لا توجد نتائج
+{%- when 'series' -%}سلسلة
+{%- when 'series_pager' -%}الجزء السابق والتالي من السلسلة
+{%- when 'series_part' -%}الجزء {n} من {total}
+{%- when 'skip' -%}انتقال إلى المحتوى
+{%- when 'tags' -%}الوسوم
+{%- when 'theme' -%}المظهر
+{%- when 'translation_key' -%}مفتاح الترجمة
+{%- endcase -%}

data/_includes/i18n/de.html

@@ -0,0 +1,43 @@
+{%- case include.key -%}
+{%- when 'about_author' -%}Über den Autor
+{%- when 'and' -%}und
+{%- when 'breadcrumbs' -%}Brotkrümelnavigation
+{%- when 'by' -%}Von
+{%- when 'categories' -%}Kategorien
+{%- when 'comma' -%},
+{%- when 'copied' -%}Kopiert
+{%- when 'copy' -%}Kopieren
+{%- when 'copy_failed' -%}Drücken Sie Strg+C
+{%- when 'copy_page_md' -%}Seite als Markdown kopieren
+{%- when 'docs_nav' -%}Dokumentation
+{%- when 'edit_label' -%}Mit Ihrem Agenten bearbeiten
+{%- when 'edit_prompt' -%}{source} bearbeiten. Aktueller Text: "{text}". Änderung:
+{%- when 'go_home' -%}Zur Startseite gehen
+{%- when 'home' -%}Startseite
+{%- when 'language' -%}Sprache
+{%- when 'latest_posts' -%}Neueste Beiträge
+{%- when 'main_nav' -%}Hauptmenü
+{%- when 'min_read' -%}Min. Lesezeit
+{%- when 'mode_auto' -%}Auto
+{%- when 'mode_dark' -%}Dunkel
+{%- when 'mode_light' -%}Hell
+{%- when 'next' -%}Weiter
+{%- when 'not_found_text' -%}Diese Adresse existiert nicht oder wurde verschoben. Verwenden Sie das Suchfeld oder gehen Sie zur Startseite.
+{%- when 'not_found_title' -%}Seite nicht gefunden
+{%- when 'on_this_page' -%}Auf dieser Seite
+{%- when 'pager' -%}Zurück und Weiter
+{%- when 'post_pager' -%}Vorheriger und nächster Beitrag
+{%- when 'posts' -%}Beiträge
+{%- when 'previous' -%}Zurück
+{%- when 'related_posts' -%}Ähnliche Beiträge
+{%- when 'search' -%}Suche
+{%- when 'search_count' -%}{n} Ergebnisse
+{%- when 'search_none' -%}Keine Ergebnisse
+{%- when 'series' -%}Serie
+{%- when 'series_pager' -%}Zurück und Weiter in dieser Serie
+{%- when 'series_part' -%}Teil {n} von {total}
+{%- when 'skip' -%}Zum Inhalt springen
+{%- when 'tags' -%}Tags
+{%- when 'theme' -%}Design
+{%- when 'translation_key' -%}Übersetzungsschlüssel
+{%- endcase -%}

data/_includes/i18n/en.html

@@ -0,0 +1,43 @@
+{%- case include.key -%}
+{%- when 'about_author' -%}About the author
+{%- when 'and' -%}and
+{%- when 'breadcrumbs' -%}Breadcrumbs
+{%- when 'by' -%}By
+{%- when 'categories' -%}Categories
+{%- when 'comma' -%},
+{%- when 'copied' -%}Copied
+{%- when 'copy' -%}Copy
+{%- when 'copy_failed' -%}Press Ctrl+C
+{%- when 'copy_page_md' -%}Copy page as Markdown
+{%- when 'docs_nav' -%}Documentation
+{%- when 'edit_label' -%}Edit with your agent
+{%- when 'edit_prompt' -%}Edit {source}. Current text: "{text}". Change:
+{%- when 'go_home' -%}Go to the home page
+{%- when 'home' -%}Home
+{%- when 'language' -%}Language
+{%- when 'latest_posts' -%}Latest posts
+{%- when 'main_nav' -%}Main
+{%- when 'min_read' -%}min read
+{%- when 'mode_auto' -%}Auto
+{%- when 'mode_dark' -%}Dark
+{%- when 'mode_light' -%}Light
+{%- when 'next' -%}Next
+{%- when 'not_found_text' -%}This address does not exist or has moved. Use the search field or go to the home page.
+{%- when 'not_found_title' -%}Page not found
+{%- when 'on_this_page' -%}On this page
+{%- when 'pager' -%}Previous and next
+{%- when 'post_pager' -%}Previous and next post
+{%- when 'posts' -%}Posts
+{%- when 'previous' -%}Previous
+{%- when 'related_posts' -%}Related posts
+{%- when 'search' -%}Search
+{%- when 'search_count' -%}{n} results
+{%- when 'search_none' -%}No results
+{%- when 'series' -%}Series
+{%- when 'series_pager' -%}Previous and next in this series
+{%- when 'series_part' -%}Part {n} of {total}
+{%- when 'skip' -%}Skip to content
+{%- when 'tags' -%}Tags
+{%- when 'theme' -%}Theme
+{%- when 'translation_key' -%}Translation key
+{%- endcase -%}

data/_includes/i18n/es.html

@@ -0,0 +1,43 @@
+{%- case include.key -%}
+{%- when 'about_author' -%}Sobre el autor
+{%- when 'and' -%}y
+{%- when 'breadcrumbs' -%}Ruta de navegación
+{%- when 'by' -%}Por
+{%- when 'categories' -%}Categorías
+{%- when 'comma' -%},
+{%- when 'copied' -%}Copiado
+{%- when 'copy' -%}Copiar
+{%- when 'copy_failed' -%}Presione Ctrl+C
+{%- when 'copy_page_md' -%}Copiar página como Markdown
+{%- when 'docs_nav' -%}Documentación
+{%- when 'edit_label' -%}Editar con tu agente
+{%- when 'edit_prompt' -%}Editar {source}. Texto actual: "{text}". Cambio:
+{%- when 'go_home' -%}Ir a la página de inicio
+{%- when 'home' -%}Inicio
+{%- when 'language' -%}Idioma
+{%- when 'latest_posts' -%}Últimas publicaciones
+{%- when 'main_nav' -%}Principal
+{%- when 'min_read' -%}min de lectura
+{%- when 'mode_auto' -%}Auto
+{%- when 'mode_dark' -%}Oscuro
+{%- when 'mode_light' -%}Claro
+{%- when 'next' -%}Siguiente
+{%- when 'not_found_text' -%}Esta dirección no existe o se ha movido. Use el campo de búsqueda o vaya a la página de inicio.
+{%- when 'not_found_title' -%}Página no encontrada
+{%- when 'on_this_page' -%}En esta página
+{%- when 'pager' -%}Anterior y siguiente
+{%- when 'post_pager' -%}Publicación anterior y siguiente
+{%- when 'posts' -%}Publicaciones
+{%- when 'previous' -%}Anterior
+{%- when 'related_posts' -%}Publicaciones relacionadas
+{%- when 'search' -%}Buscar
+{%- when 'search_count' -%}{n} resultados
+{%- when 'search_none' -%}No hay resultados
+{%- when 'series' -%}Serie
+{%- when 'series_pager' -%}Anterior y siguiente en esta serie
+{%- when 'series_part' -%}Parte {n} de {total}
+{%- when 'skip' -%}Saltar al contenido
+{%- when 'tags' -%}Etiquetas
+{%- when 'theme' -%}Tema
+{%- when 'translation_key' -%}Clave de traducción
+{%- endcase -%}