jekyll-stats 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab21769c8de5f9ff18a6ad985b0a0240dbf00c29be751b3f0aee27f8c313a257
-  data.tar.gz: '071349d927967afb2c9164d9382a56175d9aa106d818ac267d32930169aca4e7'
+  metadata.gz: 3465b65818c34b7a72b5b76d9bb242a37487837e5639927ae65c7d9a00b9ac62
+  data.tar.gz: 9e408de4fcfb55f1581a2b1905018852095cd4ae5c9a4a2f7592e252e24e42b0
 SHA512:
-  metadata.gz: c1f4bc991fa3230b0e0c3d5c0a471495738a0a853021ba257cc5501cf6748fb8ed567892b0005f5166071c3a2e2aab398380b83fbcb90a11819d2896583957ce
-  data.tar.gz: de7e7fc767997a55e345f63df9214fc46501790ff9a3f7fba3ee166968f43ce40ec1fec8ed8f4002a4c39a3c5de95ab6bc06307ecb3881fc19b191466b0fc28c
+  metadata.gz: bd03f85ad69f529b003a211a7004acdf0a30851f0a2084abab6f3f142a511a620d7c3d4f755f4dcab6abc2286c55bb5f25c7bec610ccf565e0f012e975ba21d7
+  data.tar.gz: d42e6b8897070b6529b1cc32f7e6e52c11563e2890bcfdd5c03f4a2237216cb2afb80c62d2ec94489fe6433ffb3706e954d308e31c72a1b4f67fa7a486716ab1

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-08-30
+
+- Add `internal_links` to stats: posts ranked by inbound links from other posts
+- Source posts can be excluded by tag via `jekyll-stats.link_source_exclude_tags` in `_config.yml`
+- `--json` no longer prints "Loading site..." to stdout, so output pipes cleanly to `jq`
+
 ## [0.2.0] - 2026-01-03
 
 - Add `--tags` / `-t` option to filter stats by tags

data/README.md

@@ -81,10 +81,27 @@ The `--save` flag writes `_data/stats.json` with this structure:
   "posts_by_day_of_week": { "monday": 23, "tuesday": 18, "wednesday": 15, "thursday": 20, "friday": 22, "saturday": 14, "sunday": 15 },
   "tags": [{ "name": "ruby", "count": 34 }, { "name": "opensource", "count": 28 }],
   "categories": [{ "name": "code", "count": 45 }, { "name": "cars", "count": 32 }],
+  "internal_links": [
+    { "url": "/2024/01/foo", "title": "Foo", "inbound_count": 7, "inbound_from": ["/2024/03/bar", "/2024/06/baz"] }
+  ],
   "drafts_count": 3
 }
 ```
 
+### Internal links
+
+`internal_links` lists posts ranked by how many other posts link to them. It matches markdown and `<a href>` links that point at another post's URL, either as a root-relative path or an absolute URL under your site's `url:`. Self-links and duplicate links from the same source post are ignored.
+
+To stop link-list style posts (year in review, roundups) inflating the counts, exclude them as sources by tag in `_config.yml`:
+
+```yaml
+jekyll-stats:
+  link_source_exclude_tags:
+    - roundup
+```
+
+Excluded posts still appear as targets; they just don't contribute outbound links.
+
 ## Building a Stats Page
 
 After running `jekyll stats --save`, create a stats page using Liquid:

data/lib/jekyll-stats/command.rb

@@ -25,6 +25,7 @@ module JekyllStats
       end
 
       def process(options)
+        Jekyll.logger.log_level = :error if options["json"]
         options = configuration_from_options(options)
         site = Jekyll::Site.new(options)
 

data/lib/jekyll-stats/formatter.rb

@@ -34,6 +34,11 @@ module JekyllStats
         lines << categories_line
       end
 
+      if stats[:internal_links].any?
+        lines << ""
+        lines << most_linked_posts
+      end
+
       if stats[:drafts_count].positive?
         lines << ""
         lines << "Drafts: #{stats[:drafts_count]}"
@@ -99,6 +104,15 @@ module JekyllStats
       "Categories:\n  #{cat_strs.join(" | ")}"
     end
 
+    def most_linked_posts
+      links = stats[:internal_links].first(5)
+      lines = ["Most Linked Posts:"]
+      links.each do |l|
+        lines << "  #{l[:inbound_count].to_s.rjust(2)}  #{truncate(l[:title], 50)}"
+      end
+      lines.join("\n")
+    end
+
     def format_number(n)
       n.to_s.reverse.gsub(/(\d{3})(?=\d)/, '\\1,').reverse
     end

data/lib/jekyll-stats/stats_calculator.rb

@@ -40,6 +40,7 @@ module JekyllStats
         posts_by_day_of_week: posts_by_day_of_week(posts),
         tags: tag_counts(posts),
         categories: category_counts(posts),
+        internal_links: internal_links(posts),
         drafts_count: drafts_count
       }
     end
@@ -147,6 +148,42 @@ module JekyllStats
             .map { |name, count| { name: name, count: count } }
     end
 
+    def internal_links(posts)
+      by_url = posts.each_with_object({}) { |p, h| h[normalize_url(p.url)] = p }
+      exclude = Array(site.config.dig("jekyll-stats", "link_source_exclude_tags")).map { |t| normalize_tag(t) }
+      site_url = site.config["url"].to_s
+
+      inbound = Hash.new { |h, k| h[k] = [] }
+      posts.each do |post|
+        post_tags = (post.data["tags"] || []).map { |t| normalize_tag(t) }
+        next if exclude.any? && (exclude & post_tags).any?
+
+        post.content.to_s.scan(%r{(?:\]\(|<a\s[^>]*href=["'])([^"'\s)]+)}i).flatten.each do |href|
+          href = href.delete_prefix(site_url) unless site_url.empty?
+          next unless href.start_with?("/")
+
+          target = by_url[normalize_url(href)]
+          next unless target
+          next if target == post
+
+          inbound[target] << post
+        end
+      end
+
+      inbound.map { |target, sources|
+        {
+          url: target.url,
+          title: target.data["title"] || "(untitled)",
+          inbound_count: sources.uniq.size,
+          inbound_from: sources.uniq.map(&:url).sort
+        }
+      }.sort_by { |r| [-r[:inbound_count], r[:url]] }
+    end
+
+    def normalize_url(url)
+      url.sub(/[#?].*\z/, "").sub(%r{/index\.html\z}, "").chomp(".html").chomp("/")
+    end
+
     def drafts_count
       return 0 unless site.respond_to?(:drafts) && site.drafts
 
@@ -171,6 +208,7 @@ module JekyllStats
         posts_by_day_of_week: %w[sunday monday tuesday wednesday thursday friday saturday].each_with_object({}) { |d, h| h[d] = 0 },
         tags: [],
         categories: [],
+        internal_links: [],
         drafts_count: 0
       }
     end

data/lib/jekyll-stats/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-stats
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Andrew Nesbitt
@@ -77,7 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.1
+rubygems_version: 4.0.17
 specification_version: 4
 summary: Jekyll plugin that generates site statistics
 test_files: []