datalog-theme 0.6.0

data/_layouts/package.html

@@ -0,0 +1,238 @@
+---
+layout: default
+---
+
+<div class="package-docs">
+  {%- comment -%} Package Header {%- endcomment -%}
+  <div class="package-docs__header">
+    <div class="package-docs__header-content">
+      <div class="package-docs__title-area">
+        <h1 class="package-docs__title">
+          {% if page.icon %}
+            <span class="package-docs__icon">{{ page.icon }}</span>
+          {% endif %}
+          {{ page.title }}
+        </h1>
+        {% if page.tagline %}
+          <p class="package-docs__tagline">{{ page.tagline }}</p>
+        {% endif %}
+      </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">
+              <circle cx="12" cy="12" r="10"></circle>
+              <polyline points="12 6 12 12 16 14"></polyline>
+            </svg>
+            <span>v{{ page.version }}</span>
+          </div>
+        {% endif %}
+
+        {% if 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">
+              <polyline points="16 18 22 12 16 6"></polyline>
+              <polyline points="8 6 2 12 8 18"></polyline>
+            </svg>
+            <span>{{ page.language }}</span>
+          </div>
+        {% endif %}
+
+        {% if page.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">
+              <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>
+          </div>
+        {% endif %}
+      </div>
+
+      <div class="package-docs__actions">
+        {% if page.github_url %}
+          <a href="{{ page.github_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="currentColor">
+              <path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/>
+            </svg>
+            <span>GitHub</span>
+          </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">
+              <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>
+          </a>
+        {% endif %}
+
+        {% 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>
+            </svg>
+            <span>CRAN</span>
+          </a>
+        {% endif %}
+      </div>
+    </div>
+  </div>
+
+  <div class="package-docs__container">
+    {%- comment -%} Sidebar Navigation {%- endcomment -%}
+    <aside class="package-docs__sidebar">
+      <nav class="package-nav" aria-label="Package navigation">
+        {% if page.nav_sections %}
+          {% for section in page.nav_sections %}
+            <div class="package-nav__section">
+              <h3 class="package-nav__section-title">{{ section.title }}</h3>
+              <ul class="package-nav__list">
+                {% for item in section.items %}
+                  <li class="package-nav__item">
+                    <a href="#{{ item.id }}" class="package-nav__link">
+                      {{ item.title }}
+                    </a>
+                  </li>
+                {% endfor %}
+              </ul>
+            </div>
+          {% endfor %}
+        {% else %}
+          {%- comment -%} Auto-generate from headings {%- endcomment -%}
+          <div class="package-nav__section">
+            <h3 class="package-nav__section-title">Contents</h3>
+            <ul class="package-nav__list">
+              <li class="package-nav__item">
+                <a href="#installation" class="package-nav__link">Installation</a>
+              </li>
+              <li class="package-nav__item">
+                <a href="#quick-start" class="package-nav__link">Quick Start</a>
+              </li>
+              <li class="package-nav__item">
+                <a href="#api-reference" class="package-nav__link">API Reference</a>
+              </li>
+              <li class="package-nav__item">
+                <a href="#examples" class="package-nav__link">Examples</a>
+              </li>
+              <li class="package-nav__item">
+                <a href="#changelog" class="package-nav__link">Changelog</a>
+              </li>
+            </ul>
+          </div>
+        {% endif %}
+
+        {%- comment -%} Version Selector {%- endcomment -%}
+        {% if page.versions %}
+          <div class="package-nav__section package-nav__section--versions">
+            <h3 class="package-nav__section-title">Versions</h3>
+            <select class="package-nav__version-select" data-navigate-on-change>
+              {% for v in page.versions %}
+                <option value="{{ v.url }}" {% if v.version == page.version %}selected{% endif %}>
+                  v{{ v.version }} {% if v.status %}({{ v.status }}){% endif %}
+                </option>
+              {% endfor %}
+            </select>
+          </div>
+        {% endif %}
+
+        {%- comment -%} Related Packages {%- endcomment -%}
+        {% if page.related_packages %}
+          <div class="package-nav__section">
+            <h3 class="package-nav__section-title">Related Packages</h3>
+            <ul class="package-nav__list">
+              {% for pkg in page.related_packages %}
+                <li class="package-nav__item">
+                  <a href="{{ pkg.url | relative_url }}" class="package-nav__link">{{ pkg.name }}</a>
+                </li>
+              {% endfor %}
+            </ul>
+          </div>
+        {% endif %}
+      </nav>
+    </aside>
+
+    {%- comment -%} Main Content {%- endcomment -%}
+    <main class="package-docs__main">
+      <article class="package-docs__content">
+        {{ content }}
+      </article>
+
+      {%- comment -%} Footer Navigation {%- endcomment -%}
+      <nav class="package-docs__footer-nav">
+        {% if page.previous_page %}
+          <a href="{{ page.previous_page.url | relative_url }}" class="package-docs__footer-nav-link package-docs__footer-nav-link--prev">
+            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+              <polyline points="15 18 9 12 15 6"></polyline>
+            </svg>
+            <div>
+              <span class="package-docs__footer-nav-label">Previous</span>
+              <span class="package-docs__footer-nav-title">{{ page.previous_page.title }}</span>
+            </div>
+          </a>
+        {% endif %}
+
+        {% if page.next_page %}
+          <a href="{{ page.next_page.url | relative_url }}" class="package-docs__footer-nav-link package-docs__footer-nav-link--next">
+            <div>
+              <span class="package-docs__footer-nav-label">Next</span>
+              <span class="package-docs__footer-nav-title">{{ page.next_page.title }}</span>
+            </div>
+            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+              <polyline points="9 18 15 12 9 6"></polyline>
+            </svg>
+          </a>
+        {% endif %}
+      </nav>
+    </main>
+  </div>
+</div>
+
+<script>
+(function() {
+  'use strict';
+
+  // Highlight active section in sidebar
+  const observer = new IntersectionObserver((entries) => {
+    entries.forEach(entry => {
+      if (entry.isIntersecting) {
+        const id = entry.target.getAttribute('id');
+        if (!id) return;
+
+        // Remove active class from all links
+        document.querySelectorAll('.package-nav__link').forEach(link => {
+          link.classList.remove('package-nav__link--active');
+        });
+
+        // Add active class to current link
+        const activeLink = document.querySelector(`.package-nav__link[href="#${id}"]`);
+        if (activeLink) {
+          activeLink.classList.add('package-nav__link--active');
+        }
+      }
+    });
+  }, {
+    rootMargin: '-80px 0px -80% 0px'
+  });
+
+  // Observe all headings
+  document.querySelectorAll('.package-docs__content h2[id], .package-docs__content h3[id]').forEach(heading => {
+    observer.observe(heading);
+  });
+
+  // Smooth scroll for anchor links
+  document.querySelectorAll('.package-nav__link[href^="#"]').forEach(link => {
+    link.addEventListener('click', (e) => {
+      e.preventDefault();
+      const target = document.querySelector(link.getAttribute('href'));
+      if (target) {
+        target.scrollIntoView({ behavior: 'smooth', block: 'start' });
+        history.pushState(null, null, link.getAttribute('href'));
+      }
+    });
+  });
+})();
+</script>

data/_layouts/page.html

@@ -0,0 +1,16 @@
+---
+layout: default
+---
+<section class="page">
+  <div class="container">
+    {% if page.hero_image %}
+    <div class="page-hero-media">
+      {% assign hero_alt = page.hero_alt | default: page.title | default: site.title %}
+      {% include components/responsive-image.html src=page.hero_image alt=hero_alt sizes="(min-width: 64rem) 40rem, 100vw" class="page-hero-image" %}
+    </div>
+    {% endif %}
+    <div class="page-content">
+      {{ content }}
+    </div>
+  </div>
+</section>

data/_layouts/portfolio.html

@@ -0,0 +1,41 @@
+---
+layout: default
+---
+<article class="portfolio-item">
+  <header class="portfolio-header">
+    <h1>{{ page.title }}</h1>
+    {% if page.hero_image %}
+    <div class="portfolio-hero-media">
+      {% assign hero_alt = page.hero_alt | default: page.title %}
+      {% include components/responsive-image.html src=page.hero_image alt=hero_alt sizes="(min-width: 64rem) 48rem, 100vw" class="portfolio-hero-image" %}
+    </div>
+    {% endif %}
+    {% if page.client %}<p class="portfolio-meta"><strong>Client:</strong> {{ page.client }}</p>{% endif %}
+    {% if page.tools %}<p class="portfolio-meta"><strong>Tools:</strong> {{ page.tools | array_to_sentence_string }}</p>{% endif %}
+    {% if page.metrics %}
+      <ul class="portfolio-metrics">
+        {% for metric in page.metrics %}
+          <li><span class="metric-label">{{ metric.label }}:</span> <span class="metric-value">{{ metric.value }}</span></li>
+        {% endfor %}
+      </ul>
+    {% endif %}
+  </header>
+  <div class="portfolio-content">
+    {{ content }}
+  </div>
+  {% if page.visualization_embed %}
+    <div class="portfolio-visualization" role="region" aria-label="Interactive visualization">
+      {{ page.visualization_embed | raw }}
+    </div>
+  {% endif %}
+  {% if page.links %}
+    <div class="portfolio-links">
+      <h2>Resources</h2>
+      <ul>
+        {% for link in page.links %}
+          <li><a href="{{ link.url | relative_url }}">{{ link.label }}</a></li>
+        {% endfor %}
+      </ul>
+    </div>
+  {% endif %}
+</article>

data/_layouts/post-sidebar.html

@@ -0,0 +1,183 @@
+---
+layout: default
+schema_type: TechnicalArticle
+---
+
+{%- comment -%}
+Sidebar layout variant for posts
+This layout provides an alternative post presentation with a sidebar containing:
+- Table of contents
+- Related posts
+- Author info
+- Quick actions
+{%- endcomment -%}
+
+{% assign localization_config = site.theme_options.localization %}
+{% assign date_format = page.date_format | default: localization_config.date_format | default: 'long' %}
+{% assign reading_minutes = page.reading_minutes | default: page.content | strip_html | reading_time %}
+{% if reading_minutes == 1 %}
+  {% capture reading_label %}{% t 'post.reading_time.one' %}{% endcapture %}
+{% else %}
+  {% capture reading_label %}{% t 'post.reading_time.many' minutes: reading_minutes %}{% endcapture %}
+{% endif %}
+{% assign reading_label = reading_label | strip %}
+
+{% capture difficulty_default %}{% t 'post.difficulty_default' %}{% endcapture %}
+{% assign difficulty = page.difficulty | default: site.post_defaults.difficulty | default: difficulty_default | strip %}
+
+{% capture toc_default_label %}{% t 'post.toc_heading' %}{% endcapture %}
+{% assign toc_heading = page.toc_label | default: toc_default_label | strip %}
+{% assign toc_min = page.toc_h_min | default: 2 %}
+{% assign toc_max = page.toc_h_max | default: 4 %}
+
+{% assign canonical_url = page.url | absolute_url %}
+{% assign author_name = page.author | default: site.author.name %}
+{% assign author_affiliation = page.author_affiliation | default: site.author.affiliation %}
+
+{% assign post_tags = page.tags %}
+{% assign has_tags = false %}
+{% if post_tags and post_tags.size > 0 %}{% assign has_tags = true %}{% endif %}
+{% assign has_categories = false %}
+{% if page.categories and page.categories.size > 0 %}{% assign has_categories = true %}{% endif %}
+
+{% assign time_required = 'PT' | append: reading_minutes | append: 'M' %}
+
+{%- comment -%} Breadcrumb navigation {%- endcomment -%}
+{% include components/breadcrumbs.html %}
+
+<div class="post-sidebar-layout">
+  {%- comment -%} Main Content Area {%- endcomment -%}
+  <main class="post-sidebar-layout__main" itemscope itemtype="https://schema.org/TechnicalArticle">
+    <meta itemprop="url" content="{{ canonical_url }}" />
+    <meta itemprop="datePublished" content="{{ page.date | date_to_xmlschema }}" />
+    {% if page.last_modified_at or page.updated %}
+      <meta itemprop="dateModified" content="{{ page.last_modified_at | default: page.updated | date_to_xmlschema }}" />
+    {% endif %}
+    <meta itemprop="author" content="{{ author_name }}" />
+    <meta itemprop="publisher" content="{{ site.author.affiliation | default: site.title }}" />
+    <meta itemprop="timeRequired" content="{{ time_required }}" />
+    {% if difficulty %}<meta itemprop="learningResourceType" content="{{ difficulty }}" />{% endif %}
+    {% if has_tags %}<meta itemprop="keywords" content="{{ post_tags | join: ', ' }}" />{% endif %}
+
+    <article class="post-sidebar-layout__article">
+      <header class="post-sidebar-layout__header">
+        <h1 class="post-sidebar-layout__title">{{ page.title }}</h1>
+
+        <div class="post-sidebar-layout__meta">
+          <time datetime="{{ page.date | date_to_xmlschema }}" itemprop="datePublished">
+            {{ page.date | localize_date: date_format }}
+          </time>
+          <span class="post-sidebar-layout__separator">•</span>
+          <span>{{ reading_label }}</span>
+          {% if difficulty %}
+            <span class="post-sidebar-layout__separator">•</span>
+            {% include components/difficulty-badge.html level=difficulty %}
+          {% endif %}
+        </div>
+
+        {% if page.excerpt %}
+          <p class="post-sidebar-layout__excerpt" itemprop="description">{{ page.excerpt }}</p>
+        {% endif %}
+
+        {% if has_tags or has_categories %}
+          <div class="post-sidebar-layout__taxonomy">
+            {% if has_tags %}
+              {% for tag in post_tags %}
+                {% assign tag_slug = tag | slugify %}
+                <a class="post-sidebar-layout__tag" href="{{ site.tag_archive.path | default: '/tags/' | append: '#' | append: tag_slug | relative_url }}">{{ tag }}</a>
+              {% endfor %}
+            {% endif %}
+          </div>
+        {% endif %}
+
+        {%- comment -%} Social sharing {%- endcomment -%}
+        {% include components/social-share.html url=canonical_url title=page.title description=page.excerpt %}
+      </header>
+
+      <div class="post-sidebar-layout__content" itemprop="articleBody">
+        {{ content }}
+      </div>
+
+      <footer class="post-sidebar-layout__footer">
+        {%- comment -%} Author bio {%- endcomment -%}
+        {% include components/author-bio.html author=author_name compact=true %}
+
+        {%- comment -%} Series navigation if applicable {%- endcomment -%}
+        {% if page.series %}
+          {% include components/series-navigation.html series=page.series %}
+        {% endif %}
+      </footer>
+    </article>
+  </main>
+
+  {%- comment -%} Sidebar {%- endcomment -%}
+  <aside class="post-sidebar-layout__sidebar" aria-label="Sidebar content">
+    {%- comment -%} Sticky sidebar container {%- endcomment -%}
+    <div class="post-sidebar-layout__sidebar-sticky">
+
+      {%- comment -%} Table of Contents {%- endcomment -%}
+      {% if page.toc != false %}
+        {% include components/enhanced-toc.html html=content h_min=toc_min h_max=toc_max heading=toc_heading %}
+      {% endif %}
+
+      {%- comment -%} Quick Info Card {%- endcomment -%}
+      <div class="sidebar-card sidebar-card--info">
+        <h3 class="sidebar-card__heading">Article Info</h3>
+        <dl class="sidebar-card__list">
+          <div class="sidebar-card__item">
+            <dt>Published</dt>
+            <dd>{{ page.date | date: "%B %d, %Y" }}</dd>
+          </div>
+          {% if page.last_modified_at %}
+          <div class="sidebar-card__item">
+            <dt>Updated</dt>
+            <dd>{{ page.last_modified_at | date: "%B %d, %Y" }}</dd>
+          </div>
+          {% endif %}
+          <div class="sidebar-card__item">
+            <dt>Reading Time</dt>
+            <dd>{{ reading_minutes }} min</dd>
+          </div>
+          {% if page.word_count %}
+          <div class="sidebar-card__item">
+            <dt>Word Count</dt>
+            <dd>{{ page.word_count | number_with_delimiter }}</dd>
+          </div>
+          {% endif %}
+        </dl>
+      </div>
+
+      {%- comment -%} Newsletter signup {%- endcomment -%}
+      {% if site.phase2_features.newsletter.enabled %}
+        {% include components/newsletter-signup.html compact=true %}
+      {% endif %}
+
+      {%- comment -%} Related posts (compact) {%- endcomment -%}
+      <div class="sidebar-card sidebar-card--related">
+        <h3 class="sidebar-card__heading">Related Articles</h3>
+        {% include post/related-posts.html page=page limit=3 compact=true %}
+      </div>
+    </div>
+  </aside>
+</div>
+
+{%- comment -%} Post navigation at bottom {%- endcomment -%}
+<nav class="post-navigation" aria-label="Post navigation">
+  {% if page.previous %}
+    <div class="post-navigation__prev">
+      <span class="post-navigation__label">← Previous</span>
+      <a href="{{ page.previous.url | relative_url }}" class="post-navigation__link">
+        {{ page.previous.title }}
+      </a>
+    </div>
+  {% endif %}
+
+  {% if page.next %}
+    <div class="post-navigation__next">
+      <span class="post-navigation__label">Next →</span>
+      <a href="{{ page.next.url | relative_url }}" class="post-navigation__link">
+        {{ page.next.title }}
+      </a>
+    </div>
+  {% endif %}
+</nav>