Feat: activate always_modified plugin

pelicanconf.py

@@ -41,9 +41,12 @@ PLUGIN_PATHS = ["plugins"]
 PLUGINS = [
     'i18n_subsites',
     "pelican-page-hierarchy",
+    "always_modified",
     # 'pdf-img',
 ]
 
+ALWAYS_MODIFIED = True
+
 # Mirror source structure
 PATH_METADATA = '(?P<path_no_ext>.*)\..*'
 ARTICLE_URL = ARTICLE_SAVE_AS = PAGE_URL = PAGE_SAVE_AS = '{path_no_ext}.html'

plugins/__init__.py

@@ -0,0 +1 @@
+from .always_modified import *

plugins/always_modified.py

@@ -0,0 +1,20 @@
+"""
+If "modified" date/time is not defined in article metadata, fall back to the "created" date.
+"""
+
+from pelican import signals
+from pelican.contents import Content, Article
+
+def add_modified(content):
+    if not isinstance(content, Article):
+        return
+    
+    if not content.settings.get('ALWAYS_MODIFIED', False):
+        return
+
+    if hasattr(content, 'date') and not hasattr(content, 'modified'):
+        content.modified = content.date
+        content.locale_modified = content.locale_date
+    
+def register():
+    signals.content_object_init.connect(add_modified)

plugins/always_modified/README.md

@@ -0,0 +1,14 @@
+# Always Modified
+
+Say you want to sort by modified date/time in a theme template, but not all
+your articles have modified date/timestamps explicitly defined in article
+metadata. This plugin facilitates that sorting by assuming the modified date
+(if undefined) is equal to the created date.
+
+## Usage
+
+1. Add `ALWAYS_MODIFIED = True` to your settings file.
+2. Now you can sort by modified date in your templates:
+
+    {% for article in articles|sort(reverse=True,attribute='modified') %}
+

theme/templates/index.html

@@ -2,7 +2,7 @@
 
 {% block content %}
 
-{% for article in articles_page.object_list %}
+{% for article in articles_page.object_list | sort(reverse=True,attribute='modified') %}
 <article>
   <header>
     <h2><a href="{{ SITEURL }}/{{ article.url }}{% if not DISABLE_URL_HASH %}#{{ article.slug }}{% endif %}">{{ article.title }}</a></h2>