datalog-theme 0.10.1 → 0.11.0

data/_layouts/notebook.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
 ---
 
 {%- comment -%}
@@ -24,10 +25,13 @@ show_title: false # this layout renders the page's <h1>
     <p class="notebook-article__summary">{{ page.summary | default: page.excerpt }}</p>
 
     <ul class="notebook-article__meta">
+      {%- assign notebook_published = page | published_date %}
+      {%- if notebook_published %}
       <li>
         <span>{% t 'notebook.meta.published' %}</span>
-        <time datetime="{{ page.date | date_to_xmlschema }}" itemprop="datePublished">{{ page.date | localize_date: date_format }}</time>
+        <time datetime="{{ notebook_published | date_to_xmlschema }}" itemprop="datePublished">{{ notebook_published | localize_date: date_format }}</time>
       </li>
+      {%- endif %}
 
       {% if page.last_modified_at %}
         <li>

data/_layouts/package.html

@@ -1,8 +1,16 @@
 ---
 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
 ---
 
+{%- comment -%}
+  The latest release: from _data/package_releases.yml, which
+  `datalog packages refresh` writes from the package's registries, else from
+  the front matter. The registries' pages and docs.rs come from `registry:`.
+{%- endcomment -%}
+{%- assign release = page | package_release -%}
+{%- assign registry_links = page | package_links -%}
 <div class="package-docs">
   {%- comment -%} Package Header {%- endcomment -%}
   <div class="package-docs__header">
@@ -20,33 +28,42 @@ show_title: false # this layout renders the page's <h1>
       </div>
 
       <div class="package-docs__meta">
-        {% if page.version %}
-          <div class="package-docs__version">
-            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        {% if release.version %}
+          <div class="package-docs__version" data-package-version>
+            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
               <circle cx="12" cy="12" r="10"></circle>
               <polyline points="12 6 12 12 16 14"></polyline>
             </svg>
-            <span>v{{ page.version }}</span>
+            <span>v{{ release.version | escape }}{% if release.prerelease %} · {% t 'packages.prerelease' %}{% endif %}{% if release.yanked %} · {% t 'packages.yanked' %}{% endif %}</span>
+            {%- if release.released %}
+            <span>· <time datetime="{{ release.released | escape }}">{{ release.released | localize_date: 'long' }}</time></span>
+            {%- endif %}
           </div>
         {% endif %}
 
-        {% if page.language %}
+        {% if release.requirement or page.language %}
           <div class="package-docs__language">
-            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
               <polyline points="16 18 22 12 16 6"></polyline>
               <polyline points="8 6 2 12 8 18"></polyline>
             </svg>
-            <span>{{ page.language }}</span>
+            <span>{{ release.requirement | default: page.language | escape }}</span>
           </div>
         {% endif %}
 
-        {% if page.license %}
+        {% if release.license %}
           <div class="package-docs__license">
-            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
               <rect x="3" y="11" width="18" height="11" rx="2" ry="2"></rect>
               <path d="M7 11V7a5 5 0 0 1 10 0v4"></path>
             </svg>
-            <span>{{ page.license }}</span>
+            <span>{{ release.license | escape }}</span>
+          </div>
+        {% endif %}
+
+        {% if release.status %}
+          <div class="package-docs__status">
+            <span>{{ release.status | capitalize | escape }}</span>
           </div>
         {% endif %}
       </div>
@@ -61,22 +78,22 @@ show_title: false # this layout renders the page's <h1>
           </a>
         {% endif %}
 
-        {% if page.pypi_url %}
-          <a href="{{ page.pypi_url }}" class="package-docs__action-btn" target="_blank" rel="noopener">
-            <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        {%- comment -%} PyPI, crates.io and docs.rs, RubyGems, CRAN, conda-forge, npm, JuliaHub {%- endcomment -%}
+        {% for link in registry_links %}
+          <a href="{{ link.url | escape }}" class="package-docs__action-btn" target="_blank" rel="noopener" data-registry="{{ link.registry }}">
+            <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
               <path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"></path>
             </svg>
-            <span>PyPI</span>
+            <span>{{ link.label }}</span>
           </a>
-        {% endif %}
+        {% endfor %}
 
-        {% if page.cran_url %}
-          <a href="{{ page.cran_url }}" class="package-docs__action-btn" target="_blank" rel="noopener">
-            <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
-              <circle cx="12" cy="12" r="10"></circle>
-              <text x="12" y="16" font-size="12" text-anchor="middle" fill="currentColor">R</text>
+        {% if page.docs_url %}
+          <a href="{{ page.docs_url | escape }}" class="package-docs__action-btn" target="_blank" rel="noopener" data-registry="docs">
+            <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
+              <path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20V3H6.5A2.5 2.5 0 0 0 4 5.5z"></path>
             </svg>
-            <span>CRAN</span>
+            <span>{% t 'packages.documentation' %}</span>
           </a>
         {% endif %}
       </div>

data/_layouts/portfolio.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
 ---
 <article class="portfolio-item">
   <header class="portfolio-header">

data/_layouts/post.html

@@ -1,6 +1,7 @@
 ---
 layout: default
 schema_type: TechArticle
+article_meta: false # the default heading adds no date or byline above this layout's own header
 ---
 
 {% assign localization_config = site.theme_options.localization %}
@@ -48,6 +49,15 @@ schema_type: TechArticle
 {% assign has_categories = false %}
 {% if page.categories and page.categories.size > 0 %}{% assign has_categories = true %}{% endif %}
 
+{%- comment -%}
+  Where the author and editorial note goes: after the article by default
+  (theme_options.provenance.position: end), or before it with `start`. A page
+  chooses for itself with provenance_position in its front matter.
+{%- endcomment -%}
+{% assign provenance_position = page.provenance_position | default: site.theme_options.provenance.position | default: 'end' %}
+{% assign provenance_first = false %}
+{% if provenance_position == 'start' %}{% assign provenance_first = true %}{% endif %}
+
 {%- comment -%} ISO 8601 duration for reading time {%- endcomment -%}
 {% assign time_required = 'PT' | append: reading_minutes | append: 'M' %}
 
@@ -55,6 +65,7 @@ schema_type: TechArticle
 {% include components/breadcrumbs.html %}
 
 <div class="post-wrapper" itemscope itemtype="https://schema.org/TechArticle">
+  <meta itemprop="headline" content="{{ page.title | escape }}" />
   <meta itemprop="url" content="{{ canonical_url }}" />
   <meta itemprop="datePublished" content="{{ page.date | date_to_xmlschema }}" />
   {% if page.last_modified_at or page.updated %}
@@ -123,6 +134,8 @@ schema_type: TechArticle
           </dd>
         </div>
       {% endif %}
+      {%- comment -%} With the note after the article, the metadata says there is one, and when the article was reviewed {%- endcomment -%}
+      {% unless provenance_first %}{% include components/content-provenance.html page=page date_format=date_format pointer=true %}{% endunless %}
     </dl>
   </section>
 
@@ -157,8 +170,8 @@ schema_type: TechArticle
     </section>
   {% endif %}
 
-  {%- comment -%} Editorial provenance (why_this_exists, evidence, methodology, reviewed_at) {%- endcomment -%}
-  {% include components/content-provenance.html page=page date_format=date_format %}
+  {%- comment -%} Editorial provenance (why_this_exists, evidence, methodology, reviewed_at), here with provenance position `start` {%- endcomment -%}
+  {% if provenance_first %}{% include components/content-provenance.html page=page date_format=date_format %}{% endif %}
 
   {%- comment -%} The article's series: every part in order, and the previous and next ones {%- endcomment -%}
   {% include components/series-nav.html page=page %}
@@ -189,6 +202,9 @@ schema_type: TechArticle
   {%- comment -%} The code, data and environment behind the analysis {%- endcomment -%}
   {% include components/reproducibility.html page=page %}
 
+  {%- comment -%} How the article was made: after it, by default, as the apparatus that follows the text {%- endcomment -%}
+  {% unless provenance_first %}{% include components/content-provenance.html page=page date_format=date_format %}{% endunless %}
+
   {%- comment -%} Report an error: structured feedback to the author, on a site with a backend {%- endcomment -%}
   {% include components/correction-report.html %}
 
@@ -281,8 +297,9 @@ schema_type: TechArticle
   {% assign subscribe_placement = site.subscriptions.placement | default: 'footer' %}
   {% if subscribe_placement contains 'post' %}{% include components/subscribe-form.html where='post' %}{% endif %}
 
-  {%- comment -%} ===== Robust related posts (no where_exp, no nil sort) ===== {%- endcomment -%}
-  {% include post/related-posts.html page=page date_format=date_format %}
+  {%- unless page.related_posts == false -%}
+    {% include post/related-posts.html page=page date_format=date_format %}
+  {%- endunless -%}
 
   <nav class="post-pagination" aria-label="Post navigation">
     {% if page.previous %}
@@ -326,65 +343,7 @@ schema_type: TechArticle
 </div>
 
 <script nonce="{{ page.csp_nonce }}">
-  // Enhance code blocks with a copy button and language badge.
   document.addEventListener('DOMContentLoaded', function () {
-    const codeBlocks = document.querySelectorAll('.post-content pre > code');
-    codeBlocks.forEach(function (codeBlock) {
-      const pre = codeBlock.parentElement;
-      if (!pre || pre.querySelector('.code-copy')) return;
-
-      const wrapper = document.createElement('div');
-      wrapper.className = 'code-block-wrapper';
-      pre.parentNode.insertBefore(wrapper, pre);
-      wrapper.appendChild(pre);
-
-      const metaBar = document.createElement('div');
-      metaBar.className = 'code-block-meta';
-
-      // Rouge puts the language on the block's wrapper rather than on the code.
-      // With line numbers on, the code is a table whose first column holds the
-      // numbers, and the copy leaves them out.
-      const langHolder = codeBlock.matches('[class*="language-"]') ? codeBlock : codeBlock.closest('.highlighter-rouge');
-      const lang = langHolder && langHolder.getAttribute('class');
-      const source = codeBlock.querySelector('.rouge-code') || codeBlock;
-      if (lang) {
-        const m = lang.match(/language-([a-z0-9+#]+)/i);
-        if (m) {
-          const langBadge = document.createElement('span');
-          langBadge.className = 'code-language';
-          langBadge.textContent = m[1].toUpperCase();
-          metaBar.appendChild(langBadge);
-        }
-      }
-
-      const button = document.createElement('button');
-      button.type = 'button';
-      button.className = 'code-copy';
-      button.setAttribute('aria-label', 'Copy code to clipboard');
-      button.textContent = 'Copy';
-
-      if (navigator.clipboard && navigator.clipboard.writeText) {
-        button.addEventListener('click', function () {
-          navigator.clipboard.writeText(source.textContent).then(function () {
-            button.textContent = 'Copied!';
-            button.classList.add('is-copied');
-            setTimeout(function () {
-              button.textContent = 'Copy';
-              button.classList.remove('is-copied');
-            }, 2000);
-          }).catch(function () {
-            button.textContent = 'Error';
-          });
-        });
-      } else {
-        button.disabled = true;
-        button.title = 'Clipboard copying is not supported in this browser';
-      }
-
-      metaBar.appendChild(button);
-      wrapper.insertBefore(metaBar, pre);
-    });
-
     // Make equation references focus their targets for accessibility. This runs
     // on DOMContentLoaded, before MathJax has loaded, when window.MathJax is
     // still the configuration object and has no startup.promise; reading it

data/_layouts/project.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 = localization_config.date_format | default: 'long' %}
@@ -210,7 +211,7 @@ show_title: false # this layout renders the page's <h1>
 
   {% 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.last_updated %}
+  {% assign citation_date = page | published_date | default: page.last_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='software' doi=page.doi %}
 

data/_layouts/research.html

@@ -1,6 +1,8 @@
 ---
 layout: default
 schema_type: ScholarlyArticle
+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 date_format = site.date_format | default: '%B %-d, %Y' %}
 {% assign authors = page | page_authors %}
@@ -32,6 +34,7 @@ schema_type: ScholarlyArticle
 {% assign supplementary = page.supplementary | default: page.supplementary_materials %}
 {% assign references = page.references %}
 {% assign references_array = references | arrayify %}
+{% capture bibliography_label %}{% t 'post.bibliography.label' %}{% endcapture %}
 {% assign funding = page.funding %}
 {% assign rights = page.rights %}
 {% assign research_license = page | page_license %}
@@ -57,6 +60,9 @@ schema_type: ScholarlyArticle
 
   <header class="research-header" aria-labelledby="research-title">
     <h1 id="research-title" class="research-title">{{ page.title | escape }}</h1>
+    {%- if page.summary %}
+    <p class="article-summary">{{ page.summary | strip_html | escape }}</p>
+    {%- endif %}
 
     <div class="research-authors" aria-label="Authors">
       <h2 class="visually-hidden">Authors</h2>
@@ -73,7 +79,7 @@ schema_type: ScholarlyArticle
             {% endif %}
             {% if author_orcid %}
               <span class="research-author-orcid">
-                <a href="{{ author_orcid }}" target="_blank" rel="noopener noreferrer" itemprop="identifier" aria-label="ORCID profile for {{ author_name }}">
+                <a href="{{ author_orcid }}" target="_blank" rel="{{ author | author_profile_rel | escape }}" itemprop="identifier" aria-label="ORCID profile for {{ author_name }}">
                   ORCID
                 </a>
               </span>
@@ -302,7 +308,13 @@ schema_type: ScholarlyArticle
     </section>
   {% endif %}
 
-  {% if references_array and references_array.size > 0 %}
+  {%- comment -%} The works the article cites with {% raw %}{% cite %}{% endraw %}; a hand-written `references:` list otherwise {%- endcomment -%}
+  {% if page.datalog_bibliography and page.datalog_bibliography.size > 0 %}
+    <section class="research-references" aria-labelledby="references-heading">
+      <h2 id="references-heading">{{ page.datalog_bibliography_title | default: bibliography_label }}</h2>
+      {% datalog_bibliography %}
+    </section>
+  {% elsif references_array and references_array.size > 0 %}
     <section class="research-references" aria-labelledby="references-heading">
       <h2 id="references-heading">References</h2>
       {% assign references_markup = references_array | join: '' %}

data/_plugins/analytics_dashboard.rb

@@ -25,12 +25,15 @@ module Datalog
     module_function
 
     def fetch(site)
+      cached = nil
       cache_path = cache_path_for(site)
       cached = read_cache(cache_path)
       return cached if fresh?(cached)
 
       data = query_analytics(site)
       data["fetched_at"] = Time.now.utc.iso8601
+      return cached.merge("stale" => true) if data["status"] == "error" && cached&.fetch("status", nil) == "ok"
+
       # Only a successful report is cached. A missing-configuration or error
       # payload used to be kept for CACHE_TTL as well, so a site that had just
       # set GA4_PROPERTY_ID went on reporting the old problem for a day.
@@ -38,7 +41,7 @@ module Datalog
       data
     rescue StandardError => e
       Jekyll.logger.warn("Analytics", "Falling back to cached analytics data: #{e.message}")
-      cached || fallback_payload("error", e.message)
+      cached&.fetch("status", nil) == "ok" ? cached.merge("stale" => true) : fallback_payload("error", e.message)
     end
 
     def cache_path_for(site)

data/_plugins/archive.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Datalog
+  module Archive
+    module_function
+
+    def build(site, page)
+      mode = page["archive"].to_s
+      limit = (page["archive_limit"] || site.config["archive_limit"]).to_i
+      limit = 20 if limit <= 0
+      posts = site.posts.docs.sort_by { |post| [-post.date.to_i, post.url] }
+
+      case mode
+      when "year" then years(posts, page, limit)
+      when "tag" then terms(posts, "tags", limit)
+      when "category" then terms(posts, "categories", limit)
+      when "facet" then facet(posts, page, limit)
+      when "topic" then topic(posts, page, limit)
+      else
+        []
+      end
+    end
+
+    def years(posts, page, limit)
+      groups = grouped(posts, limit) { |post| [[post.date.year.to_s, post.date.year.to_s]] }
+      groups.sort_by! { |group| -group["name"].to_i }
+      return groups unless page["archive_months"]
+
+      groups.each do |year|
+        year_posts = posts.select { |post| post.date.year.to_s == year["name"] }
+        months = grouped(year_posts, limit) do |post|
+          [[post.date.strftime("%Y-%m"), post.date.strftime("%Y-%m")]]
+        end
+        year["months"] = months.sort_by { |month| month["name"] }.reverse
+      end
+      groups
+    end
+
+    def terms(posts, field, limit)
+      groups = grouped(posts, limit) do |post|
+        Array(post.data[field]).map { |term| [term.to_s, term.to_s] }
+      end
+      groups.sort_by { |group| group["name"].downcase }
+    end
+
+    def facet(posts, page, limit)
+      field = page["archive_field"].to_s
+      wanted = Array(page["archive_terms"]).map(&:to_s)
+      groups = grouped(posts, limit) do |post|
+        Array(post.data[field]).map { |term| [term.to_s, term.to_s] }.select do |name, _|
+          wanted.any? { |given| given.casecmp?(name) }
+        end
+      end
+      wanted.filter_map { |term| groups.find { |group| group["name"].casecmp?(term) } }
+    end
+
+    def grouped(posts, limit)
+      groups = {}
+      posts.each do |post|
+        yield(post).each do |name, label|
+          slug = Jekyll::Utils.slugify(name)
+          next if slug.empty?
+
+          group = (groups[slug] ||= { "name" => label, "slug" => slug, "posts" => [] })
+          group["posts"] << post unless group["posts"].include?(post)
+        end
+      end
+      groups.each_value do |group|
+        group["count"] = group["posts"].size
+        group["remaining"] = group["posts"].drop(limit)
+        group["posts"] = group["posts"].first(limit)
+      end
+      groups.values
+    end
+
+    def topic(posts, page, limit)
+      config = page["topic"] || {}
+      tags = Array(config["tags"]).map { |value| value.to_s.downcase }
+      categories = Array(config["categories"]).map { |value| value.to_s.downcase }
+      featured = Array(config["featured"]).map(&:to_s)
+      matches = posts.select { |post| topic_match?(post, tags, categories) }
+      series, loose = matches.partition do |post|
+        post.data["series"].is_a?(Hash) && post.data["series"]["id"]
+      end
+      series = topic_series(series, featured)
+      loose.sort_by! { |post| [featured.include?(post.url) ? 0 : 1, -post.date.to_i, post.url] }
+      { "series" => series, "posts" => loose.first(limit), "remaining" => loose.drop(limit),
+        "count" => matches.size }
+    end
+
+    def topic_match?(post, tags, categories)
+      Array(post.data["tags"]).map { |value| value.to_s.downcase }.intersect?(tags) ||
+        Array(post.data["categories"]).map { |value| value.to_s.downcase }.intersect?(categories)
+    end
+
+    def topic_series(posts, featured)
+      groups = posts.group_by { |post| post.data["series"]["id"] }
+      series = groups.map do |_id, parts|
+        data = parts.first.data["series"]
+        { "title" => data["title"], "url" => parts.first.url,
+          "count" => parts.size, "featured" => parts.any? { |post| featured.include?(post.url) } }
+      end
+      series.sort_by { |item| [item["featured"] ? 0 : 1, item["title"].to_s.downcase] }
+    end
+  end
+
+  module ArchiveFilters
+    def archive_data(page)
+      Archive.build(@context.registers[:site], page)
+    end
+  end
+end
+
+Liquid::Template.register_filter(Datalog::ArchiveFilters)

data/_plugins/authors.rb

@@ -22,6 +22,8 @@ module Datalog
     }.freeze
     PROFILE_LINKS = %w[researchgate google_scholar].freeze
     ORCID_ID = /\A\d{4}-\d{4}-\d{4}-\d{3}[\dX]\z/
+    # Profile links open in a new tab; no `profile_rel` setting removes these.
+    SAFE_REL = %w[noopener noreferrer].freeze
 
     # `authors:`, else `author:`, else the site's author.
     def authors(page, site)
@@ -94,6 +96,10 @@ module Datalog
       record["affiliation"] ||= record["institution"]
       record["bio"] ||= record["biography"]
       record["image"] ||= record["avatar"] || record["photo"]
+      # What the JSON-LD Person says about them besides the name, each a list.
+      record["alternate_names"] = list(record, "alternate_names", "alternate_name")
+      record["job_titles"] = list(record, "job_title", "roles")
+      record["knows_about"] = list(record, "knows_about", "expertise", "research_areas")
       record["orcid"] = "https://orcid.org/#{record['orcid']}" if record["orcid"].to_s.match?(ORCID_ID)
       record["site_author"] = record["name"] == site_author_profile(site)&.fetch("name")
       PROFILE_URLS.each do |key, template|
@@ -107,11 +113,44 @@ module Datalog
       record
     end
 
+    # The `rel` of a person's profile links. The site's own author gets `me`,
+    # which says the profile belongs to whoever owns the site: the relationship
+    # the JSON-LD `sameAs` states, in the form IndieAuth and Mastodon's
+    # verified links read. Anyone else gets it only when their record sets
+    # `profile_rel`, so a guest is never claimed as the site's owner. A record's
+    # `profile_rel` replaces `me`, and `author.profile_rel` in _config.yml does
+    # so for the site author; neither can drop noopener or noreferrer.
+    def profile_rel(person, site)
+      record = person.is_a?(String) ? { "name" => person } : present(person)
+      owner = site_author?(record, site)
+      configured = record["profile_rel"]
+      configured = site_author_profile(site)&.fetch("profile_rel", nil) if configured.nil? && owner
+      tokens = configured.to_s.downcase.split
+      tokens = ["me"] if configured.nil? && owner
+      (tokens + SAFE_REL).uniq.join(" ")
+    end
+
+    # A record from `page_authors` knows; a raw data record is compared by name.
+    def site_author?(record, site)
+      return record["site_author"] == true if record.key?("site_author")
+
+      name = site_author_profile(site)&.fetch("name")
+      !name.nil? && record["name"] == name
+    end
+
+    # The profiles the record names, then any other address it lists in `same_as`.
     def profiles(record)
       urls = [record["orcid"]]
       urls += PROFILE_URLS.map { |key, template| format(template, record[key]) if record[key] }
       urls += PROFILE_LINKS.map { |key| record[key] }
-      urls.compact.map(&:to_s).reject(&:empty?).uniq
+      urls += Array(record["same_as"])
+      urls.compact.map { |url| url.to_s.strip }.reject(&:empty?).uniq
+    end
+
+    # The first of `keys` the record sets, as a list of its non-blank values.
+    def list(record, *keys)
+      found = keys.map { |key| record[key] }.compact.first
+      Array(found).map { |item| item.to_s.strip }.reject(&:empty?)
     end
 
     # `author_affiliation` in front matter names the affiliation of a page's
@@ -145,6 +184,16 @@ module Datalog
     def page_contributors(page)
       Authors.contributors(page, @context["site"])
     end
+
+    def author_profile_rel(person)
+      Authors.profile_rel(person, @context["site"])
+    end
+
+    # The site's own author as one full record, whatever the input:
+    # `{% assign owner = site | site_author_record %}`.
+    def site_author_record(_input = nil)
+      Authors.site_author(@context["site"])
+    end
   end
 end
 

data/_plugins/citation_exports.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "page_dates"
+
 module Datalog
   module CitationExports
     module_function
@@ -79,7 +81,7 @@ module Datalog
       key = slugify(get.call("citation_key") || Authors.value(page, "slug") || title)
       kind = get.call("citation_type") || Authors.value(options, "type") || "article"
       record = {
-        "title" => title, "year" => (date(get.call("date"), "%Y") if get.call("date")),
+        "title" => title, "year" => citation_year(page, options),
         "publisher" => publisher, "journal" => get.call("journal") || get.call("publication"),
         "doi" => get.call("doi"), "url" => absolute_url(get.call("url") || "/"),
         "volume" => get.call("volume"), "number" => get.call("issue") || get.call("number"),
@@ -87,6 +89,15 @@ module Datalog
       }
       CitationExports.render(record, authors, kind, key)
     end
+
+    private
+
+    # The year of the date given, else of the page's own. An undated page's
+    # date is the build's, and gives no year (#411).
+    def citation_year(page, options)
+      published = Authors.value(options, "date") || PageDates.published(page, @context.registers[:site]&.time)
+      date(published, "%Y") if published
+    end
   end
 end