From 5e00af78b7def75437af91bb2b5f8d56a68b3bc9 Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.org>
Date: Fri, 12 Dec 2025 12:56:08 -0500
Subject: [PATCH] Add SEO schema improvements (BreadcrumbList, Book schema)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add BreadcrumbList JSON-LD schema to verse, chapter, book, topic,
  study guide, and story detail pages for rich SERP breadcrumbs
- Add Book schema to book pages with chapter count and authorship
- Add Article schema to topic detail pages
- All key content pages now have proper structured data for search
  engines to understand site hierarchy

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 kjvstudy_org/templates/book.html              | 52 +++++++++++++++++++
 kjvstudy_org/templates/chapter.html           | 34 ++++++++++++
 kjvstudy_org/templates/story_detail.html      | 25 +++++++++
 .../templates/study_guide_detail.html         | 25 +++++++++
 kjvstudy_org/templates/topic_detail.html      | 49 +++++++++++++++++
 kjvstudy_org/templates/verse.html             | 37 +++++++++++++
 6 files changed, 222 insertions(+)

diff --git a/kjvstudy_org/templates/book.html b/kjvstudy_org/templates/book.html
index c56b07e..07ce5f7 100644
--- a/kjvstudy_org/templates/book.html
+++ b/kjvstudy_org/templates/book.html
@@ -4,6 +4,58 @@
 
 {% block description %}Study the book of {{ book }} from the King James Bible (KJV). {% if book_intro and book_intro.introduction %}{{ book_intro.introduction[:110]|striptags }}...{% elif introduction %}{{ introduction[:110]|striptags }}...{% else %}Complete KJV text with chapters, commentary, and study resources.{% endif %}{% endblock %}
 
+{% block structured_data %}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Book",
+  "name": {{ book | tojson }},
+  "url": "https://kjvstudy.org/book/{{ book | urlencode }}",
+  "inLanguage": "en",
+  "author": {
+    "@type": "Organization",
+    "name": "Authorized Version Translators"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "KJV Study",
+    "url": "https://kjvstudy.org"
+  },
+  "isPartOf": {
+    "@type": "Book",
+    "name": "King James Version Bible",
+    "url": "https://kjvstudy.org/books"
+  },
+  "numberOfPages": {{ chapters|length }}
+}
+</script>
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "https://kjvstudy.org"
+    },
+    {
+      "@type": "ListItem",
+      "position": 2,
+      "name": "Books",
+      "item": "https://kjvstudy.org/books"
+    },
+    {
+      "@type": "ListItem",
+      "position": 3,
+      "name": {{ book | tojson }}
+    }
+  ]
+}
+</script>
+{% endblock %}
+
 {% block head %}
 <style>
 /* Chapter grid layout */
diff --git a/kjvstudy_org/templates/chapter.html b/kjvstudy_org/templates/chapter.html
index 85570f9..bd19460 100644
--- a/kjvstudy_org/templates/chapter.html
+++ b/kjvstudy_org/templates/chapter.html
@@ -4,6 +4,40 @@
 
 {% block description %}Read {{ book }} chapter {{ chapter }} from the King James Version Bible. {{ verses[0].text[:100] if verses and verses|length > 0 else '' }}...{% endblock %}
 
+{% block structured_data %}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "https://kjvstudy.org"
+    },
+    {
+      "@type": "ListItem",
+      "position": 2,
+      "name": "Books",
+      "item": "https://kjvstudy.org/books"
+    },
+    {
+      "@type": "ListItem",
+      "position": 3,
+      "name": {{ book | tojson }},
+      "item": "https://kjvstudy.org/book/{{ book | urlencode }}"
+    },
+    {
+      "@type": "ListItem",
+      "position": 4,
+      "name": "Chapter {{ chapter }}"
+    }
+  ]
+}
+</script>
+{% endblock %}
+
 {% block head %}
 <style>
 /* Anchor offset for sticky breadcrumb */
diff --git a/kjvstudy_org/templates/story_detail.html b/kjvstudy_org/templates/story_detail.html
index ef31eb5..91af532 100644
--- a/kjvstudy_org/templates/story_detail.html
+++ b/kjvstudy_org/templates/story_detail.html
@@ -33,6 +33,31 @@
   }
 }
 </script>
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "https://kjvstudy.org"
+    },
+    {
+      "@type": "ListItem",
+      "position": 2,
+      "name": "Bible Stories",
+      "item": "https://kjvstudy.org/stories"
+    },
+    {
+      "@type": "ListItem",
+      "position": 3,
+      "name": {{ story.title | tojson }}
+    }
+  ]
+}
+</script>
 {% endblock %}
 
 {% block head %}
diff --git a/kjvstudy_org/templates/study_guide_detail.html b/kjvstudy_org/templates/study_guide_detail.html
index 63c94b6..4a6cf15 100644
--- a/kjvstudy_org/templates/study_guide_detail.html
+++ b/kjvstudy_org/templates/study_guide_detail.html
@@ -34,6 +34,31 @@
   }
 }
 </script>
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "https://kjvstudy.org"
+    },
+    {
+      "@type": "ListItem",
+      "position": 2,
+      "name": "Study Guides",
+      "item": "https://kjvstudy.org/study-guides"
+    },
+    {
+      "@type": "ListItem",
+      "position": 3,
+      "name": {{ guide.title | tojson }}
+    }
+  ]
+}
+</script>
 {% endblock %}
 
 {% block head %}
diff --git a/kjvstudy_org/templates/topic_detail.html b/kjvstudy_org/templates/topic_detail.html
index 2fd29cb..45e12bd 100644
--- a/kjvstudy_org/templates/topic_detail.html
+++ b/kjvstudy_org/templates/topic_detail.html
@@ -3,6 +3,55 @@
 {% block title %}{{ topic_name }} - Topical Index - KJV Study{% endblock %}
 {% block description %}{{ topic.description }}{% endblock %}
 
+{% block structured_data %}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": {{ topic_name | tojson }},
+  "description": {{ topic.description | tojson }},
+  "author": {
+    "@type": "Organization",
+    "name": "KJV Study"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "KJV Study",
+    "url": "https://kjvstudy.org"
+  },
+  "mainEntityOfPage": {
+    "@type": "WebPage",
+    "@id": "https://kjvstudy.org/topics/{{ topic_name | urlencode }}"
+  }
+}
+</script>
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "https://kjvstudy.org"
+    },
+    {
+      "@type": "ListItem",
+      "position": 2,
+      "name": "Topics",
+      "item": "https://kjvstudy.org/topics"
+    },
+    {
+      "@type": "ListItem",
+      "position": 3,
+      "name": {{ topic_name | tojson }}
+    }
+  ]
+}
+</script>
+{% endblock %}
+
 {% block head %}
 <style>
 .topic-overview {
diff --git a/kjvstudy_org/templates/verse.html b/kjvstudy_org/templates/verse.html
index 3f0f8e8..d46306c 100644
--- a/kjvstudy_org/templates/verse.html
+++ b/kjvstudy_org/templates/verse.html
@@ -35,6 +35,43 @@
   }
 }
 </script>
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "https://kjvstudy.org"
+    },
+    {
+      "@type": "ListItem",
+      "position": 2,
+      "name": "Books",
+      "item": "https://kjvstudy.org/books"
+    },
+    {
+      "@type": "ListItem",
+      "position": 3,
+      "name": {{ book | tojson }},
+      "item": "https://kjvstudy.org/book/{{ book | urlencode }}"
+    },
+    {
+      "@type": "ListItem",
+      "position": 4,
+      "name": "Chapter {{ chapter }}",
+      "item": "https://kjvstudy.org/book/{{ book | urlencode }}/chapter/{{ chapter }}"
+    },
+    {
+      "@type": "ListItem",
+      "position": 5,
+      "name": "Verse {{ verse_num }}"
+    }
+  ]
+}
+</script>
 {% endblock %}
 
 {% block head %}