Merge remote-tracking branch 'origin/master'

9 files changed, 45 insertions, 2 deletions

diff --git a/www/content/essays/10-tips-for-SSR-HDA-apps.md b/www/content/essays/10-tips-for-SSR-HDA-apps.md
index 95f65ebf..fb0937d4 100644
--- a/www/content/essays/10-tips-for-SSR-HDA-apps.md
+++ b/www/content/essays/10-tips-for-SSR-HDA-apps.md
@@ -1,5 +1,9 @@
 +++
 title = "10 Tips For Building SSR/HDA applications"
+description = """\
+  In this guide, Carson Gross provides ten practical tips to help developers transition from Single Page Applications \
+  (SPAs) to Server-Side Rendering and Hypermedia-Driven Applications, focusing on essential mindset shifts and \
+  architectural advantages."""
 date = 2022-06-13
 updated = 2023-06-13
 [taxonomies]
diff --git a/www/content/essays/a-real-world-nextjs-to-htmx-port.md b/www/content/essays/a-real-world-nextjs-to-htmx-port.md
index 335a67f5..40add19d 100644
--- a/www/content/essays/a-real-world-nextjs-to-htmx-port.md
+++ b/www/content/essays/a-real-world-nextjs-to-htmx-port.md
@@ -1,5 +1,9 @@
 +++
 title = "Next.js to htmx — A Real World Example"
+description = """\
+  In this case study, Pouria Ezzati examines how migrating a URL shortener from Next.js to htmx resulted in \
+  significant improvements in codebase size, dependencies, and developer experience while challenging assumptions \
+  about modern web frameworks."""
 date = 2024-11-07
 updated = 2024-11-07
 [taxonomies]
diff --git a/www/content/essays/a-real-world-react-to-htmx-port.md b/www/content/essays/a-real-world-react-to-htmx-port.md
index b94c42ce..a68eb88e 100644
--- a/www/content/essays/a-real-world-react-to-htmx-port.md
+++ b/www/content/essays/a-real-world-react-to-htmx-port.md
@@ -1,5 +1,10 @@
 +++
 title = "A Real World React -> htmx Port"
+description = """\
+  David Guillot at Contexte gave what we are calling "The Mother of All htmx Demos" at DjangoCon 2022. This essay \
+  summarizes this real-world case study of replacing React with htmx in a SaaS product, demonstrating significant \
+  improvements in code size, performance, and development team efficiency through the adoption of a hypermedia-driven \
+  architecture."""
 date = 2022-09-29
 updated = 2022-10-15
 [taxonomies]
diff --git a/www/content/essays/a-real-world-wasm-to-htmx-port.md b/www/content/essays/a-real-world-wasm-to-htmx-port.md
index 2ce83d0a..4ec13929 100644
--- a/www/content/essays/a-real-world-wasm-to-htmx-port.md
+++ b/www/content/essays/a-real-world-wasm-to-htmx-port.md
@@ -1,5 +1,9 @@
 +++
 title = "A Real World wasm to htmx Port"
+description = """\
+  In this article, Joe Fioti describes their journey of simplifying their web application architecture by moving from \
+  a complex WebAssembly-based system to a streamlined htmx solution, resulting in significantly reduced code \
+  complexity and improved development efficiency."""
 date = 2025-01-10
 updated = 2025-01-10
 [taxonomies]
diff --git a/www/content/essays/a-response-to-rich-harris.md b/www/content/essays/a-response-to-rich-harris.md
index b3b6505a..f18795c1 100644
--- a/www/content/essays/a-response-to-rich-harris.md
+++ b/www/content/essays/a-response-to-rich-harris.md
@@ -1,5 +1,10 @@
 +++
 title = "A Response To "Have Single-Page Apps Ruined the Web?""
+description = """\
+  In this essay, Carson Gross gives an analysis of Rich Harris's talk "Have Single-Page Apps Ruined the Web?", \
+  exploring the debate between Single-Page Applications (SPAs) and Multi-Page Applications (MPAs). Carson examines \
+  Harris's criticisms of both approaches and proposes hypermedia-oriented solutions using htmx, while discussing the \
+  broader implications for web development architecture and the future role of JavaScript in web applications."""
 date = 2021-12-24
 updated = 2022-05-27
 [taxonomies]
diff --git a/www/content/essays/alternatives.md b/www/content/essays/alternatives.md
index 8f2e5d37..5bcc70a1 100644
--- a/www/content/essays/alternatives.md
+++ b/www/content/essays/alternatives.md
@@ -1,5 +1,10 @@
 +++
 title = "Alternatives to htmx"
+description = """\
+  In this article, Carson Gross compares several alternative libraries and frameworks to htmx that embrace a \
+  hypermedia-oriented approach to web development. Carson explores established solutions like Unpoly and Hotwire \
+  Turbo, as well as emerging projects like Triptych and htmz, providing developers with a comprehensive overview of \
+  hypermedia-driven application development options beyond htmx."""
 date = 2025-01-12
 updated = 2024-01-12
 [taxonomies]
diff --git a/www/content/essays/another-real-world-react-to-htmx-port.md b/www/content/essays/another-real-world-react-to-htmx-port.md
index 0646c14b..44b359a5 100644
--- a/www/content/essays/another-real-world-react-to-htmx-port.md
+++ b/www/content/essays/another-real-world-react-to-htmx-port.md
@@ -1,5 +1,9 @@
 +++
 title = "Another Real World React -> htmx Port"
+description = """\
+  In this article, Carson Gross summarizes a real-world case study of Adrian McPhee porting the OpenUnited platform \
+  from React to htmx, documenting significant reductions in code complexity and development time while highlighting \
+  how content-focused web applications can benefit from a hypermedia architectural approach."""
 date = 2023-09-20
 updated = 2023-09-20
 [taxonomies]
diff --git a/www/themes/htmx-theme/templates/base.html b/www/themes/htmx-theme/templates/base.html
index ea6b194d..7819dfed 100644
--- a/www/themes/htmx-theme/templates/base.html
+++ b/www/themes/htmx-theme/templates/base.html
@@ -3,9 +3,13 @@
 <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <meta name="description" content="htmx gives you access to AJAX, CSS Transitions, WebSockets and Server Sent Events directly in HTML, using attributes, so you can build modern user interfaces with the simplicity and power of hypertext
+    <meta name="description" content="
+    {%- block description -%}
+    htmx gives you access to AJAX, CSS Transitions, WebSockets and Server Sent Events directly in HTML, using attributes, so you can build modern user interfaces with the simplicity and power of hypertext
 
-    htmx is small (~14k min.gz’d), dependency-free, extendable, IE11 compatible & has reduced code base sizes by 67% when compared with react">
+    htmx is small (~14k min.gz’d), dependency-free, extendable, IE11 compatible & has reduced code base sizes by 67% when compared with react
+    {%- endblock description -%}
+    ">
     {# This block should set html_title appropriately -#}
     {% block title %} {% endblock title -%}
     <title>{{ html_title | default(value=config.title) | safe }}</title>
diff --git a/www/themes/htmx-theme/templates/essay.html b/www/themes/htmx-theme/templates/essay.html
index 3a72282d..ec8ec710 100644
--- a/www/themes/htmx-theme/templates/essay.html
+++ b/www/themes/htmx-theme/templates/essay.html
@@ -6,6 +6,14 @@
   {% endif -%}
 {% endblock title %}
 
+{% block description %}
+  {%- if page.description -%}
+    {{- page.description | safe -}}
+  {%- else -%}
+    {{- super() -}}
+  {%- endif -%}
+{% endblock description %}
+
 {% block content %}
 
   {% if page.extra and page.extra.show_title is defined -%}