Show similar posts on articles

pelicanconf.py

@@ -112,6 +112,7 @@ def __post_init__(self):
     "pelican_embed_microblog",
     "pelican_gist",
     "pelican_redirect",
+    "pelican.plugins.similar_posts",
     "photos",
     "simple_footnotes",
     "sitemap",

pyproject.toml

@@ -43,6 +43,7 @@ dependencies = [
     "myst-parser[linkify]>=4.0.1",
     "python-frontmatter>=1.1.0",
     "ruamel-yaml>=0.19.1",
+    "pelican-similar-posts~=1.0",
 ]
 
 [tool.uv]

themes/offby1/templates/article.html.j2

@@ -123,5 +123,36 @@
             </div>
         {% endif %}
     </div>
+
+    {# Similar Posts Section #}
+    {% if article.similar_posts %}
+    <section class="related-posts-section">
+        <h3 class="recent-posts-heading">Similar Posts</h3>
+
+        <div class="recent-posts-grid">
+            {% for similar in article.similar_posts[:4] %}
+            <article class="post-card">
+                <h4><a href="{{ SITEURL }}/{{ similar.url }}">{{ similar.title }}</a></h4>
+                <div class="meta">
+                    <time datetime="{{ similar.date.isoformat() }}">{{ similar.locale_date }}</time>
+                    {% if similar.category %} · {{ similar.category }}{% endif %}
+                </div>
+                {% if similar.summary %}
+                <p class="excerpt">{{ similar.summary | striptags | truncate(150) }}</p>
+                {% else %}
+                <p class="excerpt">{{ similar.content | striptags | truncate(150) }}</p>
+                {% endif %}
+                {% if similar.tags %}
+                <div class="tags">
+                    {% for tag in similar.tags[:3] %}
+                    <a href="{{ SITEURL }}/{{ tag.url }}" class="tag">{{ tag }}</a>
+                    {% endfor %}
+                </div>
+                {% endif %}
+            </article>
+            {% endfor %}
+        </div>
+    </section>
+    {% endif %}
 </article>
 {% endblock %}