jekyll-stats 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebf4d6ad1019af942a6644fe37472e28472ccbbe2ac58f3ba6503bf134f563e0
-  data.tar.gz: e7c6050c13373f795eca54ed88573ee3c46df3a91b6994839e74e4b53dd869fd
+  metadata.gz: ab21769c8de5f9ff18a6ad985b0a0240dbf00c29be751b3f0aee27f8c313a257
+  data.tar.gz: '071349d927967afb2c9164d9382a56175d9aa106d818ac267d32930169aca4e7'
 SHA512:
-  metadata.gz: 81fbfb5befa5de983e88c396c97c45f5271e3b42bf17388ea86345e68349f71d8aff0e02f01900827c833b61264620cd15ebcb88b9beadfd01caf239a6825e67
-  data.tar.gz: e833ddc5568285c114f41f75efc29aeb497ff0cfa35388405f80b6b6418b270756f17a8a8be87fe2c5305f7695b0cceb8783a7605e5cf762d8ce0b34a0e6fe92
+  metadata.gz: c1f4bc991fa3230b0e0c3d5c0a471495738a0a853021ba257cc5501cf6748fb8ed567892b0005f5166071c3a2e2aab398380b83fbcb90a11819d2896583957ce
+  data.tar.gz: de7e7fc767997a55e345f63df9214fc46501790ff9a3f7fba3ee166968f43ce40ec1fec8ed8f4002a4c39a3c5de95ab6bc06307ecb3881fc19b191466b0fc28c

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-01-03
+
+- Add `--tags` / `-t` option to filter stats by tags
+
 ## [0.1.0] - 2025-12-21
 
 - Initial release

data/README.md

@@ -2,6 +2,8 @@
 
 A Jekyll plugin that adds a `jekyll stats` command to display site statistics.
 
+[rubygems.org/gems/jekyll-stats](https://rubygems.org/gems/jekyll-stats)
+
 ## Installation
 
 Add to your Jekyll site's Gemfile:
@@ -28,6 +30,10 @@ jekyll stats --json
 
 # Include drafts in calculations
 jekyll stats --drafts
+
+# Filter by tags (comma-separated, matches posts with ANY of the tags)
+jekyll stats --tags ruby
+jekyll stats -t ruby,rails
 ```
 
 ### Terminal Output
@@ -89,50 +95,101 @@ layout: page
 title: Site Statistics
 ---
 
-<p>
-  <strong>{{ site.data.stats.total_posts }}</strong> posts,
-  <strong>{{ site.data.stats.total_words | divided_by: 1000 }}k</strong> words,
-  <strong>{{ site.data.stats.reading_minutes | divided_by: 60 }}</strong> hours of reading.
-</p>
+<p>{{ site.data.stats.total_posts }} posts, {{ site.data.stats.total_words }} words, ~{{ site.data.stats.reading_minutes }} minutes reading time.</p>
 
-<p>
-  Writing since {{ site.data.stats.first_post.date }} ({{ site.data.stats.years_active }} years).
-  Averaging {{ site.data.stats.posts_per_month }} posts per month.
-</p>
+<p>Average {{ site.data.stats.average_words }} words per post. Longest: <a href="{{ site.data.stats.longest_post.url }}">{{ site.data.stats.longest_post.title }}</a> ({{ site.data.stats.longest_post.words }} words).</p>
+
+<p>First post: {{ site.data.stats.first_post.date }} | Last post: {{ site.data.stats.last_post.date }} | {{ site.data.stats.years_active }} years active.</p>
 
 <h2>Posts by Year</h2>
-<ul>
+<table>
+  <thead>
+    <tr>
+      <th style="text-align: left">Year</th>
+      <th style="text-align: right">Posts</th>
+    </tr>
+  </thead>
+  <tbody>
 {% for year in site.data.stats.posts_by_year %}
-  <li>{{ year.year }}: {{ year.count }} posts</li>
+    <tr>
+      <td>{{ year.year }}</td>
+      <td style="text-align: right">{{ year.count }}</td>
+    </tr>
 {% endfor %}
-</ul>
+  </tbody>
+</table>
 
 <h2>Top Tags</h2>
-<ul>
+<table>
+  <thead>
+    <tr>
+      <th style="text-align: left">Tag</th>
+      <th style="text-align: right">Posts</th>
+    </tr>
+  </thead>
+  <tbody>
 {% for tag in site.data.stats.tags limit:10 %}
-  <li>{{ tag.name }} ({{ tag.count }})</li>
+    <tr>
+      <td>{{ tag.name }}</td>
+      <td style="text-align: right">{{ tag.count }}</td>
+    </tr>
 {% endfor %}
-</ul>
-
-<h2>Extremes</h2>
-<ul>
-  <li>Longest: <a href="{{ site.data.stats.longest_post.url }}">{{ site.data.stats.longest_post.title }}</a> ({{ site.data.stats.longest_post.words }} words)</li>
-  <li>Shortest: <a href="{{ site.data.stats.shortest_post.url }}">{{ site.data.stats.shortest_post.title }}</a> ({{ site.data.stats.shortest_post.words }} words)</li>
-</ul>
-
-<h2>Day of Week</h2>
-<p>
-  I write most on
-  {% assign max_day = "" %}
-  {% assign max_count = 0 %}
-  {% for day in site.data.stats.posts_by_day_of_week %}
-    {% if day[1] > max_count %}
-      {% assign max_day = day[0] %}
-      {% assign max_count = day[1] %}
-    {% endif %}
-  {% endfor %}
-  {{ max_day | capitalize }}s ({{ max_count }} posts).
-</p>
+  </tbody>
+</table>
+
+<p><small>Generated {{ site.data.stats.generated_at | date: "%b %d, %Y" }}</small></p>
+```
+
+## Automating Stats Updates
+
+You can regenerate stats automatically before each build.
+
+### Rake Task
+
+```ruby
+# Rakefile
+task :build do
+  sh "jekyll stats --save"
+  sh "jekyll build"
+end
+```
+
+### GitHub Actions
+
+```yaml
+# .github/workflows/deploy.yml
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Generate stats
+        run: bundle exec jekyll stats --save
+
+      - name: Commit stats
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add _data/stats.json
+          git diff --staged --quiet || git commit -m "Update site stats"
+          git push
+
+      - name: Build site
+        run: bundle exec jekyll build
+```
+
+### Git Pre-commit Hook
+
+```bash
+#!/bin/sh
+# .git/hooks/pre-commit
+bundle exec jekyll stats --save
+git add _data/stats.json
 ```
 
 ## Development

data/lib/jekyll-stats/command.rb

@@ -13,6 +13,7 @@ module JekyllStats
           c.option "save", "--save", "Save stats to _data/stats.json"
           c.option "json", "--json", "Output raw JSON to stdout"
           c.option "drafts", "-D", "--drafts", "Include drafts in calculations"
+          c.option "tags", "-t", "--tags TAGS", Array, "Filter stats by tags (comma-separated)"
           c.option "config", "--config CONFIG_FILE[,CONFIG_FILE2,...]", Array, "Custom configuration file"
           c.option "source", "-s", "--source SOURCE", "Custom source directory"
           c.option "destination", "-d", "--destination DESTINATION", "Custom destination directory"
@@ -31,7 +32,7 @@ module JekyllStats
         site.reset
         site.read
 
-        calculator = StatsCalculator.new(site, include_drafts: options["drafts"])
+        calculator = StatsCalculator.new(site, include_drafts: options["drafts"], filter_tags: options["tags"])
         stats = calculator.calculate
 
         if options["json"]

data/lib/jekyll-stats/stats_calculator.rb

@@ -4,11 +4,12 @@ module JekyllStats
   class StatsCalculator
     WORDS_PER_MINUTE = 200
 
-    attr_reader :site, :include_drafts
+    attr_reader :site, :include_drafts, :filter_tags
 
-    def initialize(site, include_drafts: false)
+    def initialize(site, include_drafts: false, filter_tags: nil)
       @site = site
       @include_drafts = include_drafts
+      @filter_tags = normalize_filter_tags(filter_tags)
     end
 
     def calculate
@@ -46,9 +47,23 @@ module JekyllStats
     def collect_posts
       posts = site.posts.docs.dup
       posts += site.drafts if include_drafts && site.respond_to?(:drafts)
+      posts = filter_posts_by_tags(posts) if filter_tags
       posts
     end
 
+    def filter_posts_by_tags(posts)
+      posts.select do |post|
+        post_tags = (post.data["tags"] || []).map { |t| normalize_tag(t) }
+        (filter_tags & post_tags).any?
+      end
+    end
+
+    def normalize_filter_tags(tags)
+      return nil if tags.nil? || tags.empty?
+
+      tags.map { |t| normalize_tag(t) }
+    end
+
     def word_count(post)
       content = post.content.to_s
       text = content.gsub(/<[^>]*>/, " ")
@@ -112,17 +127,21 @@ module JekyllStats
       counts = Hash.new(0)
       posts.each do |post|
         tags = post.data["tags"] || []
-        tags.each { |tag| counts[tag] += 1 }
+        tags.each { |tag| counts[normalize_tag(tag)] += 1 }
       end
       counts.sort_by { |_, count| -count }
             .map { |name, count| { name: name, count: count } }
     end
 
+    def normalize_tag(tag)
+      tag.to_s.strip.gsub(/[,;:]+\z/, "").strip
+    end
+
     def category_counts(posts)
       counts = Hash.new(0)
       posts.each do |post|
         categories = post.data["categories"] || []
-        categories.each { |cat| counts[cat] += 1 }
+        categories.each { |cat| counts[normalize_tag(cat)] += 1 }
       end
       counts.sort_by { |_, count| -count }
             .map { |name, count| { name: name, count: count } }

data/lib/jekyll-stats/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllStats
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-stats
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Andrew Nesbitt
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Adds a 'jekyll stats' command that computes and displays site statistics
   including post counts, word counts, reading times, tag/category distributions, and
   posting frequency.