From f354a89a3958ef32de9d9534d573f778a53bde96 Mon Sep 17 00:00:00 2001
From: Eli Chadwick <eli.chadwick@manchester.ac.uk>
Date: Wed, 14 Jan 2026 14:15:49 +0000
Subject: [PATCH 1/4] add blog feed template

---
 docs/_blog/feed_template.xml | 118 +++++++++++++++++++++++++++++++++++
 docs/_config.yml             |   4 --
 2 files changed, 118 insertions(+), 4 deletions(-)
 create mode 100644 docs/_blog/feed_template.xml

diff --git a/docs/_blog/feed_template.xml b/docs/_blog/feed_template.xml
new file mode 100644
index 00000000..c6eef17f
--- /dev/null
+++ b/docs/_blog/feed_template.xml
@@ -0,0 +1,118 @@
+---
+layout: none
+permalink: feed/blog.xml
+---
+<?xml version="1.0" encoding="utf-8"?>
+{% if page.xsl %}
+  <?xml-stylesheet type="text/xml" href="{{ '/feed.xslt.xml' | absolute_url }}"?>
+{% endif %}
+<feed xmlns="http://www.w3.org/2005/Atom" {% if site.lang %}xml:lang="{{ site.lang }}"{% endif %}>
+  <generator uri="https://jekyllrb.com/" version="{{ jekyll.version }}">Jekyll</generator>
+  <link href="{{ page.url | absolute_url }}" rel="self" type="application/atom+xml" />
+  <link href="{{ '/' | absolute_url }}" rel="alternate" type="text/html" {% if site.lang %}hreflang="{{ site.lang }}" {% endif %}/>
+  <updated>{{ site.time | date_to_xmlschema }}</updated>
+  <id>{{ page.url | absolute_url | xml_escape }}</id>
+
+  {% if title %}
+    <title type="html">{{ "Research Object Crate (RO-Crate) | Blog" | xml_escape }}</title>
+  {% endif %}
+
+  {% if site.description %}
+    <subtitle>{{ site.description | xml_escape }}</subtitle>
+  {% endif %}
+
+  {% if site.feed.icon %}
+    {% assign feed_icon = site.feed.icon %}
+    {% unless feed_icon contains "://" %}
+      {% assign feed_icon = feed_icon | absolute_url %}
+    {% endunless %}
+    <icon>{{ feed_icon | xml_escape }}</icon>
+  {% endif %}
+
+  {% if site.feed.logo %}
+    {% assign feed_logo = site.feed.logo %}
+    {% unless feed_logo contains "://" %}
+      {% assign feed_logo = feed_logo | absolute_url %}
+    {% endunless %}
+    <logo>{{ feed_logo | xml_escape }}</logo>
+  {% endif %}
+
+  {% if site.author %}
+    <author>
+        <name>{{ site.author.name | default: site.author | xml_escape }}</name>
+      {% if site.author.email %}
+        <email>{{ site.author.email | xml_escape }}</email>
+      {% endif %}
+      {% if site.author.uri %}
+        <uri>{{ site.author.uri | xml_escape }}</uri>
+      {% endif %}
+    </author>
+  {% endif %}
+ 
+  {% assign posts = site.blog | where_exp: "post", "post.layout == 'post'" %}
+  {% assign posts = posts | sort: "date" | reverse %}
+  {% assign posts_limit = site.feed.posts_limit | default: 10 %}
+  {% assign current_date = "now" | date: '%s' | integer %}
+  {% for post in posts limit: posts_limit %}
+    {% assign post_date = post.date | date: '%s' | integer %}
+    {% if post_date > current_date %}
+      {% continue %}
+    {% endif %}
+
+    <entry{% if post.lang %}{{" "}}xml:lang="{{ post.lang }}"{% endif %}>
+      {% assign post_title = post.title | smartify | strip_html | normalize_whitespace | xml_escape %}
+
+      <title type="html">{{ post_title }}</title>
+      <link href="{{ post.url | absolute_url }}" rel="alternate" type="text/html" title="{{ post_title }}" />
+      <published>{{ post.date | date_to_xmlschema }}</published>
+      <updated>{{ post.last_modified_at | default: post.date | date_to_xmlschema }}</updated>
+      <id>{{ post.id | absolute_url | xml_escape }}</id>
+      {% assign excerpt_only = post.feed.excerpt_only | default: site.feed.excerpt_only %}
+      {% unless excerpt_only %}
+        <content type="html" xml:base="{{ post.url | absolute_url | xml_escape }}"><![CDATA[{{ post.content | strip }}]]></content>
+      {% endunless %}
+
+      {% assign post_author = post.author | default: post.authors[0] | default: site.author %}
+      {% assign post_author = site.data.authors[post_author] | default: post_author %}
+      {% assign post_author_email = post_author.email | default: nil %}
+      {% assign post_author_uri = post_author.uri | default: nil %}
+      {% assign post_author_name = post_author.name | default: post_author %}
+
+      <author>
+          <name>{{ post_author_name | default: "" | xml_escape }}</name>
+        {% if post_author_email %}
+          <email>{{ post_author_email | xml_escape }}</email>
+        {% endif %}
+        {% if post_author_uri %}
+          <uri>{{ post_author_uri | xml_escape }}</uri>
+        {% endif %}
+      </author>
+
+      {% if post.category %}
+        <category term="{{ post.category | xml_escape }}" />
+      {% elsif post.categories %}
+        {% for category in post.categories %}
+          <category term="{{ category | xml_escape }}" />
+        {% endfor %}
+      {% endif %}
+
+      {% for tag in post.tags %}
+        <category term="{{ tag | xml_escape }}" />
+      {% endfor %}
+
+      {% assign post_summary = post.description | default: post.excerpt %}
+      {% if post_summary and post_summary != empty %}
+        <summary type="html"><![CDATA[{{ post_summary | strip_html | normalize_whitespace }}]]></summary>
+      {% endif %}
+
+      {% assign post_image = post.image.path | default: post.image %}
+      {% if post_image %}
+        {% unless post_image contains "://" %}
+          {% assign post_image = post_image | absolute_url %}
+        {% endunless %}
+        <media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="{{ post_image | xml_escape }}" />
+        <media:content medium="image" url="{{ post_image | xml_escape }}" xmlns:media="http://search.yahoo.com/mrss/" />
+      {% endif %}
+    </entry>
+  {% endfor %}
+</feed>
diff --git a/docs/_config.yml b/docs/_config.yml
index 8d938e66..35d824dd 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -115,10 +115,6 @@ theme_variables:
     twitter: false
   theme_color: 39989F
 
-feed: # RSS/Atom feed settings
-  collections:
-    - blog
-
 plugins:
   - elixir-toolkit-theme-plugins
   - jekyll-redirect-from

From 7de93ea4a70c6c65c0965888f4e548f609ade50d Mon Sep 17 00:00:00 2001
From: Eli Chadwick <eli.chadwick@manchester.ac.uk>
Date: Wed, 14 Jan 2026 14:34:03 +0000
Subject: [PATCH 2/4] add explanatory comments, work with site.future

---
 docs/_blog/feed_template.xml | 23 ++++++++++++++++-------
 docs/_config.yml             |  5 +++++
 2 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/docs/_blog/feed_template.xml b/docs/_blog/feed_template.xml
index c6eef17f..c34f0714 100644
--- a/docs/_blog/feed_template.xml
+++ b/docs/_blog/feed_template.xml
@@ -1,8 +1,15 @@
 ---
 layout: none
 permalink: feed/blog.xml
+title: "Research Object Crate (RO-Crate) | Blog"
 ---
 <?xml version="1.0" encoding="utf-8"?>
+<!--This is an Atom feed adapted from https://github.com/jekyll/jekyll-feed/blob/master/lib/jekyll-feed/feed.xml .
+Changes from that source:
+* simplified how the title is set
+* removed if/else statements that could adapt the feed according to tags and categories (we don't need this)
+* added a check that hides posts dated in the future (the jekyll-feed gem doesn't do this for non-default collections)
+-->
 {% if page.xsl %}
   <?xml-stylesheet type="text/xml" href="{{ '/feed.xslt.xml' | absolute_url }}"?>
 {% endif %}
@@ -13,8 +20,8 @@ permalink: feed/blog.xml
   <updated>{{ site.time | date_to_xmlschema }}</updated>
   <id>{{ page.url | absolute_url | xml_escape }}</id>
 
-  {% if title %}
-    <title type="html">{{ "Research Object Crate (RO-Crate) | Blog" | xml_escape }}</title>
+  {% if page.title %}
+    <title type="html">{{ page.title | xml_escape }}</title>
   {% endif %}
 
   {% if site.description %}
@@ -48,16 +55,18 @@ permalink: feed/blog.xml
       {% endif %}
     </author>
   {% endif %}
- 
+
   {% assign posts = site.blog | where_exp: "post", "post.layout == 'post'" %}
   {% assign posts = posts | sort: "date" | reverse %}
   {% assign posts_limit = site.feed.posts_limit | default: 10 %}
   {% assign current_date = "now" | date: '%s' | integer %}
   {% for post in posts limit: posts_limit %}
-    {% assign post_date = post.date | date: '%s' | integer %}
-    {% if post_date > current_date %}
-      {% continue %}
-    {% endif %}
+    {% unless site.future %}
+      {% assign post_date = post.date | date: '%s' | integer %}
+      {% if post_date > current_date %}
+        {% continue %}
+      {% endif %}
+    {% endunless %}
 
     <entry{% if post.lang %}{{" "}}xml:lang="{{ post.lang }}"{% endif %}>
       {% assign post_title = post.title | smartify | strip_html | normalize_whitespace | xml_escape %}
diff --git a/docs/_config.yml b/docs/_config.yml
index 35d824dd..7acb6996 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -107,6 +107,11 @@ collections:
     permalink: /blog/:path
     output: true
 
+feed:
+  logo: assets/img/ro-crate.svg
+  icon: assets/img/favicon.ico
+  posts_limit: 100
+
 theme_variables:
   topnav:
     theme: light

From 0657435efc829bcc088c53385e499818ed6c49d0 Mon Sep 17 00:00:00 2001
From: Eli Chadwick <eli.chadwick@manchester.ac.uk>
Date: Wed, 14 Jan 2026 14:42:18 +0000
Subject: [PATCH 3/4] add comment to config

---
 docs/_config.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/_config.yml b/docs/_config.yml
index 7acb6996..ff9ffc2e 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -107,7 +107,7 @@ collections:
     permalink: /blog/:path
     output: true
 
-feed:
+feed: # RSS/Atom feed settings, used in _blog/feed_template.xml
   logo: assets/img/ro-crate.svg
   icon: assets/img/favicon.ico
   posts_limit: 100

From f4f5bac2f98b4170c7d338170e90b366cec14257 Mon Sep 17 00:00:00 2001
From: Eli Chadwick <eli.chadwick@manchester.ac.uk>
Date: Wed, 14 Jan 2026 15:09:41 +0000
Subject: [PATCH 4/4] mention license

---
 docs/_blog/feed_template.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/_blog/feed_template.xml b/docs/_blog/feed_template.xml
index c34f0714..06087d78 100644
--- a/docs/_blog/feed_template.xml
+++ b/docs/_blog/feed_template.xml
@@ -4,7 +4,7 @@ permalink: feed/blog.xml
 title: "Research Object Crate (RO-Crate) | Blog"
 ---
 <?xml version="1.0" encoding="utf-8"?>
-<!--This is an Atom feed adapted from https://github.com/jekyll/jekyll-feed/blob/master/lib/jekyll-feed/feed.xml .
+<!--This is an Atom feed adapted from https://github.com/jekyll/jekyll-feed/blob/master/lib/jekyll-feed/feed.xml under the MIT license.
 Changes from that source:
 * simplified how the title is set
 * removed if/else statements that could adapt the feed according to tags and categories (we don't need this)