From be630d891e7ae2a2b4db8485825c0bfc5b8d6783 Mon Sep 17 00:00:00 2001
From: Mat Manna <91392083+matmanna@users.noreply.github.com>
Date: Fri, 21 Nov 2025 16:27:44 +0000
Subject: [PATCH] :sparkles: Add tag pages, feeds

---
 _config.yml                   |  6 ++++++
 _drafts/_pages/about.md       |  4 ++--
 _includes/toc-card.html       |  2 +-
 _layouts/tag_feed.xml         | 23 +++++++++++++++++++++++
 _layouts/tag_page.html        | 13 +++++++++++++
 _pages/about.md               |  5 +++--
 jekyll-theme-doctored.gemspec |  1 +
 7 files changed, 49 insertions(+), 5 deletions(-)
 create mode 100644 _layouts/tag_feed.xml
 create mode 100644 _layouts/tag_page.html

diff --git a/_config.yml b/_config.yml
index eec7449..019b648 100644
--- a/_config.yml
+++ b/_config.yml
@@ -12,6 +12,7 @@ plugins:
   - jekyll-feed
   - jekyll-git
   - jekyll-seo-tag
+  - jekyll/tagging
 
 feed:
   icon: /assets/images/favicon.png
@@ -19,6 +20,11 @@ feed:
 redcarpet:
   extensions: ["with_toc_data"]
 
+tag_page_layout: tag_page
+tag_page_dir: tag
+tag_feed_layout: tag_feed
+tag_feed_dir: tag
+
 collections:
   projects:
     output: true
diff --git a/_drafts/_pages/about.md b/_drafts/_pages/about.md
index 9ffda72..50b9f8b 100644
--- a/_drafts/_pages/about.md
+++ b/_drafts/_pages/about.md
@@ -39,7 +39,7 @@ Doctored is very much still a WIP. Feel free to monitor or contribute to the sta
   - [x] git metadata (footer ref)
   - [x] anchor/external link icons
   - [x] page TOC section progressrings
-  - [ ] post tags
+  - [x] post tags
   - [ ] project posts
   - [ ] i18n ui
   - [ ] post series
@@ -66,7 +66,7 @@ Doctored is very much still a WIP. Feel free to monitor or contribute to the sta
   - [x] [sitemap]({{ '/sitemap.xml' | relative_url }})
   - [x] global RSS [feed]({{ '/feed.xml' | relative_url }})
   - [x] add seo tags
-  - [ ] tag rss feeds
+  - [x] tag rss feeds
   - [ ] robots.txt
 - #### docs
   - [ ] demo/trailer video
diff --git a/_includes/toc-card.html b/_includes/toc-card.html
index d2b4743..e9c2a08 100644
--- a/_includes/toc-card.html
+++ b/_includes/toc-card.html
@@ -70,7 +70,7 @@
                     <i class="fas fa-hashtag"></i>
                     <p class="my-0 mr-1"><strong>Tags </strong></p>
                     {% for tag in page.tags %}
-                    <a href="/tags/{{ tag | downcase | replace: ' ', '-' }}/" class="no-underline">
+                    <a href="/tag/{{ tag | downcase | replace: ' ', '-' }}/" class="no-underline">
                         <div
                             class="bg-primary-500 dark:bg-primary-900  py-1 text-primary-200 dark:text-primary-400 items-center px-2 rounded-md flex flex-row gap-2 h-fit text-xs">
                             <!-- <i class="{{ tag }}"></i> -->{{ tag }}
diff --git a/_layouts/tag_feed.xml b/_layouts/tag_feed.xml
new file mode 100644
index 0000000..10bd367
--- /dev/null
+++ b/_layouts/tag_feed.xml
@@ -0,0 +1,23 @@
+---
+layout: nil
+---
+<?xml version="1.0" encoding="utf-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+    <title>Your Title - {{ page.tag }}</title>
+    <link href="http://example.com{{ page.url }}" rel="self" />
+    <link href="http://example.com/tag/{{ page.tag }}.html" />
+    <updated>{{ site.time | date_to_xmlschema }}</updated>
+    <id>http://example.com/tag/{{ page.tag }}.html</id>
+    <author>
+        <name>Author Here</name>
+    </author>
+    {% for post in page.posts %}
+    <entry>
+        <title>{{ post.title }}</title>
+        <link href="http://example.com{{ post.url }}" />
+        <updated>{{ post.date | date_to_xmlschema }}</updated>
+        <id>http://example.com{{ post.id }}</id>
+        <content type="html">{{ post.content | xml_escape }}</content>
+    </entry>
+    {% endfor %}
+</feed>
\ No newline at end of file
diff --git a/_layouts/tag_page.html b/_layouts/tag_page.html
new file mode 100644
index 0000000..e30647c
--- /dev/null
+++ b/_layouts/tag_page.html
@@ -0,0 +1,13 @@
+---
+layout: default
+---
+<h2>{{ page.tag }}</h2>
+<ul>
+    {% for post in page.posts %}
+    <li><a href="{{ post.url }}">{{ post.title }}</a> ({{ post.date | date_to_string }} | Tags: {{ post | tags }})</li>
+    {% endfor %}
+</ul>
+
+<div id="tag-cloud">
+    {{ site | tag_cloud }}
+</div>
\ No newline at end of file
diff --git a/_pages/about.md b/_pages/about.md
index 4252f9f..60aee4d 100644
--- a/_pages/about.md
+++ b/_pages/about.md
@@ -41,7 +41,7 @@ Doctored is very much still a WIP. Feel free to monitor or contribute to the sta
   - [x] git metadata (footer ref)
   - [x] anchor/external link icons
   - [x] page TOC section progressrings
-  - [ ] post tags
+  - [x] post tags
   - [ ] project posts
   - [ ] i18n ui
   - [ ] post series
@@ -67,7 +67,8 @@ Doctored is very much still a WIP. Feel free to monitor or contribute to the sta
 - #### meta
   - [x] [sitemap]({{ '/sitemap.xml' | relative_url }})
   - [x] global RSS [feed]({{ '/feed.xml' | relative_url }})
-  - [ ] tag rss feeds
+  - [x] add seo tags
+  - [x] tag rss feeds
   - [ ] robots.txt
 - #### docs
   - [ ] demo/trailer video
diff --git a/jekyll-theme-doctored.gemspec b/jekyll-theme-doctored.gemspec
index 2f146e6..dbb2565 100644
--- a/jekyll-theme-doctored.gemspec
+++ b/jekyll-theme-doctored.gemspec
@@ -15,6 +15,7 @@ Gem::Specification.new do |spec|
   spec.files = `git ls-files -z`.split("\x0").select { |f| f.match(%r!^(assets|_data|_layouts|_includes|LICENSE|404\.md|package\.json|tailwind\.config\.js)!) }
 
   spec.add_runtime_dependency "jekyll", "~> 4"
+  spec.add_runtime_dependency "jekyll-tagging"
   spec.add_dependency "webrick", "~> 1.7"
 
   spec.add_dependency "kramdown-parser-gfm"
-- 
2.51.2