datalog-theme 0.10.0 → 0.11.0

data/_includes/meta/schema.html

@@ -13,10 +13,24 @@ Provides rich structured data for:
 - Publisher: a Person or an Organization, from `publisher` in _config.yml
 - Images, keywords, and content metadata
 
-Defaults to TechArticle for posts, WebPage for other pages.
+Defaults to TechArticle for posts, WebPage for other pages. A dataset page
+adds a Dataset node, and a package page a SoftwareSourceCode node. `schema_type:
+ProfilePage` describes a page about a person or an organization: its
+`mainEntity` is the page's first author (the site's author by default), or the
+publisher with `main_entity: publisher`.
+
+The site's author and the publisher carry stable `@id`s under the site's root
+(`#person`, `#organization`), so every page names the same entities. With
+`site_identity` in _config.yml, the homepage also describes the site itself: a
+`WebSite` node (`#website`) with its name and other names, and the publisher's
+full node, which search engines read as the site's name and owner.
 {%- endcomment -%}
 {%- assign schema_page = include.page -%}
 {%- include meta/publisher.html -%}
+{%- assign schema_identity = site | site_identity -%}
+{%- assign website_id = identity_root | append: '#website' -%}
+{%- assign is_home = false -%}
+{%- if schema_page.url == '/' or schema_page.url == '/index.html' -%}{%- assign is_home = true -%}{%- endif -%}
 {%- assign is_post = false -%}
 {%- if schema_page.layout == 'post' or schema_page.collection == 'posts' -%}
   {%- assign is_post = true -%}
@@ -27,6 +41,10 @@ Defaults to TechArticle for posts, WebPage for other pages.
 {%- endif -%}
 {%- assign schema_type = include.type | default: schema_page.schema_type | default: layout.schema_type | default: default_type -%}
 {%- if schema_type == 'TechnicalArticle' -%}{%- assign schema_type = 'TechArticle' -%}{%- endif -%}
+{%- assign is_profile_page = false -%}
+{%- if schema_type == 'ProfilePage' -%}{%- assign is_profile_page = true -%}{%- endif -%}
+{%- assign part_of_website = false -%}
+{%- if schema_identity -%}{%- if is_home or is_profile_page -%}{%- assign part_of_website = true -%}{%- endif -%}{%- endif -%}
 {%- assign csp_registry = site.data.csp | default: {} -%}
 {%- assign nonce_lookup = csp_registry.nonces | default: {} -%}
 {%- assign schema_nonce = schema_page.csp_nonce | default: page.csp_nonce | default: nonce_lookup[schema_page.path] | default: nonce_lookup[page.path] | default: nonce_lookup[page.url] -%}
@@ -36,28 +54,67 @@ Defaults to TechArticle for posts, WebPage for other pages.
 {%- assign schema_authors = schema_page | page_authors -%}
 {%- assign schema_contributors = schema_page | page_contributors -%}
 {%- assign word_count = schema_page.content | strip_html | number_of_words -%}
-{%- assign modified = schema_page.last_modified_at | default: schema_page.updated | default: schema_page.date -%}
+{%- comment -%} An undated document's date is the build's: it is no publication date (#411). {%- endcomment -%}
+{%- assign schema_published = schema_page | published_date -%}
+{%- assign modified = schema_page.last_modified_at | default: schema_page.updated | default: schema_published -%}
+{%- capture publisher_json -%}
+{
+    "@type": {{ publisher_type | jsonify_script }},
+    "@id": {{ publisher_id | jsonify_script }},
+    "name": {{ publisher_name | jsonify_script }},
+    "url": {{ publisher_url | jsonify_script }}
+    {%- if publisher_logo -%},
+    "logo": {
+      "@type": "ImageObject",
+      "url": {{ publisher_logo | jsonify_script }}
+      {%- if publisher_logo_default -%},
+      "width": 512,
+      "height": 512
+      {%- endif -%}
+    }
+    {%- endif -%}
+  }
+{%- endcapture -%}
 <script type="application/ld+json" nonce="{{ schema_nonce }}">
 {
   "@context": "https://schema.org",
   "@type": {{ schema_type | jsonify_script }},
+  {%- comment -%} A ProfilePage is the page itself, about its mainEntity; any other type is the page's main entity. {%- endcomment -%}
+  {%- if is_profile_page %}
+  "@id": {{ page_url | jsonify_script }},
+  "name": {{ schema_page.title | default: site.title | jsonify_script }},
+  {%- assign profile_entity = schema_authors | first -%}
+  "mainEntity": {% if schema_page.main_entity == 'publisher' or profile_entity == nil %}{{ publisher_json }}{% else %}{% include meta/person-json.html person=profile_entity %}{% endif %},
+  {%- else %}
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": {{ page_url | jsonify_script }}
   },
+  {%- endif %}
+  {%- if part_of_website %}
+  "isPartOf": { "@id": {{ website_id | jsonify_script }} },
+  {%- endif %}
   "headline": {{ schema_page.title | default: site.title | truncate: 110 | jsonify_script }},
   {%- comment -%} Values the page doesn't have are left out: "description": "" and "dateModified": "" are invalid structured data. {%- endcomment -%}
   {%- if description and description != "" -%}
   "description": {{ description | jsonify_script }},
   {%- endif -%}
   "url": {{ page_url | jsonify_script }},
-  {%- if schema_page.image or schema_page.og_image -%}
+  {%- assign schema_image = schema_page.image | strip | default: schema_page.og_image | strip -%}
+  {%- if schema_image != "" -%}
   "image": {
     "@type": "ImageObject",
-    "url": {{ schema_page.image | default: schema_page.og_image | absolute_url | jsonify_script }},
+    "url": {{ schema_image | absolute_url | jsonify_script }},
     "width": {{ schema_page.image_width | default: 1200 }},
     "height": {{ schema_page.image_height | default: 630 }}
   },
+  {%- elsif schema_page.datalog_social_card -%}
+  "image": {
+    "@type": "ImageObject",
+    "url": {{ schema_page.datalog_social_card.url | absolute_url | jsonify_script }},
+    "width": {{ schema_page.datalog_social_card.width }},
+    "height": {{ schema_page.datalog_social_card.height }}
+  },
   {%- elsif site.social.default_image -%}
   "image": {
     "@type": "ImageObject",
@@ -66,8 +123,8 @@ Defaults to TechArticle for posts, WebPage for other pages.
     "height": 630
   },
   {%- endif -%}
-  {%- if schema_page.date -%}
-  "datePublished": "{{ schema_page.date | date_to_xmlschema }}",
+  {%- if schema_published -%}
+  "datePublished": "{{ schema_published | date_to_xmlschema }}",
   {%- endif -%}
   {%- if modified -%}
   "dateModified": "{{ modified | date_to_xmlschema }}",
@@ -99,21 +156,7 @@ Defaults to TechArticle for posts, WebPage for other pages.
   {%- endfor -%}
   ],
   {%- endif -%}
-  "publisher": {
-    "@type": {{ publisher_type | jsonify_script }},
-    "name": {{ publisher_name | jsonify_script }},
-    "url": {{ publisher_url | jsonify_script }}
-    {%- if publisher_logo -%},
-    "logo": {
-      "@type": "ImageObject",
-      "url": {{ publisher_logo | jsonify_script }}
-      {%- if publisher_logo_default -%},
-      "width": 512,
-      "height": 512
-      {%- endif -%}
-    }
-    {%- endif -%}
-  }
+  "publisher": {{ publisher_json }}
   {%- if schema_page.doi -%},
   "identifier": {
     "@type": "PropertyValue",
@@ -121,8 +164,9 @@ Defaults to TechArticle for posts, WebPage for other pages.
     "value": {{ schema_page.doi | jsonify_script }}
   }
   {%- endif -%}
-  {%- if schema_page.citation_key -%},
-  "citation": {{ schema_page.citation_key | jsonify_script }}
+  {%- comment -%} The works the page cites with {% raw %}{% cite %}{% endraw %}; its own citation key is not one of them {%- endcomment -%}
+  {%- if schema_page.datalog_cited_works and schema_page.datalog_cited_works.size > 0 -%},
+  "citation": {{ schema_page.datalog_cited_works | map: 'json_ld' | jsonify_script }}
   {%- endif -%}
   {%- comment -%} The licence of the text and figures, and who holds the copyright. {%- endcomment -%}
   {%- assign content_license = schema_page | page_license -%}
@@ -161,6 +205,47 @@ Defaults to TechArticle for posts, WebPage for other pages.
   {%- endif -%}
 }
 </script>
+{%- comment -%}
+  The homepage describes the site itself, once, for every other page's `@id`
+  to point at: the WebSite, its names and its publisher (#322).
+{%- endcomment -%}
+{%- if schema_identity and is_home -%}
+{%- assign identity_person = site | site_author_record -%}
+{%- assign site_language = site.lang | default: site.locale | default: 'en' | split: '_' | first -%}
+<script type="application/ld+json" nonce="{{ schema_nonce }}">
+{
+  "@context": "https://schema.org",
+  "@graph": [
+    {
+      "@type": "WebSite",
+      "@id": {{ website_id | jsonify_script }},
+      "url": {{ identity_root | jsonify_script }},
+      "name": {{ schema_identity.name | jsonify_script }}
+      {%- if schema_identity.alternate_names.size > 0 -%},
+      "alternateName": {% if schema_identity.alternate_names.size == 1 %}{{ schema_identity.alternate_names.first | jsonify_script }}{% else %}{{ schema_identity.alternate_names | jsonify_script }}{% endif %}
+      {%- endif -%}
+      {%- if site.description -%},
+      "description": {{ site.description | strip_html | normalize_whitespace | jsonify_script }}
+      {%- endif -%},
+      "inLanguage": {{ site_language | jsonify_script }},
+      "publisher": { "@id": {{ publisher_id | jsonify_script }} }
+    },
+    {% if publisher_is_site_author and identity_person %}{% include meta/person-json.html person=identity_person %}{% else %}{{ publisher_json }}{% endif %}
+  ]
+}
+</script>
+{%- endif -%}
+{%- comment -%}
+  A dataset page also describes the dataset itself. Google Dataset Search
+  indexes `Dataset` and nothing else, so the WebPage above does not reach it.
+{%- endcomment -%}
+{%- if schema_page.collection == 'datasets' or schema_type == 'Dataset' -%}
+{%- include meta/dataset-json.html page=schema_page -%}
+{%- endif -%}
+{%- comment -%} A package page also describes the package: its repository, release and registries. {%- endcomment -%}
+{%- if schema_page.collection == 'packages' -%}
+{%- include meta/package-json.html page=schema_page -%}
+{%- endif -%}
 {%- comment -%} Add BreadcrumbList schema for posts {%- endcomment -%}
 {%- if is_post -%}
 <script type="application/ld+json" nonce="{{ schema_nonce }}">

data/_includes/meta/scholarly.html

@@ -9,7 +9,8 @@ Dublin Core equivalents. Only a page the `scholarly` filter accepts gets them
 or every post when _config.yml sets `scholarly: true`. A field the page
 lacks leaves its tag out. The authors are the page's (page_authors), as in
 the byline, the JSON-LD and the citation exports; `citation_authors` names
-the indexed authors alone.
+the indexed authors alone. Each work the page cites with {% raw %}{% cite %}{% endraw %} is
+a citation_reference (lib/datalog/plugins/citations.rb).
 {%- endcomment -%}
 {%- assign is_scholarly = page | scholarly -%}
 {%- if is_scholarly and page.title -%}
@@ -54,8 +55,9 @@ the indexed authors alone.
 {%- endif %}
 {%- endfor %}
 {%- endif %}
-{%- if page.date %}
-<meta name="citation_publication_date" content="{{ page.date | date: '%Y/%m/%d' }}" />
+{%- assign scholarly_published = page | published_date %}
+{%- if scholarly_published %}
+<meta name="citation_publication_date" content="{{ scholarly_published | date: '%Y/%m/%d' }}" />
 {%- endif %}
 <meta name="citation_public_url" content="{{ scholarly_url }}" />
 <meta name="citation_fulltext_html_url" content="{{ scholarly_url }}" />
@@ -95,13 +97,16 @@ the indexed authors alone.
 {%- if scholarly_keywords and scholarly_keywords.size > 0 %}
 <meta name="citation_keywords" content="{{ scholarly_keywords | join: '; ' | escape }}" />
 {%- endif %}
+{%- for work in page.datalog_cited_works %}
+<meta name="citation_reference" content="{{ work.reference | escape }}" />
+{%- endfor %}
 <link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" />
 <meta name="DC.title" content="{{ scholarly_title | escape }}" />
 {%- for name in scholarly_names %}
 <meta name="DC.creator" content="{{ name | strip | escape }}" />
 {%- endfor %}
-{%- if page.date %}
-<meta name="DC.date" content="{{ page.date | date: '%Y-%m-%d' }}" />
+{%- if scholarly_published %}
+<meta name="DC.date" content="{{ scholarly_published | date: '%Y-%m-%d' }}" />
 {%- endif %}
 {%- if page.doi %}
 {%- assign scholarly_identifier = page.doi -%}

data/_includes/post/related-posts.html

@@ -3,57 +3,31 @@
 required:
   - page
 optional:
-  - limit
   - date_format
 ---
-Builds a list of related posts based on overlapping tags or categories.
+Renders the posts selected at build time by _plugins/related_posts.rb.
 Falls back to a friendly message when no related content is available.
 {%- endcomment -%}
-{%- assign related_limit = include.limit | default: 3 -%}
-{%- comment -%} site.posts is already newest first. {%- endcomment -%}
-{%- assign rendered_count = 0 -%}
 <section class="post-related" aria-labelledby="post-related-heading">
   <h2 id="post-related-heading">Related posts</h2>
   <ul class="post-related-list">
-    {%- for candidate in site.posts -%}
-      {%- if rendered_count >= related_limit -%}{%- break -%}{%- endif -%}
-      {%- if candidate.url != include.page.url -%}
-        {%- assign overlap = 0 -%}
-        {%- if include.page.tags and candidate.tags -%}
-          {%- for tag in include.page.tags -%}
-            {%- if candidate.tags contains tag -%}
-              {%- assign overlap = overlap | plus: 1 -%}
-            {%- endif -%}
-          {%- endfor -%}
-        {%- endif -%}
-        {%- assign category_match = false -%}
-        {%- if include.page.categories and candidate.categories -%}
-          {%- for category in include.page.categories -%}
-            {%- if candidate.categories contains category -%}
-              {%- assign category_match = true -%}
-            {%- endif -%}
-          {%- endfor -%}
-        {%- endif -%}
-        {%- if overlap > 0 or category_match -%}
-          {%- assign rendered_count = rendered_count | plus: 1 -%}
-          <li>
-            <article class="related-post">
-              {%- if candidate.teaser -%}
-              <a class="related-post__media" href="{{ candidate.url | relative_url }}" tabindex="-1" aria-hidden="true"><img src="{{ candidate.teaser | relative_url }}" alt="" loading="lazy" decoding="async" /></a>
-              {%- endif -%}
-              <h3><a href="{{ candidate.url | relative_url }}">{{ candidate.title | escape }}</a></h3>
-              <p class="related-post-meta">
-                {% include helpers/date-format.html date=candidate.date format=include.date_format %} · {{ candidate.excerpt | strip_html | default: '' | truncate: 140 }}
-              </p>
-              {%- if candidate.tags -%}
-                <p class="related-post-tags">Topics: {% include helpers/array-to-sentence.html items=candidate.tags %}</p>
-              {%- endif -%}
-            </article>
-          </li>
-        {%- endif -%}
-      {%- endif -%}
+    {%- for candidate in include.page.related -%}
+      <li>
+        <article class="related-post">
+          {%- if candidate.teaser -%}
+          <a class="related-post__media" href="{{ candidate.url | relative_url }}" tabindex="-1" aria-hidden="true"><img src="{{ candidate.teaser | relative_url }}" alt="" loading="lazy" decoding="async" /></a>
+          {%- endif -%}
+          <h3><a href="{{ candidate.url | relative_url }}">{{ candidate.title | escape }}</a></h3>
+          <p class="related-post-meta">
+            {% include helpers/date-format.html date=candidate.date format=include.date_format %} · {{ candidate.excerpt | strip_html | default: '' | truncate: 140 }}
+          </p>
+          {%- if candidate.tags -%}
+            <p class="related-post-tags">Topics: {% include helpers/array-to-sentence.html items=candidate.tags %}</p>
+          {%- endif -%}
+        </article>
+      </li>
     {%- endfor -%}
-    {%- if rendered_count == 0 -%}
+    {%- if include.page.related.size == 0 -%}
       <li>No related posts yet. Explore the archive for more content.</li>
     {%- endif -%}
   </ul>

data/_includes/scripts.html

@@ -37,9 +37,9 @@
   {% assign reading_state_flag = 'auto' %}
 {% endif %}
 
-{%- comment -%} The correction-report form needs a backend with the feature on (components/correction-report.html). {%- endcomment -%}
+{%- comment -%} Posts may have the backend form or a static correction link. {%- endcomment -%}
 {% assign corrections_flag = 'false' %}
-{% if site.dynamic_services.base_url and site.dynamic_services.base_url != '' and site.dynamic_services.features.corrections != false and site.corrections.enabled != false %}
+{% if page.layout == 'post' and page.corrections != false and site.corrections.enabled != false %}
   {% assign corrections_flag = 'auto' %}
 {% endif %}
 

data/_includes/search/index-data.json

@@ -70,7 +70,9 @@
         {% endfor %}
       {% endif %}
       {% assign raw_content = doc.content | default: '' %}
-      {% assign content_text = raw_content | markdownify | strip_html | normalize_whitespace %}
+      {% assign rendered_content = raw_content | markdownify %}
+      {% assign content_text = rendered_content | strip_html | normalize_whitespace %}
+      {% assign sections = rendered_content | search_sections %}
       {% assign summary = doc.summary | default: doc.excerpt | default: content_text | truncate: 280, '' %}
       {% assign inline_math_segments = raw_content | split: '$' %}
       {% assign display_math_segments = raw_content | split: '$$' %}
@@ -89,6 +91,13 @@
         "type": {{ doc_type | strip | jsonify }},
         "summary": {{ summary | strip | jsonify }},
         "content": {{ content_text | jsonify }},
+        {%- comment -%}
+        The passages of the page, each under the heading it belongs to, so a
+        result can link to the section rather than the top of the article. The
+        text is repeated here, which costs little once the file is served
+        compressed: the duplicate compresses almost entirely away.
+        {%- endcomment %}
+        "sections": {{ sections | jsonify }},
         "code": {{ doc.search_code | default: no_code | jsonify }},
         "math": [
           {% assign math_counter = 0 %}

data/_includes/search/page.html

@@ -14,7 +14,6 @@
             spellcheck="false"
             data-search-input
             aria-describedby="search-shortcuts"
-            aria-activedescendant=""
           />
           <button type="submit" class="search-app__submit">Search</button>
         </div>
@@ -84,9 +83,9 @@
         <p aria-live="polite" data-search-live="status" hidden></p>
       </div>
     </header>
-    <ol class="search-app__results-list" data-search-results role="listbox" aria-label="Search results"></ol>
+    <ol class="search-app__results-list" data-search-results aria-label="Search results"></ol>
     <template id="search-result-template">
-      <li class="search-result" role="option" data-result-item>
+      <li class="search-result" data-result-item>
         <article class="search-result__card">
           <header class="search-result__header">
             <p class="search-result__meta">
@@ -98,16 +97,22 @@
             <p class="search-result__summary" data-result-summary></p>
           </header>
           <div class="search-result__body">
-            <pre class="search-result__code language-none line-numbers" data-result-code><code></code></pre>
+            <pre class="search-result__code language-none line-numbers" data-result-code tabindex="0"
+                 role="group" aria-label="Code sample"><code></code></pre>
             <div class="search-result__math" data-result-math hidden>
-              <div class="search-result__math-preview" data-result-math-preview aria-hidden="true"></div>
-              <pre class="search-result__math-source"><code data-result-math-code></code></pre>
+              <div class="search-result__math-preview" data-result-math-preview aria-hidden="true" inert></div>
+              <pre class="search-result__math-source" tabindex="0" role="group"
+                   aria-label="LaTeX source"><code data-result-math-code></code></pre>
               <button type="button" class="search-result__math-copy" data-result-math-copy>
                 <span aria-hidden="true">⧉</span>
                 <span class="visually-hidden">Copy LaTeX</span>
               </button>
             </div>
             <p class="search-result__excerpt" data-result-excerpt></p>
+            <div class="search-result__sections" data-result-sections hidden>
+              <p class="search-result__sections-label" data-result-sections-label></p>
+              <ul class="search-result__sections-list"></ul>
+            </div>
           </div>
           <footer class="search-result__footer">
             <ul class="search-result__tags" data-result-tags></ul>

data/_layouts/archive.html

@@ -0,0 +1,67 @@
+---
+layout: default
+article_meta: false # an archive is a list, written by no one in particular
+---
+{%- assign archive = page | archive_data -%}
+<div class="archive-section">
+  {{ content }}
+  {%- if page.archive == 'topic' %}
+    {%- if archive.series.size > 0 %}
+      <section aria-labelledby="archive-series">
+        <h2 id="archive-series">{% t 'archive.series' %}</h2>
+        <ul class="archive-list">
+          {%- for item in archive.series %}
+            <li><a href="{{ item.url | relative_url }}">{{ item.title | escape }}</a> <span class="archive-meta">{% t 'archive.parts' count: item.count %}</span></li>
+          {%- endfor %}
+        </ul>
+      </section>
+    {%- endif %}
+    {%- if archive.posts.size > 0 %}
+      <section aria-labelledby="archive-articles">
+        <h2 id="archive-articles">{% t 'archive.articles' %}</h2>
+        {% include components/post-list.html posts=archive.posts variant='teaser' %}
+        {%- if archive.remaining.size > 0 %}
+          <details><summary>{% t 'archive.show_all' count: archive.remaining.size %}</summary>
+            {% include components/post-list.html posts=archive.remaining variant='teaser' %}
+          </details>
+        {%- endif %}
+      </section>
+    {%- endif %}
+    {%- if archive.count == 0 %}<p>{% t 'archive.empty' %}</p>{%- endif %}
+  {%- else %}
+    {%- if archive.size > 0 %}
+      <nav aria-label="{% t 'archive.jump' %}">
+        <ul class="archive-list">
+          {%- for group in archive %}
+            <li><a href="#{{ group.slug }}">{{ group.name | escape }}</a> <span class="archive-meta">{% t 'archive.count' count: group.count %}</span></li>
+          {%- endfor %}
+        </ul>
+      </nav>
+      {%- for group in archive %}
+        <section aria-labelledby="{{ group.slug }}">
+          <h2 id="{{ group.slug }}">{{ group.name | escape }} <small>{% t 'archive.count' count: group.count %}</small></h2>
+          {%- if group.months %}
+            {%- for month in group.months %}
+              <section aria-labelledby="{{ month.slug }}">
+                <h3 id="{{ month.slug }}">{{ month.name | append: '-01' | localize_date: 'month' | escape }} <small>{% t 'archive.count' count: month.count %}</small></h3>
+                {% include components/post-list.html posts=month.posts variant='dated' %}
+                {%- if month.remaining.size > 0 %}
+                  <details><summary>{% t 'archive.show_all' count: month.remaining.size %}</summary>
+                    {% include components/post-list.html posts=month.remaining variant='dated' %}
+                  </details>
+                {%- endif %}
+              </section>
+            {%- endfor %}
+          {%- else %}
+            {% include components/post-list.html posts=group.posts variant='dated' %}
+            {%- if group.remaining.size > 0 %}
+              <details><summary>{% t 'archive.show_all' count: group.remaining.size %}</summary>
+                {% include components/post-list.html posts=group.remaining variant='dated' %}
+              </details>
+            {%- endif %}
+          {%- endif %}
+        </section>
+      {%- endfor %}
+    {%- else %}<p>{% t 'archive.empty' %}</p>{%- endif %}
+  {%- endif %}
+</div>

data/_layouts/dataset.html

@@ -1,6 +1,7 @@
 ---
 layout: default
 show_title: false # this layout renders the page's <h1>
+article_meta: false # the default heading adds no date or byline above this layout's own header
 ---
 {% assign localization_config = site.theme_options.localization %}
 {% assign date_format = page.date_format | default: localization_config.date_format | default: 'long' %}
@@ -47,7 +48,7 @@ show_title: false # this layout renders the page's <h1>
   {% endif %}
   {% assign citation_key = page.citation_key | default: page.slug | default: page.title | slugify %}
   {% assign citation_authors = page | page_authors %}
-  {% assign citation_date = page.date | default: page.updated %}
+  {% assign citation_date = page | published_date | default: page.updated %}
   {% assign citation_url = page.url | absolute_url %}
   {% include components/citation-tools.html title=page.title authors=citation_authors date=citation_date url=citation_url citation_key=citation_key citation_type='dataset' doi=page.doi %}
   {% include components/open-science-badges.html %}

data/_layouts/default.html

@@ -11,21 +11,23 @@
     {% include meta/schema.html page=page %}
   </head>
   {% capture body_classes %}
-    site-body{% if page.layout %} layout-{{ page.layout | replace: ' ', '-' }}{% endif %}{% if page.page_class %} page-{{ page.page_class | replace: ' ', '-' | downcase }}{% endif %}{% if page.classes %} {{ page.classes | join: ' ' }}{% endif %}{% if site.features.dark_mode_toggle %} has-dark-toggle{% endif %}{% if html_dir == 'rtl' %} rtl{% endif %}
+    site-body{% if page.layout %} layout-{{ page.layout | replace: ' ', '-' }}{% endif %}{% if page.page_class %} page-{{ page.page_class | replace: ' ', '-' | downcase }}{% endif %}{% if page.classes %} {{ page.classes | join: ' ' }}{% endif %}{% if site.features.dark_mode_toggle %} has-dark-toggle{% endif %}{% if html_dir == 'rtl' %} rtl{% endif %}{% if math_display_style == 'card' %} math-card{% endif %}
   {% endcapture %}
-  <body class="{{ body_classes | strip }}" data-theme="{{ page.theme | default: 'system' }}">
+  {% assign default_color_mode = page.theme | default: site.theme_options.color_scheme.default | default: 'dark' %}
+  <body class="{{ body_classes | strip }}{% if default_color_mode == 'dark' %} dark-mode{% endif %}" data-default-theme="{{ default_color_mode }}" data-theme="{{ default_color_mode }}">
     {%- comment -%}
-    Applies the saved or system color scheme before anything is drawn. core/dark-mode.js
-    applies the same rule, but only once the script bundles have loaded, so readers who
-    chose dark saw the light theme first; keep the two in step.
+    Applies the saved choice or site default before anything is drawn. The
+    core bundle applies the same rule when it loads; keep the two in step.
     {%- endcomment %}
     <script nonce="{{ page.csp_nonce }}">
-      try {
-        var mode = localStorage.getItem("datalog-color-mode");
-        if (mode === "dark" || (mode !== "light" && window.matchMedia("(prefers-color-scheme: dark)").matches)) {
-          document.body.classList.add("dark-mode");
-        }
-      } catch (error) {}
+      var mode;
+      try { mode = localStorage.getItem("datalog-color-mode"); } catch (error) {}
+      var siteDefault = document.body.dataset.defaultTheme;
+      var isDark = mode === "dark" || (mode !== "light" &&
+        (siteDefault === "dark" || (siteDefault === "system" && window.matchMedia("(prefers-color-scheme: dark)").matches)));
+      document.body.classList.toggle("dark-mode", isDark);
+      document.body.dataset.theme = isDark ? "dark" : "light";
+      document.documentElement.dataset.theme = document.body.dataset.theme;
     </script>
     {%- comment -%} The skip link and the footer take nothing from the page, so each is rendered once per build (the skip link once per language). {%- endcomment -%}
     {% include_cached skip-link.html lang=page.lang %}

data/_layouts/docs.html

@@ -0,0 +1,53 @@
+---
+layout: page
+---
+{% assign docs_groups = site.data.navigation.docs %}
+{% assign guide_pages = '' | split: '' %}
+{% for group in docs_groups %}
+  {% for link in group.links %}
+    {% if link.url contains '/guides/' %}
+      {% assign guide_pages = guide_pages | push: link %}
+    {% endif %}
+  {% endfor %}
+{% endfor %}
+
+<div class="docs-shell">
+  <nav class="docs-sidebar" aria-label="Documentation sections">
+    <a class="docs-sidebar__home" href="{{ '/' | relative_url }}">Documentation home</a>
+    {% for group in docs_groups %}
+      <h2 class="docs-sidebar__heading">{{ group.title | escape }}</h2>
+      <ul>
+        {% for link in group.links %}
+          <li><a href="{{ link.url | relative_url }}"{% if page.url == link.url %} aria-current="page"{% endif %}>{{ link.title | escape }}</a></li>
+        {% endfor %}
+      </ul>
+    {% endfor %}
+    <a class="docs-sidebar__repo" href="https://github.com/DiogoRibeiro7/analytics-blog-jekyll">View on GitHub</a>
+  </nav>
+
+  <div class="docs-main">
+    <div class="docs-content">{{ content }}</div>
+    <nav class="docs-pagination" aria-label="Guide navigation">
+      {% for link in guide_pages %}
+        {% if page.url == link.url %}
+          {% assign previous_index = forloop.index0 | minus: 1 %}
+          {% assign next_index = forloop.index0 | plus: 1 %}
+          {% if previous_index >= 0 %}
+            {% assign previous_guide = guide_pages[previous_index] %}
+            <a href="{{ previous_guide.url | relative_url }}"><span>Previous</span>{{ previous_guide.title | escape }}</a>
+          {% endif %}
+          {% if next_index < guide_pages.size %}
+            {% assign next_guide = guide_pages[next_index] %}
+            <a href="{{ next_guide.url | relative_url }}"><span>Next</span>{{ next_guide.title | escape }}</a>
+          {% endif %}
+        {% endif %}
+      {% endfor %}
+    </nav>
+    <a class="docs-back-to-top" href="#main-content">Back to top ↑</a>
+  </div>
+
+  {% capture page_contents %}{% include components/enhanced-toc.html html=content heading="On this page" show_progress=false %}{% endcapture %}
+  {% if page_contents contains 'enhanced-toc' %}
+    <aside class="docs-on-this-page">{{ page_contents }}</aside>
+  {% endif %}
+</div>

data/_layouts/home.html

@@ -1,8 +1,36 @@
 ---
 layout: default
+article_meta: false # the home page is the hero and its sections
 ---
 {% assign localization_config = site.theme_options.localization %}
-{% include components/hero.html %}
+{% include components/hero.html contained=true %}
+{% assign home_features = page.home_features %}
+{% if home_features and home_features.size > 0 %}
+{% capture features_default_heading %}{% t 'home.features' %}{% endcapture %}
+<section class="section home-features" aria-labelledby="home-features-heading">
+  <div class="container">
+    <h2 id="home-features-heading" class="section-title">{{ page.home_features_heading | default: features_default_heading | strip | escape }}</h2>
+    <div class="card-grid">
+      {% for feature in home_features %}
+        {% if feature.title %}
+        <article class="card home-feature-card">
+          <h3>
+            {% if feature.url %}<a href="{{ feature.url | relative_url }}">{{ feature.title | escape }}</a>
+            {% else %}{{ feature.title | escape }}{% endif %}
+          </h3>
+          {% if feature.description %}<p>{{ feature.description | escape }}</p>{% endif %}
+        </article>
+        {% endif %}
+      {% endfor %}
+    </div>
+  </div>
+</section>
+{% endif %}
+{% assign home_body = content | strip %}
+{% if home_body != '' %}
+<div class="home-body">{{ content }}</div>
+{% endif %}
+{% if site.posts and site.posts.size > 0 %}
 <section class="section section-highlight">
   <div class="container">
     <h2 class="section-title">{% t 'home.latest_research' %}</h2>
@@ -31,6 +59,7 @@ layout: default
     </div>
   </div>
 </section>
+{% endif %}
 {% comment %}
   The portfolio collection is optional: a site that has not declared it gets
   nil here, and sorting nil raises rather than rendering an empty section.