slipway-theme 0.1.0 → 0.2.0

data/_includes/i18n/vi.html

@@ -0,0 +1,78 @@
+{%- case include.key -%}
+{%- when 'about_author' -%}Về tác giả
+{%- when 'accepted' -%}Đã chấp nhận
+{%- when 'adr_date' -%}Ngày
+{%- when 'adr_deciders' -%}Người quyết định
+{%- when 'adr_status' -%}Trạng thái
+{%- when 'adr_superseded_by' -%}Được thay thế bởi
+{%- when 'adr_supersedes' -%}Thay thế
+{%- when 'and' -%}và
+{%- when 'breadcrumbs' -%}Đường dẫn điều hướng
+{%- when 'by' -%}Bởi
+{%- when 'categories' -%}Danh mục
+{%- when 'comma' -%},
+{%- when 'comments' -%}Bình luận
+{%- when 'copied' -%}Đã sao chép
+{%- when 'copy' -%}Sao chép
+{%- when 'copy_failed' -%}Nhấn Ctrl+C
+{%- when 'copy_page_md' -%}Sao chép trang dưới dạng Markdown
+{%- when 'default' -%}Default
+{%- when 'deprecated' -%}Không dùng nữa
+{%- when 'description' -%}Mô tả
+{%- when 'docs_nav' -%}Tài liệu
+{%- when 'edit_label' -%}Chỉnh sửa với trợ lý của bạn
+{%- when 'edit_prompt' -%}Chỉnh sửa {source}. Văn bản hiện tại: "{text}". Thay đổi:
+{%- when 'edited_on' -%}được chỉnh sửa vào
+{%- when 'example_request' -%}Yêu cầu mẫu
+{%- when 'example_response' -%}Phản hồi mẫu
+{%- when 'go_home' -%}Về trang chủ
+{%- when 'home' -%}Trang chủ
+{%- when 'language' -%}Ngôn ngữ
+{%- when 'last_updated' -%}Cập nhật lần cuối
+{%- when 'latest_posts' -%}Bài viết mới nhất
+{%- when 'links' -%}Liên kết
+{%- when 'main_nav' -%}Điều hướng chính
+{%- when 'min_read' -%}phút đọc
+{%- when 'mode_auto' -%}Tự động
+{%- when 'mode_dark' -%}Tối
+{%- when 'mode_light' -%}Sáng
+{%- when 'name' -%}Tên
+{%- when 'next' -%}Tiếp theo
+{%- when 'no' -%}Không
+{%- when 'not_found_text' -%}Địa chỉ này không tồn tại hoặc đã được di chuyển. Hãy dùng ô tìm kiếm hoặc về trang chủ.
+{%- when 'not_found_title' -%}Không tìm thấy trang
+{%- when 'on_this_page' -%}Trên trang này
+{%- when 'pager' -%}Trước và tiếp theo
+{%- when 'parameters' -%}Tham số
+{%- when 'partial' -%}Một phần
+{%- when 'post_pager' -%}Bài viết trước và tiếp theo
+{%- when 'posts' -%}Bài viết
+{%- when 'previous' -%}Trước
+{%- when 'proposed' -%}Đề xuất
+{%- when 'rejected' -%}Bị từ chối
+{%- when 'related_posts' -%}Bài viết liên quan
+{%- when 'releases' -%}Bản phát hành
+{%- when 'required' -%}Bắt buộc
+{%- when 'scheduled' -%}Đã lên lịch
+{%- when 'search' -%}Tìm kiếm
+{%- when 'search_count' -%}{n} kết quả
+{%- when 'search_none' -%}Không có kết quả
+{%- when 'series' -%}Loạt bài
+{%- when 'series_pager' -%}Trước và tiếp theo trong loạt bài này
+{%- when 'series_part' -%}Phần {n} trong tổng số {total}
+{%- when 'skip' -%}Chuyển đến nội dung
+{%- when 'social_links' -%}Liên kết mạng xã hội
+{%- when 'status_beta' -%}Bản thử nghiệm
+{%- when 'status_deprecated' -%}Không dùng nữa
+{%- when 'status_experimental' -%}Thử nghiệm
+{%- when 'status_replaced_by' -%}Được thay thế bởi
+{%- when 'status_since' -%}Từ
+{%- when 'superseded' -%}Đã bị thay thế
+{%- when 'tags' -%}Thẻ
+{%- when 'theme' -%}Giao diện
+{%- when 'translation_key' -%}Khóa dịch
+{%- when 'translation_missing' -%}Trang này chưa được dịch. Đọc bằng:
+{%- when 'type' -%}Loại
+{%- when 'versions' -%}Phiên bản
+{%- when 'yes' -%}Có
+{%- endcase -%}

data/_includes/i18n/yi.html

@@ -0,0 +1,78 @@
+{%- case include.key -%}
+{%- when 'about_author' -%}וועגן דעם מחבר
+{%- when 'accepted' -%}Accepted
+{%- when 'adr_date' -%}Date
+{%- when 'adr_deciders' -%}Deciders
+{%- when 'adr_status' -%}Status
+{%- when 'adr_superseded_by' -%}Superseded by
+{%- when 'adr_supersedes' -%}Supersedes
+{%- when 'and' -%}און
+{%- when 'breadcrumbs' -%}ברעקלעך
+{%- when 'by' -%}דורך
+{%- when 'categories' -%}קאַטעגאָריעס
+{%- when 'comma' -%},
+{%- when 'comments' -%}קאָמענטאַרן
+{%- when 'copied' -%}קאָפּירט
+{%- when 'copy' -%}קאָפּירן
+{%- when 'copy_failed' -%}דריקט Ctrl+C
+{%- when 'copy_page_md' -%}קאָפּירן בלאַט ווי Markdown
+{%- when 'default' -%}Default
+{%- when 'deprecated' -%}Deprecated
+{%- when 'description' -%}Description
+{%- when 'docs_nav' -%}דאָקומענטאַציע
+{%- when 'edit_label' -%}רעדאַקטירן מיט דיין אַגענט
+{%- when 'edit_prompt' -%}רעדאַקטירן {source}. קראַנט טעקסט: "{text}". טוישן:
+{%- when 'edited_on' -%}רעדאַקטירט אום
+{%- when 'example_request' -%}Example request
+{%- when 'example_response' -%}Example response
+{%- when 'go_home' -%}גיין צום הויפּט בלאַט
+{%- when 'home' -%}הויפּט בלאַט
+{%- when 'language' -%}שפּראַך
+{%- when 'last_updated' -%}לעצט דערהיינטיקט
+{%- when 'latest_posts' -%}לעצטע אַרטיקלען
+{%- when 'links' -%}Links
+{%- when 'main_nav' -%}הויפּט מעניו
+{%- when 'min_read' -%}מין לייענען
+{%- when 'mode_auto' -%}אויטאָמאַטיש
+{%- when 'mode_dark' -%}טונקל
+{%- when 'mode_light' -%}ליכטיק
+{%- when 'name' -%}Name
+{%- when 'next' -%}ווייטערדיק
+{%- when 'no' -%}No
+{%- when 'not_found_text' -%}דער אַדרעס עקזיסטירט נישט אָדער איז אריבערגעפירט געוואָרן. ניצט דעם זוכן פעלד אָדער גייט צום הויפּט בלאַט.
+{%- when 'not_found_title' -%}בלאַט נישט געפונען
+{%- when 'on_this_page' -%}אויף דעם בלאַט
+{%- when 'pager' -%}פֿריִערדיקער און ווייטערדיקער
+{%- when 'parameters' -%}Parameters
+{%- when 'partial' -%}Partial
+{%- when 'post_pager' -%}פֿריִערדיקער און ווייטערדיקער אַרטיקל
+{%- when 'posts' -%}אַרטיקלען
+{%- when 'previous' -%}פֿריִערדיקער
+{%- when 'proposed' -%}Proposed
+{%- when 'rejected' -%}Rejected
+{%- when 'related_posts' -%}פֿאַרבונדענע אַרטיקלען
+{%- when 'releases' -%}Releases
+{%- when 'required' -%}Required
+{%- when 'scheduled' -%}פארגעפלאנט
+{%- when 'search' -%}זוכן
+{%- when 'search_count' -%}{n} רעזולטאַטן
+{%- when 'search_none' -%}קיין רעזולטאַטן
+{%- when 'series' -%}סעריע
+{%- when 'series_pager' -%}פֿריִערדיקער און ווייטערדיקער אין דער סעריע
+{%- when 'series_part' -%}טייל {n} פֿון {total}
+{%- when 'skip' -%}איבערהיפּערן צום אינהאַלט
+{%- when 'social_links' -%}Social links
+{%- when 'status_beta' -%}Beta
+{%- when 'status_deprecated' -%}Deprecated
+{%- when 'status_experimental' -%}Experimental
+{%- when 'status_replaced_by' -%}Replaced by
+{%- when 'status_since' -%}Since
+{%- when 'superseded' -%}Superseded
+{%- when 'tags' -%}טאַגס
+{%- when 'theme' -%}טעמע
+{%- when 'translation_key' -%}איבערזעצונג שליסל
+{%- when 'translation_missing' -%}This page hasn't been translated yet. Read it in:
+{%- when 'type' -%}Type
+{%- when 'versions' -%}Versions
+{%- when 'yes' -%}Yes
+{%- endcase -%}

data/_includes/i18n/zh.html

@@ -1,35 +1,59 @@
 {%- case include.key -%}
 {%- when 'about_author' -%}关于作者
+{%- when 'accepted' -%}Accepted
+{%- when 'adr_date' -%}Date
+{%- when 'adr_deciders' -%}Deciders
+{%- when 'adr_status' -%}Status
+{%- when 'adr_superseded_by' -%}Superseded by
+{%- when 'adr_supersedes' -%}Supersedes
 {%- when 'and' -%}和
 {%- when 'breadcrumbs' -%}面包屑导航
 {%- when 'by' -%}作者
 {%- when 'categories' -%}分类
 {%- when 'comma' -%}，
+{%- when 'comments' -%}评论
 {%- when 'copied' -%}已复制
 {%- when 'copy' -%}复制
 {%- when 'copy_failed' -%}按Ctrl+C
 {%- when 'copy_page_md' -%}复制页面为Markdown
+{%- when 'default' -%}Default
+{%- when 'deprecated' -%}Deprecated
+{%- when 'description' -%}Description
 {%- when 'docs_nav' -%}文档
 {%- when 'edit_label' -%}与您的助手一起编辑
 {%- when 'edit_prompt' -%}编辑 {source}。当前文本："{text}"。更改：
+{%- when 'edited_on' -%}编辑于
+{%- when 'example_request' -%}Example request
+{%- when 'example_response' -%}Example response
 {%- when 'go_home' -%}返回主页
 {%- when 'home' -%}首页
 {%- when 'language' -%}语言
+{%- when 'last_updated' -%}最后更新
 {%- when 'latest_posts' -%}最新文章
+{%- when 'links' -%}Links
 {%- when 'main_nav' -%}主导航
 {%- when 'min_read' -%}分钟阅读
 {%- when 'mode_auto' -%}自动
 {%- when 'mode_dark' -%}深色
 {%- when 'mode_light' -%}浅色
+{%- when 'name' -%}Name
 {%- when 'next' -%}下一个
+{%- when 'no' -%}No
 {%- when 'not_found_text' -%}此地址不存在或已移动。请使用搜索框或返回主页。
 {%- when 'not_found_title' -%}未找到页面
 {%- when 'on_this_page' -%}本页内容
 {%- when 'pager' -%}上一页和下一页
+{%- when 'parameters' -%}Parameters
+{%- when 'partial' -%}Partial
 {%- when 'post_pager' -%}上一篇和下一篇文章
 {%- when 'posts' -%}文章
 {%- when 'previous' -%}上一个
+{%- when 'proposed' -%}Proposed
+{%- when 'rejected' -%}Rejected
 {%- when 'related_posts' -%}相关文章
+{%- when 'releases' -%}Releases
+{%- when 'required' -%}Required
+{%- when 'scheduled' -%}定时发布
 {%- when 'search' -%}搜索
 {%- when 'search_count' -%}{n} 个结果
 {%- when 'search_none' -%}无结果
@@ -37,7 +61,18 @@
 {%- when 'series_pager' -%}本系列的上一个和下一个
 {%- when 'series_part' -%}第 {n} 部分，共 {total} 部分
 {%- when 'skip' -%}跳至内容
+{%- when 'social_links' -%}Social links
+{%- when 'status_beta' -%}Beta
+{%- when 'status_deprecated' -%}Deprecated
+{%- when 'status_experimental' -%}Experimental
+{%- when 'status_replaced_by' -%}Replaced by
+{%- when 'status_since' -%}Since
+{%- when 'superseded' -%}Superseded
 {%- when 'tags' -%}标签
 {%- when 'theme' -%}主题
 {%- when 'translation_key' -%}翻译键
+{%- when 'translation_missing' -%}This page hasn't been translated yet. Read it in:
+{%- when 'type' -%}Type
+{%- when 'versions' -%}Versions
+{%- when 'yes' -%}Yes
 {%- endcase -%}

data/_includes/i18n-builtin.html

@@ -1,6 +1,6 @@
 {%- comment -%} Built-in UI strings. A site overrides or adds languages in _data/i18n/<lang>.yml. {%- endcomment -%}
 {%- assign sl_builtin_lang = include.lang -%}
-{%- assign sl_supported = 'fa,ar,he,es,fr,pt,de,it,ru,tr,nl,ja,zh,en' | split: ',' -%}
+{%- assign sl_supported = 'el,fa,ar,he,ur,ckb,dv,ps,sd,yi,ug,es,fr,pt,de,it,ru,tr,nl,ja,zh,az,hu,nb,th,ta,uk,ro,sw,hi,id,ko,ms,bn,vi,cs,da,pl,fi,sv,en' | split: ',' -%}
 {%- unless sl_supported contains sl_builtin_lang -%}
   {%- assign sl_builtin_lang = 'en' -%}
 {%- endunless -%}

data/_includes/jsonld.html

@@ -16,20 +16,22 @@
 {%- assign sl_ld_lang = page.lang | default: site.lang | default: 'en' -%}
 {%- assign sl_ld_title = page.title | default: site.title -%}
 {%- assign sl_ld_author = site.author.name | default: site.author -%}
+{%- assign sl_ld_url = page.canonical_url | default: page.url | absolute_url -%}
 {%- capture sl_ld_site -%}{"@type":"WebSite","name":{{ site.title | default: sl_ld_title | jsonify }},"url":{{ '/' | absolute_url | jsonify }}}{%- endcapture -%}
 {%- capture sl_ld -%}
 {"@context":"https://schema.org","@type":"{{ sl_ld_type }}"
 {%- if sl_ld_type == 'WebSite' -%}
 ,"name":{{ site.title | default: sl_ld_title | jsonify }}
 {%- elsif sl_ld_type == 'BlogPosting' or sl_ld_type == 'TechArticle' -%}
-,"headline":{{ sl_ld_title | jsonify }},"mainEntityOfPage":{{ page.url | absolute_url | jsonify }},"isPartOf":{{ sl_ld_site }}
+,"headline":{{ sl_ld_title | jsonify }},"mainEntityOfPage":{{ sl_ld_url | jsonify }},"isPartOf":{{ sl_ld_site }}
 {%- else -%}
 ,"name":{{ sl_ld_title | jsonify }},"isPartOf":{{ sl_ld_site }}
 {%- endif -%}
-,"url":{{ page.url | absolute_url | jsonify }},"inLanguage":{{ sl_ld_lang | jsonify }}
+,"url":{{ sl_ld_url | jsonify }},"inLanguage":{{ sl_ld_lang | jsonify }}
 {%- if sl_desc and sl_desc != '' -%},"description":{{ sl_desc | jsonify }}{%- endif -%}
 {%- if sl_ld_type == 'BlogPosting' and page.date -%}
-,"datePublished":{{ page.date | date_to_xmlschema | jsonify }},"dateModified":{{ page.date | date_to_xmlschema | jsonify }}
+{%- assign sl_ld_modified = page.updated | default: page.last_modified_at | default: page.date -%}
+,"datePublished":{{ page.date | date_to_xmlschema | jsonify }},"dateModified":{{ sl_ld_modified | date_to_xmlschema | jsonify }}
 {%- endif -%}
 {%- if sl_ld_type == 'BlogPosting' or sl_ld_type == 'TechArticle' -%}
 {%- if sl_ld_author -%},"author":{"@type":"Person","name":{{ sl_ld_author | jsonify }}}{%- endif -%}

data/_includes/last-updated.html

@@ -0,0 +1,12 @@
+{%- comment -%}
+  "Last updated" for a doc page: page.last_modified_at from front matter, or, in Actions mode, from
+  the page's last git commit (_plugins/slipway_last_modified.rb). A page without a date shows nothing,
+  so classic Pages keeps working without the plugin. The date is localized by date.html; the
+  datetime attribute stays the machine-readable ISO 8601 value. Plain HTML, so it reads without
+  JavaScript and follows the text direction.
+{%- endcomment -%}
+{%- assign sl_lu_date = page.last_modified_at -%}
+{%- if sl_lu_date -%}
+{%- capture sl_lu_text -%}{% include date.html date=sl_lu_date %}{%- endcapture -%}
+<p class="sl-last-updated">{% include t.html key='last_updated' %} <time datetime="{{ sl_lu_date | date_to_xmlschema }}">{{ sl_lu_text | strip }}</time></p>
+{%- endif -%}

data/_includes/page-status.html

@@ -0,0 +1,19 @@
+{%- if page.status -%}
+{%- include component-css.html name="page-status" -%}
+<div class="sl-page-status sl-page-status-{{ page.status }}">
+  {%- capture sl_status_text -%}
+    {%- case page.status -%}
+      {%- when 'experimental' -%}{%- include t.html key="status_experimental" -%}
+      {%- when 'beta' -%}{%- include t.html key="status_beta" -%}
+      {%- when 'deprecated' -%}{%- include t.html key="status_deprecated" -%}
+    {%- endcase -%}
+  {%- endcapture -%}
+  <strong>{{ sl_status_text }}</strong>
+  {%- if page.status == 'deprecated' and page.since -%}
+    <span> {% include t.html key="status_since" %} {{ page.since }}.</span>
+  {%- endif -%}
+  {%- if page.status == 'deprecated' and page.replaced_by -%}
+    <span> {% include t.html key="status_replaced_by" %} <a href="{{ page.replaced_by | relative_url }}">{{ page.replaced_by }}</a>.</span>
+  {%- endif -%}
+</div>
+{%- endif -%}

data/_includes/schema-table.html

@@ -0,0 +1,122 @@
+{%- comment -%}
+  Renders a JSON Schema (usually from _data) as a property table: name, type,
+  required, default, and description. Nested object properties render as a
+  sub-table one level deep; enum and oneOf show in the type cell.
+
+    {% include schema-table.html schema=site.data.widget_schema %}
+{%- endcomment -%}
+{%- if include.schema.properties and include.schema.properties.size > 0 -%}
+  {%- include component-css.html name="schema-table" -%}
+  <div class="sl-schema-table-wrapper">
+    <table class="sl-schema-table">
+      <thead>
+        <tr>
+          <th scope="col">{% include i18n-builtin.html key="name" %}</th>
+          <th scope="col">{% include i18n-builtin.html key="type" %}</th>
+          <th scope="col">{% include i18n-builtin.html key="required" %}</th>
+          <th scope="col">{% include i18n-builtin.html key="default" %}</th>
+          <th scope="col">{% include i18n-builtin.html key="description" %}</th>
+        </tr>
+      </thead>
+      <tbody>
+        {%- for sl_property in include.schema.properties -%}
+          {%- assign sl_name = sl_property[0] -%}
+          {%- assign sl_prop = sl_property[1] -%}
+          <tr class="sl-schema-row">
+            <th scope="row" class="sl-schema-name"><code>{{ sl_name }}</code></th>
+            <td class="sl-schema-type">
+              {%- if sl_prop.type -%}
+                <code>{{ sl_prop.type | join: " | " }}</code>
+              {%- elsif sl_prop.oneOf -%}
+                <code>{{ sl_prop.oneOf | map: "type" | join: " | " }}</code>
+              {%- elsif sl_prop.properties -%}
+                <code>object</code>
+              {%- elsif sl_prop.items -%}
+                <code>array</code>
+              {%- endif -%}
+              {%- if sl_prop.enum -%}
+                <ul class="sl-schema-values">
+                  {%- for sl_value in sl_prop.enum -%}
+                    <li><code>{{ sl_value }}</code></li>
+                  {%- endfor -%}
+                </ul>
+              {%- endif -%}
+            </td>
+            <td class="sl-schema-required">
+              {%- if include.schema.required contains sl_name -%}
+                {% include i18n-builtin.html key="yes" %}
+              {%- else -%}
+                {% include i18n-builtin.html key="no" %}
+              {%- endif -%}
+            </td>
+            <td class="sl-schema-default">
+              {%- if sl_prop.default != nil -%}<code>{{ sl_prop.default | jsonify }}</code>{%- endif -%}
+            </td>
+            <td class="sl-schema-description">{%- if sl_prop.description %} {{ sl_prop.description | markdownify | strip }}{%- endif -%}</td>
+          </tr>
+          {%- assign sl_children = sl_prop.properties -%}
+          {%- assign sl_children_required = sl_prop.required -%}
+          {%- unless sl_children -%}
+            {%- assign sl_children = sl_prop.items.properties -%}
+            {%- assign sl_children_required = sl_prop.items.required -%}
+          {%- endunless -%}
+          {%- if sl_children and sl_children.size > 0 -%}
+            <tr class="sl-schema-children">
+              <td colspan="5">
+                <table class="sl-schema-table sl-schema-table-nested">
+                  <thead>
+                    <tr>
+                      <th scope="col">{% include i18n-builtin.html key="name" %}</th>
+                      <th scope="col">{% include i18n-builtin.html key="type" %}</th>
+                      <th scope="col">{% include i18n-builtin.html key="required" %}</th>
+                      <th scope="col">{% include i18n-builtin.html key="default" %}</th>
+                      <th scope="col">{% include i18n-builtin.html key="description" %}</th>
+                    </tr>
+                  </thead>
+                  <tbody>
+                    {%- for sl_child in sl_children -%}
+                      {%- assign sl_child_name = sl_child[0] -%}
+                      {%- assign sl_child_prop = sl_child[1] -%}
+                      <tr class="sl-schema-row sl-schema-row-child">
+                        <th scope="row" class="sl-schema-name"><code>{{ sl_child_name }}</code></th>
+                        <td class="sl-schema-type">
+                          {%- if sl_child_prop.type -%}
+                            <code>{{ sl_child_prop.type | join: " | " }}</code>
+                          {%- elsif sl_child_prop.oneOf -%}
+                            <code>{{ sl_child_prop.oneOf | map: "type" | join: " | " }}</code>
+                          {%- elsif sl_child_prop.properties -%}
+                            <code>object</code>
+                          {%- elsif sl_child_prop.items -%}
+                            <code>array</code>
+                          {%- endif -%}
+                          {%- if sl_child_prop.enum -%}
+                            <ul class="sl-schema-values">
+                              {%- for sl_value in sl_child_prop.enum -%}
+                                <li><code>{{ sl_value }}</code></li>
+                              {%- endfor -%}
+                            </ul>
+                          {%- endif -%}
+                        </td>
+                        <td class="sl-schema-required">
+                          {%- if sl_children_required contains sl_child_name -%}
+                            {% include i18n-builtin.html key="yes" %}
+                          {%- else -%}
+                            {% include i18n-builtin.html key="no" %}
+                          {%- endif -%}
+                        </td>
+                        <td class="sl-schema-default">
+                          {%- if sl_child_prop.default != nil -%}<code>{{ sl_child_prop.default | jsonify }}</code>{%- endif -%}
+                        </td>
+                        <td class="sl-schema-description">{%- if sl_child_prop.description %} {{ sl_child_prop.description | markdownify | strip }}{%- endif -%}</td>
+                      </tr>
+                    {%- endfor -%}
+                  </tbody>
+                </table>
+              </td>
+            </tr>
+          {%- endif -%}
+        {%- endfor -%}
+      </tbody>
+    </table>
+  </div>
+{%- endif -%}

data/_includes/seo.html

@@ -1,6 +1,6 @@
 {%- 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_url = page.canonical_url | default: 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 %}">
@@ -14,9 +14,29 @@
   {%- if sl_desc != '' %}
   <meta property="og:description" content="{{ sl_desc | escape }}">
   {%- endif %}
-  <meta property="og:image" content="{{ '/assets/images/social.png' | absolute_url }}">
+{%- comment %} The social image: the page's `image` first, then the one the Actions plugin generated from the title (page.slipway_og, _plugins/slipway_og.rb), then the shared asset a site may replace (docs/overrides.md). Only the shared and generated pictures are known to be 1200 by 630. {% endcomment %}
+{%- assign sl_og_image = page.image %}
+{%- if sl_og_image %}
+{%- assign sl_og_card = 'summary_large_image' %}
+{%- else %}
+{%- assign sl_og_image = page.slipway_og %}
+{%- if sl_og_image %}
+{%- assign sl_og_sized = true %}
+{%- assign sl_og_card = 'summary_large_image' %}
+{%- else %}
+{%- assign sl_og_image = '/assets/images/social.png' %}
+{%- assign sl_og_sized = true %}
+{%- assign sl_og_card = 'summary' %}
+{%- endif %}
+{%- endif %}
+  <meta property="og:image" content="{{ sl_og_image | absolute_url }}">
+  {%- if sl_seo_title %}
+  <meta property="og:image:alt" content="{{ sl_seo_title | escape }}">
+  {%- endif %}
+  {%- if sl_og_sized %}
   <meta property="og:image:width" content="1200">
   <meta property="og:image:height" content="630">
+  {%- endif %}
   <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 }}">
@@ -24,7 +44,7 @@
   <meta property="article:tag" content="{{ tag | escape }}">
   {%- endfor %}
   {%- endif %}
-  <meta name="twitter:card" content="summary">
+  <meta name="twitter:card" content="{{ sl_og_card }}">
   {%- 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 %}

data/_includes/snippet.html

@@ -0,0 +1,20 @@
+{%- comment -%}
+  A region of a repository file, copied into _data/snippets.json by tools/snippets/sync.mjs.
+  Usage: {% include snippet.html file="src/app.ts" region="setup" %}
+{%- endcomment -%}
+{%- assign snippet_key = include.file | downcase | replace: '/', '-' | replace: '.', '-' | replace: '_', '-' | replace: ' ', '-' -%}
+{%- assign snippet_key = snippet_key | append: '--' | append: include.region | downcase | replace: ' ', '-' -%}
+{%- assign snippet = site.data.snippets[snippet_key] -%}
+{%- assign snippet_repo = site.github.repository_url | default: site.repository_url -%}
+{%- if snippet -%}
+<figure class="sl-snippet">
+  <pre><code class="language-{{ snippet.lang | escape }}">{{ snippet.text | escape }}</code></pre>
+  <figcaption>
+    {%- if snippet_repo -%}
+    <a href="{{ snippet_repo }}/blob/HEAD/{{ snippet.file }}#L{{ snippet.line }}">{{ snippet.file }}:{{ snippet.line }}</a>
+    {%- else -%}
+    {{ snippet.file }}:{{ snippet.line }}
+    {%- endif -%}
+  </figcaption>
+</figure>
+{%- endif -%}

data/_layouts/adr-index.html

@@ -0,0 +1,32 @@
+---
+layout: base
+---
+{%- include component-css.html name="adr" -%}
+{%- assign sl_adr_docs = site.documents | concat: site.pages | where: 'layout', 'adr' | sort: 'title' -%}
+<div class="sl-adr-index">
+  <header class="sl-page-header">
+    <h1>{{ page.title | escape }}</h1>
+    {%- if page.description %}
+    <p class="sl-page-lead">{{ page.description }}</p>
+    {%- endif %}
+  </header>
+
+  {% assign statuses = "proposed,accepted,rejected,superseded,deprecated" | split: "," %}
+
+  {% for status in statuses %}
+    {% assign docs = sl_adr_docs | where: "status", status %}
+    {% if docs.size > 0 %}
+      <section class="sl-adr-group">
+        <h2>{% include t.html key=status %}</h2>
+        <ul>
+          {% for doc in docs %}
+            <li>
+              <a href="{{ doc.url | relative_url }}">{{ doc.title | escape }}</a>
+              {% if doc.date %}<time datetime="{{ doc.date | date_to_xmlschema }}">{% include date.html date=doc.date %}</time>{% endif %}
+            </li>
+          {% endfor %}
+        </ul>
+      </section>
+    {% endif %}
+  {% endfor %}
+</div>

data/_layouts/adr.html

@@ -0,0 +1,45 @@
+---
+layout: base
+---
+{%- include component-css.html name="adr" -%}
+{%- assign sl_adr_docs = site.documents | concat: site.pages | where: 'layout', 'adr' -%}
+<article class="sl-adr">
+  <header class="sl-adr-header">
+    <h1>{{ page.title | escape }}</h1>
+    <dl class="sl-adr-meta">
+      <dt>{% include t.html key='adr_status' %}</dt>
+      <dd class="sl-adr-status sl-adr-status-{{ page.status | escape }}">{% include t.html key=page.status %}</dd>
+      {% if page.date %}
+      <dt>{% include t.html key='adr_date' %}</dt>
+      <dd><time datetime="{{ page.date | date_to_xmlschema }}">{% include date.html date=page.date %}</time></dd>
+      {% endif %}
+      {% if page.deciders and page.deciders.size > 0 %}
+      <dt>{% include t.html key='adr_deciders' %}</dt>
+      <dd>{{ page.deciders | join: ', ' | escape }}</dd>
+      {% endif %}
+      {% if page.supersedes %}
+      <dt>{% include t.html key='adr_supersedes' %}</dt>
+      <dd>
+        {% assign superseded_docs = sl_adr_docs | where: "title", page.supersedes %}
+        {% if superseded_docs.size > 0 %}
+          <a href="{{ superseded_docs.first.url | relative_url }}">{{ page.supersedes | escape }}</a>
+        {% else %}
+          {{ page.supersedes | escape }}
+        {% endif %}
+      </dd>
+      {% endif %}
+      {% if page.superseded_by %}
+      <dt>{% include t.html key='adr_superseded_by' %}</dt>
+      <dd>
+        {% assign superseding_docs = sl_adr_docs | where: "title", page.superseded_by %}
+        {% if superseding_docs.size > 0 %}
+          <a href="{{ superseding_docs.first.url | relative_url }}">{{ page.superseded_by | escape }}</a>
+        {% else %}
+          {{ page.superseded_by | escape }}
+        {% endif %}
+      </dd>
+      {% endif %}
+    </dl>
+  </header>
+  {{ content }}
+</article>

data/_layouts/changelog-feed.html

@@ -0,0 +1,28 @@
+---
+---
+<?xml version="1.0" encoding="UTF-8"?>
+{%- assign sl_source = site.pages | where: 'url', page.changelog | first -%}
+{%- assign sl_source_html = sl_source.content | markdownify -%}
+{%- assign sl_sections = sl_source_html | split: '<h2 id="' -%}
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <id>{{ page.url | absolute_url | xml_escape }}</id>
+  <title>{{ sl_source.title | default: page.title | xml_escape }}</title>
+  <updated>{{ site.time | date_to_xmlschema }}</updated>
+  <link href="{{ page.url | absolute_url | xml_escape }}" rel="self" type="application/atom+xml"/>
+  <link href="{{ sl_source.url | absolute_url | xml_escape }}"/>
+  {%- for sl_section in sl_sections offset: 1 -%}
+    {%- include changelog-version.html section=sl_section -%}
+    {%- assign sl_unreleased = sl_release_version | downcase -%}
+    {%- if sl_unreleased == 'unreleased' -%}{%- continue -%}{%- endif -%}
+    {%- assign sl_release_body = sl_section | split: '</h2>' | last -%}
+    {%- assign sl_release_url = sl_source.url | absolute_url | append: '#' | append: sl_release_id -%}
+  <entry>
+    <id>{{ sl_release_url | xml_escape }}</id>
+    <title>{{ sl_release_version | xml_escape }}</title>
+    <link href="{{ sl_release_url | xml_escape }}"/>
+    <updated>{{ sl_release_date | date_to_xmlschema }}</updated>
+    <author><name>{{ site.author | default: site.title | default: 'Slipway' | xml_escape }}</name></author>
+    <content type="html">{{ sl_release_body | xml_escape }}</content>
+  </entry>
+  {%- endfor %}
+</feed>

data/_layouts/changelog.html

@@ -0,0 +1,40 @@
+---
+layout: base
+---
+{% include component-css.html name="changelog" %}
+<article class="sl-page sl-changelog">
+  <header class="sl-page-header">
+    {% include breadcrumbs.html %}
+    <h1>{{ page.title | escape }}</h1>{% include copy-page.html %}
+    {%- if page.description %}
+    <p class="sl-page-lead">{{ page.description | escape }}</p>
+    {%- endif %}
+  </header>
+  {%- assign sl_sections = content | split: '<h2 id="' %}
+  <div class="sl-changelog-layout">
+    <div class="sl-changelog-main">
+      {{ sl_sections.first }}
+      {%- for sl_section in sl_sections offset: 1 %}
+        {%- include changelog-version.html section=sl_section %}
+        {%- assign sl_old_id = sl_section | split: '"' | first %}
+        {%- assign sl_old_attr = 'id="' | append: sl_old_id | append: '"' %}
+        {%- assign sl_new_attr = 'id="' | append: sl_release_id | append: '"' %}
+        {%- assign sl_section_html = '<h2 id="' | append: sl_section %}
+        {{ sl_section_html | replace_first: sl_old_attr, sl_new_attr }}
+      {%- endfor %}
+    </div>
+    <aside class="sl-changelog-sidebar">
+      <nav aria-label="{% include t.html key='versions' %}">
+        <ul class="sl-changelog-toc">
+          {%- for sl_section in sl_sections offset: 1 %}
+            {%- include changelog-version.html section=sl_section %}
+            <li><a href="#{{ sl_release_id }}">{{ sl_release_version | escape }}</a></li>
+          {%- endfor %}
+        </ul>
+        {%- if page.feed_url %}
+        <a href="{{ page.feed_url | relative_url }}" class="sl-changelog-feed" type="application/atom+xml">{% include t.html key='releases' %}</a>
+        {%- endif %}
+      </nav>
+    </aside>
+  </div>
+</article>