feat(posts): add prioritized post summaries for home page

✨ Add concise, prioritized summaries for posts on the home page to
   avoid leaking large code blocks or overly long content in the index.
📁 Modified: index.html, README.md
📝 Document recommended front-matter usage and added a README section
   with examples and a nav entry for the new feature
💡 Behavior: prefer front-matter summary/description, then the first
   rendered paragraph (skipping headings/code), then Jekyll excerpt or
   stripped content as a fallback

Author: solrevdev

README.md

@@ -92,6 +92,39 @@ bundle exec jekyll serve --host=localhost --livereload
 ```
 
 
+## Post summaries (home page excerpts)
+
+The home page now shows a concise summary for each post without leaking large code blocks.
+
+Summary priority (no changes needed to old posts):
+
+1. If a post defines `summary:` (or `description:`) in front matter, that is used.
+2. Otherwise the first real paragraph from the post body is extracted and truncated.
+3. If no paragraph is found, it falls back to Jekyll's excerpt or stripped content.
+
+Recommended usage for new posts:
+
+```yaml
+---
+layout: post
+title: My Post
+date: 2025-08-27
+summary: A one‑sentence teaser for the home page list.
+---
+
+Intro paragraph here…
+
+<!--more-->
+
+Rest of the content…
+```
+
+Notes:
+- `summary:` gives you full control over the home-page blurb.
+- `<!--more-->` is optional; use it when you want the per‑post page to show a short intro before the rest.
+- Old posts don’t need to be edited. They’ll automatically use their first paragraph.
+
+
 
 ## SEO Improvements
 
@@ -170,6 +203,7 @@ It is a brazen two-column  theme that pairs a prominent sidebar with uncomplicat
     - [Live reload](#live-reload)
   - [Testing imgur hosted images](#testing-imgur-hosted-images)
   - [Current full site testing example:](#current-full-site-testing-example)
+  - [Post summaries (home page excerpts)](#post-summaries-home-page-excerpts)
   - [SEO Improvements](#seo-improvements)
     - [Canonical URL](#canonical-url)
     - [Robots Tag](#robots-tag)

index.html

@@ -14,7 +14,34 @@ <h1 class="post-title">
 
         <span class="post-date">{{ post.date | date_to_string }}</span>
 
-        <p>{{ post.content | strip_html | truncatewords:75}}</p>
+                {%- comment -%}
+                    Summary priority:
+                    1) front matter: summary/description
+                    2) first actual paragraph from rendered content (skips headings/code)
+                    3) fallback to excerpt or stripped content
+                {%- endcomment -%}
+
+                {% if post.summary %}
+                    <p>{{ post.summary }}</p>
+                {% elsif post.description %}
+                    <p>{{ post.description }}</p>
+                {% else %}
+                    {% assign paragraphs = post.content | split: '</p>' %}
+                    {% assign found_para = false %}
+                    {% for p in paragraphs %}
+                        {% if found_para == false and p contains '<p' %}
+                            {% assign found_para = true %}
+                            <p>{{ p | append: '</p>' | strip_html | truncatewords: 75 }}</p>
+                        {% endif %}
+                    {% endfor %}
+                    {% unless found_para %}
+                        {% if post.excerpt %}
+                            <p>{{ post.excerpt | strip_html | truncatewords: 75 }}</p>
+                        {% else %}
+                            <p>{{ post.content | strip_html | truncatewords: 75 }}</p>
+                        {% endif %}
+                    {% endunless %}
+                {% endif %}
         <p><a href="{{ site.baseurl }}{{ post.url }}">Continue Reading</a></p>