From 50c124491fcefe3abce3f6cbe74c8d18338eba36 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Tue, 7 Jul 2026 16:32:10 +0000
Subject: [PATCH] Static site (3): SEO and Recipe structured data

Add schema.org Recipe JSON-LD to every recipe page (name, author,
category, ingredients, step instructions, keywords, yield, image), plus
canonical, Open Graph, and Twitter-card meta site-wide (recipe pages use
their own photo and article type; others use the biscotti image). Add a
generated sitemap.xml (507 URLs) and robots.txt. All absolute URLs use
the github.blimacake.com domain.

Verified: JSON-LD parses and carries the right fields; recipes with a
photo expose it in JSON-LD and OG image; sitemap and robots build.

Co-authored-by: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HpG2vky2XhDtfc6y16TRis
---
 CHANGELOG.md            |  8 ++++++++
 eleventy.config.js      | 22 ++++++++++++++++++++++
 site/_includes/base.njk |  8 ++++++++
 site/recipe.njk         |  3 +++
 site/robots.njk         |  8 ++++++++
 site/sitemap.njk        | 14 ++++++++++++++
 6 files changed, 63 insertions(+)
 create mode 100644 site/robots.njk
 create mode 100644 site/sitemap.njk

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b6e7eb2..f6f20d6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,14 @@ Recipe imports are logged both here (summary) and in
 
 ### Added
 
+- **Static site: SEO and Recipe structured data (ADR 0003, PR 3 of the site phase).**
+  Each recipe page now carries schema.org `Recipe` JSON-LD (name, author, category,
+  ingredients, step-by-step instructions, keywords, yield, and image) so search
+  engines can show rich results. Added canonical, Open Graph, and Twitter-card meta to
+  every page (recipe pages use their own photo and an `article` type; other pages use
+  the biscotti image). Added a generated `sitemap.xml` (507 URLs) and `robots.txt`
+  pointing at it. All absolute URLs use the `github.blimacake.com` domain.
+
 - **Static site: full-text search (ADR 0003, PR 2 of the site phase).** Added a
   `/search/` page powered by [Pagefind](https://pagefind.app/), a static search index
   built from the site output (`npm run build` now runs `eleventy && pagefind`). Only
diff --git a/eleventy.config.js b/eleventy.config.js
index 7ac3eb4..0a0e190 100644
--- a/eleventy.config.js
+++ b/eleventy.config.js
@@ -17,6 +17,28 @@ export default function (eleventyConfig) {
 
   eleventyConfig.addFilter("limit", (arr, n) => (arr || []).slice(0, n));
 
+  // schema.org/Recipe structured data for a recipe, as an escaped JSON string
+  // safe to drop into a <script type="application/ld+json"> block.
+  eleventyConfig.addFilter("recipeJsonLd", (recipe, siteUrl) => {
+    const obj = {
+      "@context": "https://schema.org",
+      "@type": "Recipe",
+      name: recipe.title,
+      author: { "@type": "Person", name: "Blima Posluns" },
+      url: siteUrl + recipe.url,
+      recipeCategory: recipe.category,
+      recipeIngredient: recipe.ingredients,
+      recipeInstructions: (recipe.steps || []).map((text) => ({
+        "@type": "HowToStep",
+        text,
+      })),
+    };
+    if (recipe.tags && recipe.tags.length) obj.keywords = recipe.tags.join(", ");
+    if (recipe.yield) obj.recipeYield = recipe.yield;
+    if (recipe.heroImage) obj.image = [siteUrl + recipe.heroImage];
+    return JSON.stringify(obj).replace(/</g, "\\u003c");
+  });
+
   return {
     dir: {
       input: "site",
diff --git a/site/_includes/base.njk b/site/_includes/base.njk
index 02d6c62..5eb07d8 100644
--- a/site/_includes/base.njk
+++ b/site/_includes/base.njk
@@ -5,6 +5,14 @@
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>{% if pageTitle %}{{ pageTitle }} &middot; {% endif %}{{ site.title }}</title>
     <meta name="description" content="{{ pageDescription or site.description }}" />
+    <link rel="canonical" href="{{ site.url }}{{ page.url }}" />
+    <meta property="og:site_name" content="{{ site.title }}" />
+    <meta property="og:type" content="{% if pageImage %}article{% else %}website{% endif %}" />
+    <meta property="og:title" content="{{ pageTitle or site.title }}" />
+    <meta property="og:description" content="{{ pageDescription or site.description }}" />
+    <meta property="og:url" content="{{ site.url }}{{ page.url }}" />
+    <meta property="og:image" content="{{ site.url }}{{ pageImage or site.heroImage }}" />
+    <meta name="twitter:card" content="summary_large_image" />
     <link rel="stylesheet" href="/assets/style.css" />
   </head>
   <body>
diff --git a/site/recipe.njk b/site/recipe.njk
index c955f58..21b6060 100644
--- a/site/recipe.njk
+++ b/site/recipe.njk
@@ -7,7 +7,10 @@ pagination:
 permalink: "{{ recipe.url }}"
 eleventyComputed:
   pageTitle: "{{ recipe.title }}"
+  pageImage: "{{ recipe.heroImage }}"
+  pageDescription: "Blima's recipe for {{ recipe.title }}: ingredients and method."
 ---
+<script type="application/ld+json">{{ recipe | recipeJsonLd(site.url) | safe }}</script>
 <article class="recipe wrap" data-pagefind-body>
   <nav class="crumbs" data-pagefind-ignore>
     <a href="/">Home</a> &middot;
diff --git a/site/robots.njk b/site/robots.njk
new file mode 100644
index 0000000..a03d7aa
--- /dev/null
+++ b/site/robots.njk
@@ -0,0 +1,8 @@
+---
+permalink: /robots.txt
+eleventyExcludeFromCollections: true
+---
+User-agent: *
+Allow: /
+
+Sitemap: {{ site.url }}/sitemap.xml
diff --git a/site/sitemap.njk b/site/sitemap.njk
new file mode 100644
index 0000000..f279380
--- /dev/null
+++ b/site/sitemap.njk
@@ -0,0 +1,14 @@
+---
+permalink: /sitemap.xml
+eleventyExcludeFromCollections: true
+---
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url><loc>{{ site.url }}/</loc></url>
+  <url><loc>{{ site.url }}/categories/</loc></url>
+  <url><loc>{{ site.url }}/tags/</loc></url>
+  <url><loc>{{ site.url }}/search/</loc></url>
+  {% for cat in categories %}<url><loc>{{ site.url }}{{ cat.url }}</loc></url>
+  {% endfor %}{% for r in recipes %}<url><loc>{{ site.url }}{{ r.url }}</loc></url>
+  {% endfor %}
+</urlset>