jekyll-theme-systemhalted 0.1.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac7ded62652553410b0060512372e1684a01a9ab3f29a4ec11bd030dae6ec5b8
-  data.tar.gz: c10c055db1cf0141a51c03f71df949288a3c2318f5923d510719867bca3914ce
+  metadata.gz: a93bdbc5e0531a1c25af0c6766c7d1d61b29382c47afe4c04cc98b591fc9bb47
+  data.tar.gz: dee1e85a07ccd2c78203093ffc28aa664ac8f8274dc7b8381d1f687d0bfdd3d3
 SHA512:
-  metadata.gz: 7b2ed72ce0772f3a3d88f34d7538b405abd1f2560433a72f074cf6b5d61f0637e26bc287829ee5ad85fdeb1c7e5373180623a2928509aa9d3c5de0300c3564ed
-  data.tar.gz: 61e03be56d0ca29e36ad4ff1875c27e338eeab71abfc7bd63666bdfeeefac2ca94d152b380aed05f7cbc7d7adb09d07e8ed4a8f052a050cadb886900b3ccee2e
+  metadata.gz: b75519fa5b391002c952125a4468538f8ed6c8abd1de27b855bcd0c23e0fa65be6b603bafea4f45111b5ce9039b78b5c60a71cf9750b0fb3ba8571e1ee179367
+  data.tar.gz: bfba7332e3a1ed430c57a6a3ff2194418ea5f38d8b12afab0c178ee704fae7e42c2b7b0f5a942c01e34708cdd1581f54df001df781bc685efbb6d10d908aa3df

data/CHANGELOG.md

@@ -2,3 +2,9 @@
 
 ## 0.1.0
 - Initial release of the Systemhalted Jekyll theme gem.
+
+## 0.1.1
+- Documentation update
+
+## 1.0.0
+- Update template to include archives, index and tags as layout.

data/README.md

@@ -1,5 +1,5 @@
-# Systemhalted Theme
-[![Gem Version](https://badge.fury.io/rb/jekyll-theme-systemhalted.svg)](https://badge.fury.io/rb/jekyll-theme-systemhalted)
+# Systemhalted Theme [![Gem Version](https://badge.fury.io/rb/jekyll-theme-systemhalted.svg?icon=si%3Arubygems)](https://badge.fury.io/rb/jekyll-theme-systemhalted)
+
 A Jekyll theme for personal blogs with a bold homepage grid, archive views, tags/categories, a search overlay, theme toggle, and optional Disqus comments.
 
 ## Features
@@ -71,17 +71,53 @@ description: One-line summary for previews.
 Drafts live in `example/collections/_drafts/` for the demo site. Preview drafts with:
 `bundle exec jekyll serve --source example --destination example/_site --livereload --drafts`
 
+### Featured Images
+
+You can save your images anywhere. Just provide the correct link. For demo example, we have created an assets/images folder where demo images are currently saved. 
+
 ## Pages
 The demo site's pages live under `example/`. In your own site, create pages at your site root.
 Use `layout: page` for standard content pages or `layout: default` if you want a fully custom layout.
 
-Key pages included in the demo site (copy these into your own site if you want them):
-- `index.html`: paginated home grid.
-- `archives.html`: year-grouped archive with client-side sorting.
-- `categories.html`: category taxonomy grouped by theme.
-- `tags.html`: tag archive.
-- `featured.html`: posts with `featured: true`.
-- `about.md`, `404.md`: static pages.
+The theme provides layouts for the common archive pages, so you only need a front-matter stub (no HTML):
+```yaml
+# index.html
+---
+layout: index
+title: Home
+---
+
+# archives.md
+---
+layout: archives
+title: Archives
+---
+
+# categories.md
+---
+layout: categories
+title: Categories
+permalink: /categories/
+---
+
+# tags.md
+---
+layout: tags
+title: Tags
+---
+```
+
+Key layouts included in the theme:
+- `layout: index`: paginated home grid.
+- `layout: archives`: year-grouped archive with client-side sorting.
+- `layout: categories`: category taxonomy grouped by theme.
+- `layout: tags`: tag archive.
+- `layout: about`: standard about page (markdown content goes in the page file).
+- `layout: page`, `layout: default`: generic pages.
+
+Featured posts and error pages are still demo templates you can copy:
+- `example/featured.html`: posts with `featured: true`.
+- `example/404.md`: not found page.
 
 ## Collections
 Collections live under `example/collections/` in the demo site (see `collections_dir` in `example/_config.yml`).
@@ -119,8 +155,8 @@ sidebar:
 The sidebar also includes an "Annotate me" toggle that loads Hypothes.is on demand. Remove it from `_includes/sidebar.html` if you do not want annotation support.
 
 ## Categories and tags
-Category themes are defined in `_data/taxonomy.yml` and used on `categories.html` and in related-post logic.
-Tags are generated from post front matter and listed on `tags.html`.
+Category themes are defined in `_data/taxonomy.yml` and used on the `categories` layout and in related-post logic.
+Tags are generated from post front matter and listed on the `tags` layout.
 
 ## Comments and analytics
 Disqus comments are supported:
@@ -150,6 +186,16 @@ If deploying to GitHub Pages:
 - For `username.github.io`, set `url: https://username.github.io` and `baseurl: ""`.
 - For `username.github.io/repo`, set `url: https://username.github.io` and `baseurl: "/repo"`.
 
+
 ## Notes
 - Use relative URLs (`| relative_url`) for internal links and assets.
 - Keep filenames kebab-case and asset names short.
+
+## Screenshots
+
+!["Demo"](docs/demo.png)
+!["Dark Demo"](docs/dark_demo.png)
+!["Demo Sidebar"](docs/demo_sidebar.png)
+!["Demo Post"](docs/demo_post.png)
+!["Dark Demo Post"](docs/dark_demo_post.png)
+!["Demo Archive"](docs/demo_archives.png)

data/_layouts/about.html

@@ -0,0 +1,5 @@
+---
+layout: page
+---
+
+{{ content }}

data/_layouts/archives.html

@@ -0,0 +1,49 @@
+---
+layout: page
+---
+
+{{ content }}
+
+<h4>There are {{ site.posts | size }} published articles. </h4>
+
+<div class="archive-controls">
+  <label for="archive-sort">Sort by</label>
+  <select id="archive-sort" class="archive-sort">
+    <option value="year-desc" selected>Year (newest)</option>
+    <option value="year-asc">Year (oldest)</option>
+    <option value="count-desc">Post count (high to low)</option>
+    <option value="count-asc">Post count (low to high)</option>
+  </select>
+</div>
+
+{% assign posts_by_year = site.posts | group_by_exp: "post", "post.date | date: '%Y'" %}
+
+<div id="archive-years">
+  {% for year in posts_by_year %}
+    {% assign year_count = year.items | size %}
+    <details class="archive-year" data-year="{{ year.name }}" data-count="{{ year_count }}"{% if forloop.first %} open{% endif %}>
+      <summary id="year-{{ year.name }}" class="archive-year-summary">
+        <span class="archive-year-title">{{ year.name }}</span>
+        <span class="archive-year-count">({{ year_count }})</span>
+      </summary>
+      <ul class="archive-posts">
+        {% for post in year.items %}
+          {% assign post_summary = post.description | default: post.excerpt | strip_html | strip_newlines | truncatewords: 40 %}
+          <li class="archive-post">
+            <details class="archive-post-details">
+              <summary class="archive-post-summary">
+                <span class="archive-post-meta">
+                  <time class="post-list-date" datetime="{{ post.date | date_to_xmlschema }}" itemprop="datePublished">{{ post.date | date: "%B %d, %Y" }}</time>
+                  <a class="archive-post-title" href="{{ post.url | relative_url }}">{{ post.title }}</a>
+                </span>
+              </summary>
+              {% if post_summary and post_summary != "" %}
+                <p class="archive-post-description">{{ post_summary }}</p>
+              {% endif %}
+            </details>
+          </li>
+        {% endfor %}
+      </ul>
+    </details>
+  {% endfor %}
+</div>

data/_layouts/categories.html

@@ -0,0 +1,107 @@
+---
+layout: page
+---
+
+{{ content }}
+
+{% assign themes = site.data.taxonomy.themes %}
+
+{% for theme in themes %}
+  {%- comment -%}
+    Compute how many posts exist across all categories in this theme
+  {%- endcomment -%}
+  {% assign total_posts = 0 %}
+  {% for cat in theme.categories %}
+    {% assign posts = site.categories[cat] %}
+    {% if posts %}
+      {% assign post_count = posts | size %}
+      {% assign total_posts = total_posts | plus: post_count %}
+    {% endif %}
+  {% endfor %}
+
+  {% if total_posts > 0 %}
+    <h2 id="{{ theme.id }}">{{ theme.title }}</h2>
+
+    {% if theme.description %}
+      <p>{{ theme.description }}</p>
+    {% endif %}
+
+    {% for cat in theme.categories %}
+      {% assign posts = site.categories[cat] %}
+      {% if posts %}
+        {% assign posts = posts | sort: "date" | reverse %}
+      {% endif %}
+      {% if posts and posts.size > 0 %}
+        <details id="cat-{{ cat | slugify }}" class="archive-year">
+          <summary class="archive-year-summary">
+            <span class="archive-year-title">{{ cat }}</span>
+            <span class="archive-year-count">({{ posts.size }})</span>
+          </summary>
+          <ul class="archive-posts">
+            {% for post in posts %}
+              {% assign post_summary = post.description | default: post.excerpt | strip_html | strip_newlines | truncatewords: 40 %}
+              <li class="archive-post">
+                <details class="archive-post-details">
+                  <summary class="archive-post-summary">
+                    <span class="archive-post-meta">
+                      <time class="post-list-date" datetime="{{ post.date | date_to_xmlschema }}" itemprop="datePublished">{{ post.date | date: "%B %d, %Y" }}</time>
+                      <a class="archive-post-title" href="{{ post.url | relative_url }}">{{ post.title }}</a>
+                    </span>
+                  </summary>
+                  {% if post_summary and post_summary != "" %}
+                    <p class="archive-post-description">{{ post_summary }}</p>
+                  {% endif %}
+                </details>
+              </li>
+            {% endfor %}
+          </ul>
+        </details>
+      {% endif %}
+    {% endfor %}
+  {% endif %}
+{% endfor %}
+
+<h2>Other categories</h2>
+
+{% assign taxonomy_cats = "" | split: "," %}
+{% for theme in themes %}
+  {% assign taxonomy_cats = taxonomy_cats | concat: theme.categories %}
+{% endfor %}
+
+{% for cat in site.categories %}
+  {% assign cat_name = cat[0] %}
+  {% assign posts = cat[1] | sort: "date" | reverse %}
+  {% assign in_taxonomy = false %}
+
+  {% if taxonomy_cats contains cat_name %}
+    {% assign in_taxonomy = true %}
+  {% endif %}
+
+  {% unless in_taxonomy %}
+    <details id="cat-{{ cat_name | slugify }}" class="archive-year">
+      <summary class="archive-year-summary">
+        <span class="archive-year-title">{{ cat_name }}</span>
+        <span class="archive-year-count">({{ posts.size }})</span>
+      </summary>
+
+      <ul class="archive-posts">
+        {% for post in posts %}
+          {% assign post_summary = post.description | default: post.excerpt | strip_html | strip_newlines | truncatewords: 40 %}
+          <li class="archive-post">
+            <details class="archive-post-details">
+              <summary class="archive-post-summary">
+                <span class="archive-post-meta">
+                  <time class="post-list-date" datetime="{{ post.date | date_to_xmlschema }}" itemprop="datePublished">{{ post.date | date: "%B %d, %Y" }}</time>
+                  <a class="archive-post-title" href="{{ post.url | relative_url }}">{{ post.title }}</a>
+                </span>
+              </summary>
+              {% if post_summary and post_summary != "" %}
+                <p class="archive-post-description">{{ post_summary }}</p>
+              {% endif %}
+            </details>
+          </li>
+        {% endfor %}
+      </ul>
+    </details>
+  {% endunless %}
+{% endfor %}

data/_layouts/index.html

@@ -0,0 +1,99 @@
+---
+layout: default
+---
+
+{{ content }}
+
+<div class="post-grid">
+  {% for post in paginator.posts %}
+    {% assign summary = post.description | default: post.excerpt | strip_html | truncate: 140 %}
+    {% assign author_name = post.author | default: site.author.name  %}
+    {% assign thumb = post.featured_image %}
+    <article class="post-card">
+      <a class="card-media" href="{{ post.url | relative_url }}">
+        {% if thumb %}
+          <img src="{{ thumb | relative_url }}" alt="{{ post.featured_image_alt | default: post.title }}">
+        {% else %}
+          <div class="card-thumb-placeholder">
+            <span>{{ post.title | slice: 0, 1 | upcase }}</span>
+          </div>
+        {% endif %}
+      </a>
+      <div class="card-body">
+        <div class="card-meta">
+          <span class="card-date">{{ post.date | date: "%b %d, %Y" }}</span>
+        </div>
+        <h2 class="card-title">
+          <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
+        </h2>
+        {% if summary %}
+          <p class="card-excerpt">{{ summary }}</p>
+        {% endif %}
+        <div class="card-author">
+          <div class="author-avatar">{{ author_name | slice: 0, 1 | upcase }}</div>
+          <span class="author-name">{{ author_name }}</span>
+        </div>
+      </div>
+    </article>
+  {% endfor %}
+</div>
+
+<nav class="pager" aria-label="Pagination">
+  {% assign total_pages = paginator.total_pages %}
+  {% assign current = paginator.page %}
+  {% assign paginate_path = site.paginate_path | default: '/page:num' %}
+
+  {% assign window = 2 %}
+  {% assign start_page = current | minus: window %}
+  {% if start_page < 2 %}{% assign start_page = 2 %}{% endif %}
+  {% assign end_page = current | plus: window %}
+  {% assign last_inner = total_pages | minus: 1 %}
+  {% if end_page > last_inner %}{% assign end_page = last_inner %}{% endif %}
+
+  {% if current > 1 %}
+    <a class="page-btn" href="{{ '/' | relative_url }}">First</a>
+    <a class="page-btn" href="{{ paginator.previous_page_path | relative_url }}">‹ Back</a>
+  {% else %}
+    <span class="page-btn disabled">First</span>
+    <span class="page-btn disabled">‹ Back</span>
+  {% endif %}
+
+  {% if current == 1 %}
+    <span class="page-btn active">1</span>
+  {% else %}
+    <a class="page-btn" href="{{ '/' | relative_url }}">1</a>
+  {% endif %}
+
+  {% if start_page > 2 %}
+    <span class="page-ellipsis">…</span>
+  {% endif %}
+
+  {% for page_num in (start_page..end_page) %}
+    {% assign page_link = paginate_path | replace: ':num', page_num %}
+    {% if page_num == current %}
+      <span class="page-btn active">{{ page_num }}</span>
+    {% else %}
+      <a class="page-btn" href="{{ page_link | relative_url }}">{{ page_num }}</a>
+    {% endif %}
+  {% endfor %}
+
+  {% if end_page < last_inner %}
+    <span class="page-ellipsis">…</span>
+  {% endif %}
+
+  {% if total_pages > 1 %}
+    {% if current == total_pages %}
+      <span class="page-btn active">{{ total_pages }}</span>
+    {% else %}
+      <a class="page-btn" href="{{ paginate_path | replace: ':num', total_pages | relative_url }}">{{ total_pages }}</a>
+    {% endif %}
+  {% endif %}
+
+  {% if paginator.next_page %}
+    <a class="page-btn" href="{{ paginator.next_page_path | relative_url }}">Next ›</a>
+    <a class="page-btn" href="{{ paginate_path | replace: ':num', total_pages | relative_url }}">Last</a>
+  {% else %}
+    <span class="page-btn disabled">Next ›</span>
+    <span class="page-btn disabled">Last</span>
+  {% endif %}
+</nav>

data/_layouts/tags.html

@@ -0,0 +1,59 @@
+---
+layout: page
+---
+
+{{ content }}
+
+{% assign tags_list = site.tags %}
+
+<ul class="tag-box inline">
+  {% if tags_list.first[0] == null %}
+    {% for tag in tags_list %}
+      {% assign tag_id = tag | slugify %}
+      <li><a href="#{{ tag_id }}">{{ tag }}</a> <span>({{ site.tags[tag].size }})</span></li>
+    {% endfor %}
+  {% else %}
+    {% for tag in tags_list %}
+      {% assign tag_id = tag[0] | slugify %}
+      <li><a href="#{{ tag_id }}">{{ tag[0] }}</a> <span>({{ tag[1].size }})</span></li>
+    {% endfor %}
+  {% endif %}
+</ul>
+
+{% assign tags_list = nil %}
+
+{% for tag in site.tags %}
+  {% assign tag_name = tag[0] %}
+  {% assign tag_id = tag_name | slugify %}
+  {% assign pages_list = tag[1] %}
+  <details id="{{ tag_id }}" class="archive-year">
+    <summary class="archive-year-summary">
+      <span class="archive-year-title">{{ tag_name }}</span>
+      <span class="archive-year-count">({{ pages_list | size }})</span>
+    </summary>
+    <ul class="archive-posts">
+      {% for post in pages_list %}
+        {% if post.title != null %}
+          {% if group == null or group == post.group %}
+            {% assign post_summary = post.description | default: post.excerpt | strip_html | strip_newlines | truncatewords: 40 %}
+            <li class="archive-post">
+              <details class="archive-post-details">
+                <summary class="archive-post-summary">
+                  <span class="archive-post-meta">
+                    <time class="post-list-date" datetime="{{ post.date | date_to_xmlschema }}" itemprop="datePublished">{{ post.date | date: "%B %d, %Y" }}</time>
+                    <a class="archive-post-title" href="{{ post.url | relative_url }}">{{ post.title }}</a>
+                  </span>
+                </summary>
+                {% if post_summary and post_summary != "" %}
+                  <p class="archive-post-description">{{ post_summary }}</p>
+                {% endif %}
+              </details>
+            </li>
+          {% endif %}
+        {% endif %}
+      {% endfor %}
+    </ul>
+  </details>
+  {% assign pages_list = nil %}
+  {% assign group = nil %}
+{% endfor %}

data/lib/jekyll-theme-systemhalted/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllThemeSystemhalted
-  VERSION = "0.1.1"
+  VERSION = "1.0.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-systemhalted
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Palak Mathur
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-05 00:00:00.000000000 Z
+date: 2026-01-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -111,11 +111,16 @@ files:
 - _includes/head.html
 - _includes/share-buttons.html
 - _includes/sidebar.html
+- _layouts/about.html
+- _layouts/archives.html
+- _layouts/categories.html
 - _layouts/category.html
 - _layouts/collections.html
 - _layouts/default.html
+- _layouts/index.html
 - _layouts/page.html
 - _layouts/post.html
+- _layouts/tags.html
 - assets/android-chrome-192x192.png
 - assets/android-chrome-512x512.png
 - assets/apple-touch-icon-precomposed.png
@@ -124,12 +129,6 @@ files:
 - assets/favicon-16x16.png
 - assets/favicon-32x32.png
 - assets/favicon.ico
-- assets/images/404.jpg
-- assets/images/bg-arrow.png
-- assets/images/bgimage1.jpg
-- assets/images/bgimage2.jpg
-- assets/images/example.png
-- assets/images/example1.png
 - assets/js/elasticlunr.min.js
 - assets/js/script.js
 - assets/js/search-data.js