al_folio_core 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7543a0131f549b267b8523e2d30583df0755e16bd311f6aafdeb77b00449220c
+  data.tar.gz: a70250ddf07ccb430824963d7a8a768f673d9dc99fbd7f3d6c8a29a42682d020
+SHA512:
+  metadata.gz: e914feeb2a643c14985cba6378b2a966e5ea40c838bcfc73960d75b997868f2915c7df497e0db5f0454ec2431d62db511c8fbbe9dfefcac82294e039e14d46df
+  data.tar.gz: c71d63fde1b2ad9430440c70e74f09301161aff552ab547966158d95a9fde4ae146cc051df7cf1becbc7c1224e454716ebd9700ab2a7733ecae045f0c3e351fa

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 1.1.0 - 2026-02-10
+
+- Delegated CV and Distill rendering to `al_folio_cv` and `al_folio_distill`.
+- Removed CV/Distill templates and distill runtime assets from core ownership.
+- Merged `al_utils` tags/filters into core (`details`, `file_exists`, `hideCustomBibtex`, `remove_accents`).
+
+## 1.0.0 - 2026-02-08
+
+- Initial release.
+- Added v1 API contract checks and legacy content migration warnings.

data/LICENSE

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

data/README.md

@@ -0,0 +1,28 @@
+# Al-Folio Core
+
+Core runtime/theme gem for al-folio v1.x.
+
+## Responsibilities
+
+- Validate v1 config contract (`al_folio.api_version`, Tailwind and Distill runtime keys)
+- Emit migration warnings for legacy Bootstrap-marked content when compat mode is off
+- Provide shared theme layout/includes/runtime for starter sites
+- Delegate CV and Distill rendering to `al_folio_cv` and `al_folio_distill`
+- Delegate cookie consent runtime to `al_cookie`
+- Provide built-in utility tags/filters (`details`, `file_exists`, `hideCustomBibtex`, `remove_accents`)
+- Ship migration manifests consumed by `al_folio_upgrade`
+- Exclude legacy Bootstrap/MDB and plugin-owned duplicate runtime assets
+
+## Migration manifests
+
+Version manifests live under `migrations/` and are packaged with the gem.
+
+## Theme usage
+
+Use the gem as a Jekyll theme in starter sites:
+
+```yaml
+theme: al_folio_core
+plugins:
+  - al_folio_core
+```

data/_includes/audio 2.liquid

@@ -0,0 +1,30 @@
+<figure>
+  <audio
+    src="{% if include.cache_bust %}{{ include.path | relative_url | bust_file_cache }}{% else %}{{ include.path | relative_url }}{% endif %}"
+    {% if include.class %}
+      class="{{ include.class }}"
+    {% endif %}
+    {% if include.alt %}
+      alt="{{ include.alt }}"
+    {% endif %}
+    {% if include.title %}
+      title="{{ include.title }}"
+    {% endif %}
+    {% if include.autoplay %}
+      autoplay
+    {% endif %}
+    {% if include.controls %}
+      controls
+    {% endif %}
+    {% if include.loop %}
+      loop
+    {% endif %}
+    {% if include.muted %}
+      muted
+    {% endif %}
+  />
+
+  {% if include.caption %}
+    <figcaption class="caption">{{ include.caption }}</figcaption>
+  {% endif %}
+</figure>

data/_includes/audio.liquid

@@ -0,0 +1,30 @@
+<figure>
+  <audio
+    src="{% if include.cache_bust %}{{ include.path | relative_url | bust_file_cache }}{% else %}{{ include.path | relative_url }}{% endif %}"
+    {% if include.class %}
+      class="{{ include.class }}"
+    {% endif %}
+    {% if include.alt %}
+      alt="{{ include.alt }}"
+    {% endif %}
+    {% if include.title %}
+      title="{{ include.title }}"
+    {% endif %}
+    {% if include.autoplay %}
+      autoplay
+    {% endif %}
+    {% if include.controls %}
+      controls
+    {% endif %}
+    {% if include.loop %}
+      loop
+    {% endif %}
+    {% if include.muted %}
+      muted
+    {% endif %}
+  />
+
+  {% if include.caption %}
+    <figcaption class="caption">{{ include.caption }}</figcaption>
+  {% endif %}
+</figure>

data/_includes/bib_search 2.liquid

@@ -0,0 +1,4 @@
+{% if site.bib_search %}
+  <script src="{{ '/assets/js/bibsearch.js' | relative_url | bust_file_cache }}" type="module"></script>
+  <input type="text" id="bibsearch" spellcheck="false" autocomplete="off" class="search bibsearch-form-input" placeholder="Type to filter">
+{% endif %}

data/_includes/bib_search.liquid

@@ -0,0 +1,4 @@
+{% if site.bib_search %}
+  <script src="{{ '/assets/js/bibsearch.js' | relative_url | bust_file_cache }}" type="module"></script>
+  <input type="text" id="bibsearch" spellcheck="false" autocomplete="off" class="search bibsearch-form-input" placeholder="Type to filter">
+{% endif %}

data/_includes/calendar 2.liquid

@@ -0,0 +1,25 @@
+{% if include.calendar_id %}
+  <div class="post mt-4">
+    <h2 class="mb-3"><i class="fas fa-calendar-alt"></i> Upcoming Events</h2>
+
+    <button
+      class="btn btn-sm btn-outline-primary mb-3"
+      onclick="toggleCalendar()"
+      id="calendar-toggle-btn"
+    >
+      Show Calendar
+    </button>
+
+    <div class="calendar-wrapper" id="calendar-container" style="display: none;">
+      <iframe
+        id="calendar-iframe"
+        data-calendar-id="{{ include.calendar_id }}"
+        data-timezone="{{ include.timezone | default: 'UTC' }}"
+        style="{{ include.style | default: 'border:0; width:100%; height:600px;' }}"
+        frameborder="0"
+        scrolling="no"
+      >
+      </iframe>
+    </div>
+  </div>
+{% endif %}

data/_includes/calendar.liquid

@@ -0,0 +1,25 @@
+{% if include.calendar_id %}
+  <div class="post mt-4">
+    <h2 class="mb-3"><i class="fas fa-calendar-alt"></i> Upcoming Events</h2>
+
+    <button
+      class="btn btn-sm btn-outline-primary mb-3"
+      onclick="toggleCalendar()"
+      id="calendar-toggle-btn"
+    >
+      Show Calendar
+    </button>
+
+    <div class="calendar-wrapper" id="calendar-container" style="display: none;">
+      <iframe
+        id="calendar-iframe"
+        data-calendar-id="{{ include.calendar_id }}"
+        data-timezone="{{ include.timezone | default: 'UTC' }}"
+        style="{{ include.style | default: 'border:0; width:100%; height:600px;' }}"
+        frameborder="0"
+        scrolling="no"
+      >
+      </iframe>
+    </div>
+  </div>
+{% endif %}

data/_includes/citation 2.liquid

@@ -0,0 +1,26 @@
+<br>
+<hr>
+<br>
+
+If you found this useful, please cite this as:
+
+{% capture citation_quote -%}
+> {{ site.last_name }}, {{ site.first_name }}{% if site.middle_name %} {{ site.middle_name }}{% endif %} ({{ page.date | date: "%b %Y" }}). {{ page.title }}. {% if site.title != 'blank' %}{{ site.title }}. {% endif %}{{ site.url }}.
+{%- endcapture %}
+{{ citation_quote | markdownify }}
+
+<p>or as a BibTeX entry:</p>
+
+{% capture citation_code -%}
+```bibtex
+@article{ {{- site.last_name | downcase }}{{ page.date | date: "%Y" }}{{ page.title | slugify }},
+  title   = { {{- page.title -}} },
+  author  = { {{- site.last_name }}, {{ site.first_name }}{% if site.middle_name %} {{ site.middle_name }}{% endif -%}},
+  {%- if site.title != 'blank' %}journal = { {{- site.title -}} },{% endif %}
+  year    = { {{- page.date | date: "%Y" -}} },
+  month   = { {{- page.date | date: "%b" -}} },
+  url     = { {{- site.url }}{{ page.url -}} }
+}
+```
+{%- endcapture %}
+{{ citation_code | markdownify }}

data/_includes/citation.liquid

@@ -0,0 +1,26 @@
+<br>
+<hr>
+<br>
+
+If you found this useful, please cite this as:
+
+{% capture citation_quote -%}
+> {{ site.last_name }}, {{ site.first_name }}{% if site.middle_name %} {{ site.middle_name }}{% endif %} ({{ page.date | date: "%b %Y" }}). {{ page.title }}. {% if site.title != 'blank' %}{{ site.title }}. {% endif %}{{ site.url }}.
+{%- endcapture %}
+{{ citation_quote | markdownify }}
+
+<p>or as a BibTeX entry:</p>
+
+{% capture citation_code -%}
+```bibtex
+@article{ {{- site.last_name | downcase }}{{ page.date | date: "%Y" }}{{ page.title | slugify }},
+  title   = { {{- page.title -}} },
+  author  = { {{- site.last_name }}, {{ site.first_name }}{% if site.middle_name %} {{ site.middle_name }}{% endif -%}},
+  {%- if site.title != 'blank' %}journal = { {{- site.title -}} },{% endif %}
+  year    = { {{- page.date | date: "%Y" -}} },
+  month   = { {{- page.date | date: "%b" -}} },
+  url     = { {{- site.url }}{{ page.url -}} }
+}
+```
+{%- endcapture %}
+{{ citation_code | markdownify }}

data/_includes/course_schedule 2.liquid

@@ -0,0 +1,71 @@
+{% assign course = site.teachings | where: 'course_id', include.course_id | first %}
+
+{% if course %}
+  <div class="course-schedule">
+    <h2>{{ course.title }}</h2>
+
+    {% if course.description %}
+      <div class="course-description">
+        {{ course.description | markdownify }}
+      </div>
+    {% endif %}
+
+    {% if course.instructor %}
+      <p><strong>Instructor:</strong> {{ course.instructor }}</p>
+    {% endif %}
+
+    {% if course.term %}
+      <p><strong>Term:</strong> {{ course.term }}</p>
+    {% endif %}
+
+    {% if course.schedule %}
+      <table class="table table-sm table-responsive">
+        <thead>
+          <tr>
+            <th>Week</th>
+            <th>Date</th>
+            <th>Topic</th>
+            <th>Materials</th>
+          </tr>
+        </thead>
+        <tbody>
+          {% for entry in course.schedule %}
+            <tr>
+              <td>{{ entry.week }}</td>
+              <td>{{ entry.date }}</td>
+              <td>
+                {% if entry.topic %}
+                  <strong>{{ entry.topic }}</strong>
+                {% endif %}
+                {% if entry.description %}
+                  <div class="schedule-description">{{ entry.description | markdownify }}</div>
+                {% endif %}
+              </td>
+              <td>
+                {% if entry.materials %}
+                  <ul class="schedule-materials">
+                    {% for material in entry.materials %}
+                      <li>
+                        {% if material.url %}
+                          {% if material.url contains '://' %}
+                            <a href="{{ material.url }}" target="_blank">{{ material.name }}</a>
+                          {% else %}
+                            <a href="{{ material.url | relative_url }}" target="_blank">{{ material.name }}</a>
+                          {% endif %}
+                        {% else %}
+                          {{ material.name }}
+                        {% endif %}
+                      </li>
+                    {% endfor %}
+                  </ul>
+                {% endif %}
+              </td>
+            </tr>
+          {% endfor %}
+        </tbody>
+      </table>
+    {% else %}
+      <p>No schedule available for this course.</p>
+    {% endif %}
+  </div>
+{% endif %}

data/_includes/course_schedule.liquid

@@ -0,0 +1,71 @@
+{% assign course = site.teachings | where: 'course_id', include.course_id | first %}
+
+{% if course %}
+  <div class="course-schedule">
+    <h2>{{ course.title }}</h2>
+
+    {% if course.description %}
+      <div class="course-description">
+        {{ course.description | markdownify }}
+      </div>
+    {% endif %}
+
+    {% if course.instructor %}
+      <p><strong>Instructor:</strong> {{ course.instructor }}</p>
+    {% endif %}
+
+    {% if course.term %}
+      <p><strong>Term:</strong> {{ course.term }}</p>
+    {% endif %}
+
+    {% if course.schedule %}
+      <table class="table table-sm table-responsive">
+        <thead>
+          <tr>
+            <th>Week</th>
+            <th>Date</th>
+            <th>Topic</th>
+            <th>Materials</th>
+          </tr>
+        </thead>
+        <tbody>
+          {% for entry in course.schedule %}
+            <tr>
+              <td>{{ entry.week }}</td>
+              <td>{{ entry.date }}</td>
+              <td>
+                {% if entry.topic %}
+                  <strong>{{ entry.topic }}</strong>
+                {% endif %}
+                {% if entry.description %}
+                  <div class="schedule-description">{{ entry.description | markdownify }}</div>
+                {% endif %}
+              </td>
+              <td>
+                {% if entry.materials %}
+                  <ul class="schedule-materials">
+                    {% for material in entry.materials %}
+                      <li>
+                        {% if material.url %}
+                          {% if material.url contains '://' %}
+                            <a href="{{ material.url }}" target="_blank">{{ material.name }}</a>
+                          {% else %}
+                            <a href="{{ material.url | relative_url }}" target="_blank">{{ material.name }}</a>
+                          {% endif %}
+                        {% else %}
+                          {{ material.name }}
+                        {% endif %}
+                      </li>
+                    {% endfor %}
+                  </ul>
+                {% endif %}
+              </td>
+            </tr>
+          {% endfor %}
+        </tbody>
+      </table>
+    {% else %}
+      <p>No schedule available for this course.</p>
+    {% endif %}
+  </div>
+{% endif %}

data/_includes/courses 2.liquid

@@ -0,0 +1,37 @@
+{% if site.teachings %}
+  <div class="courses">
+    {% assign courses_by_year = site.teachings | sort: 'year' | reverse | group_by: 'year' %}
+
+    {% for year_group in courses_by_year %}
+      <h2 class="year">{{ year_group.name }}</h2>
+      <div class="course-list">
+        {% assign year_courses = year_group.items | sort: 'term' %}
+        {% for course in year_courses %}
+          <div class="course-item">
+            <h3 class="course-title">
+              <a href="{{ course.url | relative_url }}">{{ course.title }}</a>
+            </h3>
+
+            <div class="course-meta">
+              {% if course.term %}
+                <span class="course-term">{{ course.term }}</span>
+              {% endif %}
+
+              {% if course.instructor %}
+                <span class="course-instructor">{{ course.instructor }}</span>
+              {% endif %}
+            </div>
+
+            {% if course.description %}
+              <div class="course-description">
+                {{ course.description | markdownify }}
+              </div>
+            {% endif %}
+          </div>
+        {% endfor %}
+      </div>
+    {% endfor %}
+  </div>
+{% else %}
+  <p>No courses available yet.</p>
+{% endif %}

data/_includes/courses.liquid

@@ -0,0 +1,37 @@
+{% if site.teachings %}
+  <div class="courses">
+    {% assign courses_by_year = site.teachings | sort: 'year' | reverse | group_by: 'year' %}
+
+    {% for year_group in courses_by_year %}
+      <h2 class="year">{{ year_group.name }}</h2>
+      <div class="course-list">
+        {% assign year_courses = year_group.items | sort: 'term' %}
+        {% for course in year_courses %}
+          <div class="course-item">
+            <h3 class="course-title">
+              <a href="{{ course.url | relative_url }}">{{ course.title }}</a>
+            </h3>
+
+            <div class="course-meta">
+              {% if course.term %}
+                <span class="course-term">{{ course.term }}</span>
+              {% endif %}
+
+              {% if course.instructor %}
+                <span class="course-instructor">{{ course.instructor }}</span>
+              {% endif %}
+            </div>
+
+            {% if course.description %}
+              <div class="course-description">
+                {{ course.description | markdownify }}
+              </div>
+            {% endif %}
+          </div>
+        {% endfor %}
+      </div>
+    {% endfor %}
+  </div>
+{% else %}
+  <p>No courses available yet.</p>
+{% endif %}

data/_includes/disqus 2.liquid

@@ -0,0 +1,13 @@
+<div id="disqus_thread" style="max-width: {{ site.max_width }}; margin: 0 auto;">
+  <script type="text/javascript">
+    var disqus_shortname  = '{{ site.disqus_shortname }}';
+    var disqus_identifier = '{{ page.id }}';
+    var disqus_title      = {{ page.title | jsonify }};
+    (function() {
+    var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+    dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
+    (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+    })();
+  </script>
+  <noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+</div>

data/_includes/disqus.liquid

@@ -0,0 +1,13 @@
+<div id="disqus_thread" style="max-width: {{ site.max_width }}; margin: 0 auto;">
+  <script type="text/javascript">
+    var disqus_shortname  = '{{ site.disqus_shortname }}';
+    var disqus_identifier = '{{ page.id }}';
+    var disqus_title      = {{ page.title | jsonify }};
+    (function() {
+    var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+    dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
+    (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+    })();
+  </script>
+  <noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+</div>

data/_includes/figure 2.liquid

@@ -0,0 +1,86 @@
+{% assign img_path = include.path | remove: '.jpg' | remove: '.jpeg' | remove: '.png' | remove: '.tiff' | remove: '.gif' %}
+{% assign parts = include.path | split: '.' %}
+{% assign ext = parts.last %}
+
+<figure
+  {% if include.slot %}
+    slot="{{ include.slot }}"
+  {% endif %}
+>
+  <picture>
+    <!-- Auto scaling with imagemagick -->
+    <!--
+      See https://www.debugbear.com/blog/responsive-images#w-descriptors-and-the-sizes-attribute and
+      https://developer.mozilla.org/en-US/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images for info on defining 'sizes' for responsive images
+    -->
+    {% if site.imagemagick.enabled %}
+      {% unless include.avoid_scaling %}
+        <source
+          class="responsive-img-srcset"
+          {% if ext == 'gif' or ext == 'jpeg' or ext == 'jpg' or ext == 'png' or ext == 'tiff' %}
+            srcset="{% for i in site.imagemagick.widths %}{{ img_path | relative_url }}-{{ i }}.webp {{ i }}w,{% endfor %}"
+            type="image/webp"
+          {% else %}
+            srcset="{{ include.path | relative_url }}"
+          {% endif %}
+          {% if include.sizes %}
+            sizes="{{ include.sizes }}"
+          {% else %}
+            sizes="95vw"
+          {% endif %}
+        >
+      {% endunless %}
+    {% endif %}
+    <img
+      src="{% if include.url %}{{ include.url }}{% elsif include.cache_bust %}{{ include.path | relative_url | bust_file_cache }}{% else %}{{ include.path | relative_url }}{% endif %}"
+      {% if include.class %}
+        class="{{ include.class }}"
+      {% endif %}
+      {% if include.width %}
+        width="{{ include.width }}"
+      {% else %}
+        width="100%"
+      {% endif %}
+      {% if include.height %}
+        height="{{ include.height }}"
+      {% else %}
+        height="auto"
+      {% endif %}
+      {% if include['min-width'] or include['min-height'] or include['max-width'] or include['max-height'] %}
+        style="
+          {% if include['min-width'] %}
+            min-width: {{ include.min-width }};
+          {% endif %}
+          {% if include['min-height'] %}
+            min-height: {{ include.min-height }};
+          {% endif %}
+          {% if include['max-width'] %}
+            max-width: {{ include.max-width }};
+          {% endif %}
+          {% if include['max-height'] %}
+            max-height: {{ include.max-height }};
+          {% endif %}
+        "
+      {% endif %}
+      {% if include.alt %}
+        alt="{{ include.alt }}"
+      {% endif %}
+      {% if include.title %}
+        title="{{ include.title }}"
+      {% endif %}
+      {% if include.zoomable %}
+        data-zoomable
+      {% endif %}
+      {% if include.loading %}
+        loading="{{ include.loading }}"
+      {% elsif site.lazy_loading_images %}
+        loading="lazy"
+      {% endif %}
+      onerror="this.onerror=null; $('.responsive-img-srcset').remove();"
+    >
+  </picture>
+
+  {% if include.caption %}
+    <figcaption class="caption">{{ include.caption }}</figcaption>
+  {% endif %}
+</figure>