Public-readiness (2/3): friendlier indexes + recipe breadcrumbs

CHANGELOG.md

@@ -360,6 +360,18 @@ Recipe imports are logged both here (summary) and in
 
 ### Changed
 
+- **Friendlier generated indexes and per-recipe navigation.** Each category
+  README, the recipe index (`recipes/README.md`), and the tag index
+  (`recipes/tags.md`) now open with a short welcome line and a navigation row
+  linking Home, all recipes, the tag index, and the downloadable cookbook, so a
+  visitor can move around the archive without editing URLs. Added
+  [`tools/add_breadcrumbs.py`](tools/add_breadcrumbs.py), an idempotent,
+  value-guarded tool that inserts a breadcrumb (Home / All recipes / category)
+  just under the title of every recipe page (all 487), and ran it. The breadcrumb
+  renders as links on GitHub and is stripped from the EPUB build (`build_epub.py`
+  ignores the `<!-- nav -->` marker), so the e-book is unchanged in content. No
+  cook-from value, ingredient, or method text was touched.
+
 - **EPUB title/about-page typography fixes.** Disabled automatic hyphenation
   (`hyphens: none`) and wrapped the domain in a no-break span so it can no longer
   wrap as "bli-macake.com"; matched the licence-block font size to the body text on

recipes/README.md

@@ -1,7 +1,9 @@
 <!-- meta: title="Recipes" | type="recipe-index" | archive="blimacake" -->
 # Recipes
 
-The Blima Cake recipe archive: **487 recipes** across **16 categories**, imported verbatim from [blimacake.com](https://blimacake.com) and stored as portable Markdown. Browse a category below, search [by tag](tags.md), or see the [repository overview](../README.md).
+[Home](../README.md) &middot; [By tag](tags.md) &middot; [Get the cookbook](../BlimaCake.epub)
+
+All of Blima's recipes, **487** in total across **16 categories**. Pick a category to browse, or search [by tag](tags.md). You can also read the whole collection as a [downloadable cookbook](../BlimaCake.epub).
 
 | Category | Recipes | Preview |
 | --- | --- | --- |

recipes/appetizers/2851/index.md

@@ -40,6 +40,8 @@ verification:
 
 # Cooked Red Pepper & Tomato Salad
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ## Ingredients
 
 - 4 red bell peppers

recipes/appetizers/README.md

@@ -1,7 +1,9 @@
 <!-- meta: title="Appetizers" | type="recipe-category-index" | archive="blimacake" -->
 # Appetizers
 
-20 recipes in the **Appetizers** category of the [Blima Cake recipe archive](../README.md).
+[Home](../../README.md) &middot; [All recipes](../README.md) &middot; [By tag](../tags.md) &middot; [Get the cookbook](../../BlimaCake.epub)
+
+20 Appetizers recipes from Blima's kitchen. Open any recipe below for the ingredients and method, with photos.
 
 | Recipe | Preview |
 | --- | --- |

recipes/appetizers/baba-ganoush/index.md

@@ -46,6 +46,8 @@ verification:
 
 # Baba Ganoush
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ![Baba Ganoush](images/baba-ganoush-01.webp)
 
 ## Ingredients

recipes/appetizers/basic-new-york-style-pizza-dough/index.md

@@ -44,6 +44,8 @@ verification:
 
 # Basic New York-Style Pizza Dough
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ![Basic New York-Style Pizza Dough](images/basic-new-york-style-pizza-dough-01.png)
 
 ## Ingredients

recipes/appetizers/bread-dipping-oil/index.md

@@ -40,6 +40,8 @@ verification:
 
 # Bread Dipping Oil
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 A simple recipe for making an herbed olive oil dip for Italian bread. Serve in a shallow bowl, and let your guests help themselves.
 
 ## Ingredients

recipes/appetizers/greek-wings/index.md

@@ -52,6 +52,8 @@ verification:
 
 # Greek Wings
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ![Greek Wings](images/greek-wings-01.jpg)
 
 *The marinade used here is also available as a standalone recipe: [Greek Lemon-Oregano Marinade (Greek Wings)](../../sauces-rubs/greek-wings-marinade/index.md).*

recipes/appetizers/guasacaca-sauce-venezuela/index.md

@@ -48,6 +48,8 @@ verification:
 
 # Best-Ever Guacamole
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ![pillows 002](images/guasacaca-sauce-venezuela-01.jpg)
 
 ## Ingredients

recipes/appetizers/hummous-chick-pea-spread/index.md

@@ -50,6 +50,8 @@ verification:
 
 # Hummus with Spicy Chickpeas
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 *The topping used here is also available as a standalone recipe: [Spicy Chickpeas](../../sauces-rubs/spicy-chickpeas/index.md).*
 
 ## Ingredients

recipes/appetizers/italian-salsa-verde/index.md

@@ -41,6 +41,8 @@ verification:
 
 # Salsa Verde
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 this emerald-colored condiment is Italy’s quintessential dipping sauce. the rich basil-parsley salsa is enjoyed with everything from bread sticks and grilled vegetables to roasted meat and fish.
 
 ## Ingredients

recipes/appetizers/latkes/index.md

@@ -52,6 +52,8 @@ verification:
 
 # Latkes
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 Easy, Simple and Delicious
 
 ![Latkes](images/latkes-02.gif)

recipes/appetizers/moms-pickled-salmon/index.md

@@ -43,6 +43,8 @@ verification:
 
 # Mom's Pickled Salmon
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 This Pickled Salmon recipe is a family favorite served at a well known Montreal steakhouse. As far as appetizer recipes go, this one is a winner because it is prepared days ahead of time and keeps well in the fridge for at least a week. This dish is tried and true; you will land up with the most delicious fish you ever tasted.
 
 After three days, you will have a nutritious and incredibly delicious salmon dish to enjoy with family and friends.

recipes/appetizers/muhammara-roasted-red-pepper-dip/index.md

@@ -50,6 +50,8 @@ verification:
 
 # Muhammara (Roasted Red Pepper Dip)
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ![Muhammara (Roasted Red Pepper Dip)](images/muhammara-roasted-red-pepper-dip-01.jpg)
 
 ## Ingredients

recipes/appetizers/pecan-meatballs/index.md

@@ -53,6 +53,8 @@ verification:
 
 # PECAN MEATBALLS
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 *The tomato sauce used here is also available as a standalone recipe: [Tomato Sauce (Pecan Meatballs)](../../sauces-rubs/pecan-meatballs-tomato-sauce/index.md).*
 
 ## Ingredients

recipes/appetizers/perfect-marinated-tomatoes-with-mozzarella/index.md

@@ -46,6 +46,8 @@ verification:
 
 # Perfect Marinated Tomatoes with Mozzarella
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 Full of summer flavours these healthy tomatoes are soaked up with olive oil, balsamic vinegar and fresh herbs and served with pillowy cubes of fresh mozzarella. Try these marinated tomatoes, they make a perfect hors d’oeuvre that everyone will love!
 
 ![Perfect Marinated Tomatoes with Mozzarella](images/perfect-marinated-tomatoes-with-mozzarella-01.webp)

recipes/appetizers/quinoa-tabouleh/index.md

@@ -50,6 +50,8 @@ verification:
 
 # Quinoa Tabouleh
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ![Quinoa Tabouleh](images/quinoa-tabouleh-01.jpg)
 
 ## Ingredients

recipes/appetizers/roasted-tomatoes/index.md

@@ -38,6 +38,8 @@ verification:
 
 # Roasted Tomatoes
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ## Ingredients
 
 - 8-10 tomatoes, sliced thick, I get 4 slices for each tomato, fill a sheet pan in a single layer.

recipes/appetizers/slow-cooked-bell-peppers-with-bay-leaves-and-oregano/index.md

@@ -42,6 +42,8 @@ verification:
 
 # Slow-Cooked Bell Peppers
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 Bell peppers get sweet and silky when they slow-roast. Then use them to top ricotta toast, or serve as a side, or chop them up and mix into a salad.
 
 ![Slow-Cooked Bell Peppers](images/slow-cooked-bell-peppers-with-bay-leaves-and-oregano-01.jpg)

recipes/appetizers/spiced-meat-with-hummus/index.md

@@ -54,6 +54,8 @@ verification:
 
 # SPICED MEAT With HUMMUS
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 ![SPICED MEAT With HUMMUS](images/spiced-meat-with-hummus-01.jpg)
 
 ## Ingredients

recipes/appetizers/stuffed-cabbage/index.md

@@ -54,6 +54,8 @@ verification:
 
 # Stuffed Cabbage
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 *The sauce used here is also available as a standalone recipe: [Sweet-and-Sour Tomato Sauce (Stuffed Cabbage)](../../sauces-rubs/stuffed-cabbage-sauce/index.md).*
 
 ## Ingredients

recipes/appetizers/sweet-and-sour-meatballs/index.md

@@ -46,6 +46,8 @@ verification:
 
 # Sweet and Sour Meatballs
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 *The sauce used here is also available as a standalone recipe: [Sweet and Sour Sauce (Meatballs)](../../sauces-rubs/sweet-and-sour-sauce/index.md).*
 
 ## Ingredients

recipes/appetizers/yotam-ottolenghis-grilled-pepper-salad-with-cucumber-and-herbs/index.md

@@ -51,6 +51,8 @@ verification:
 
 # Yotam Ottolenghi’s grilled pepper salad with cucumber and herbs
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Appetizers](../README.md)
+
 It works as a starter, with bread, as a side dish or as part of a meze spread.
 
 ![Yotam Ottolenghi’s grilled pepper salad with cucumber and herbs.](images/yotam-ottolenghis-grilled-pepper-salad-with-cucumber-and-herbs-01.jpg)

recipes/breads/README.md

@@ -1,7 +1,9 @@
 <!-- meta: title="Breads" | type="recipe-category-index" | archive="blimacake" -->
 # Breads
 
-9 recipes in the **Breads** category of the [Blima Cake recipe archive](../README.md).
+[Home](../../README.md) &middot; [All recipes](../README.md) &middot; [By tag](../tags.md) &middot; [Get the cookbook](../../BlimaCake.epub)
+
+9 Breads recipes from Blima's kitchen. Open any recipe below for the ingredients and method, with photos.
 
 | Recipe | Preview |
 | --- | --- |

recipes/breads/best-banana-bread/index.md

@@ -42,6 +42,8 @@ verification:
 
 # Best Banana Bread
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 ## Ingredients
 
 - 3 medium very ripe bananas (the blacker the better)

recipes/breads/chalah-bread/index.md

@@ -54,6 +54,8 @@ verification:
 
 # Challah Bread
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 ## Ingredients
 
 - 1 tsp. (5 ml) sugar

recipes/breads/dakota-bread/index.md

@@ -61,6 +61,8 @@ verification:
 
 # Dakota Bread
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 From Cook's Country
 
 Be sure to use hot cereal mix, not boxed cold breakfast cereals, which may also be labeled "seven-grain."

recipes/breads/double-baked-crispsclone-of-raincoast-crisps/index.md

@@ -47,6 +47,8 @@ verification:
 
 # Double-baked Crisps(Clone-of-Raincoast-Crisps)
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 Using this recipe, you can make Rosemary Raisin Pecan Crisps, Cranberry Hazelnut Crisps, Fig Walnut Crisps or Date Almond Crisps, just by swapping out the fruit and nuts accordingly.
 
 These are best on the day after they are double-baked, but will keep for longer in an airtight tin. It's probably best to keep the baked loaves in the freezer and slice and second-bake them as needed (just add a minute or two to the baking time if from frozen).

recipes/breads/new-years-apple-challah/index.md

@@ -64,6 +64,8 @@ verification:
 
 # New Year's Apple Challah
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 ## Ingredients
 
 ### Dough

recipes/breads/olive-bread/index.md

@@ -52,6 +52,8 @@ verification:
 
 # Olive bread
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 ## Ingredients
 
 - ¾ cup (180 ml) pitted olives, rinsed, patted dry, and chopped coarse

recipes/breads/pizza-hut-style-pizza-dough/index.md

@@ -45,6 +45,8 @@ verification:
 
 # Pizza Hut Style Pizza Dough
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 This is one of the best pizza dough recipes I have found.
 
 ## Ingredients

recipes/breads/turkish-pide-breads/index.md

@@ -52,6 +52,8 @@ verification:
 
 # Turkish Pide Breads
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 Makes two 10-inch breads
 
 These are not the thin, pocketed flatbreads . Pide are roughly the size of a small pizza, with an airy, open crumb and a tender, almost pillowy quality. Sometimes a sprinkling of seeds adds texture and flavour. starting with a sponge, a mixture of yeast, flour and water that becomes bubbly after standing for 30 minutes, produced breads with not only the lightness we were after, but also a more complex flavor. For dusting the breads just before baking,I use sesame seeds, The bread is best served warm or at room temperature the day of baking, but foil-wrapped leftovers reheat well in a 400°F oven in about 10 minutes.

recipes/breads/zaatar-flatbreads-2/index.md

@@ -50,6 +50,8 @@ verification:
 
 # Za'atar Flatbreads
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breads](../README.md)
+
 This versatile dough is a breeze to make in a food processor and can be used for Middle Eastern-style flatbreads or pizzas with various toppings. The Greek yogurt makes a supple dough that's easy to work with and that bakes up with a chewy-soft crumb and subtle richness.
 
 **Note:** Don't under-mix the dough in the food processor; it needs a full minute of processing to build the gluten that provides structure and strength. When done, the dough may be warm to the touch; this is normal.

recipes/breakfast-brunch/README.md

@@ -1,7 +1,9 @@
 <!-- meta: title="Breakfast & Brunch" | type="recipe-category-index" | archive="blimacake" -->
 # Breakfast & Brunch
 
-7 recipes in the **Breakfast & Brunch** category of the [Blima Cake recipe archive](../README.md).
+[Home](../../README.md) &middot; [All recipes](../README.md) &middot; [By tag](../tags.md) &middot; [Get the cookbook](../../BlimaCake.epub)
+
+7 Breakfast & Brunch recipes from Blima's kitchen. Open any recipe below for the ingredients and method, with photos.
 
 | Recipe | Preview |
 | --- | --- |

recipes/breakfast-brunch/blueberry-buttermilk-pancakes/index.md

@@ -45,6 +45,8 @@ verification:
 
 # Blueberry Buttermilk Pancakes
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breakfast & Brunch](../README.md)
+
 ## Ingredients
 
 - 2 cups (480 ml) flour

recipes/breakfast-brunch/ginger-lemon-jam/index.md

@@ -44,6 +44,8 @@ verification:
 
 # Ginger & Lemon Jam
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breakfast & Brunch](../README.md)
+
 A sweet and spicy jam that is perfect with savory dishes.
 
 ![Ginger &amp; Lemon Jam](images/ginger-lemon-jam-01.jpg)

recipes/breakfast-brunch/hash-brown-potatoes/index.md

@@ -41,6 +41,8 @@ verification:
 
 # Hash Brown Potatoes
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breakfast & Brunch](../README.md)
+
 ## Ingredients
 
 - 2 tablespoons (30 ml) unsalted butter

recipes/breakfast-brunch/hot-pepper-jelly/index.md

@@ -42,6 +42,8 @@ verification:
 
 # Hot Pepper Jelly
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breakfast & Brunch](../README.md)
+
 ## Ingredients
 
 - 3 large red bell peppers

recipes/breakfast-brunch/moms-granola/index.md

@@ -48,6 +48,8 @@ verification:
 
 # Mom’s Granola
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breakfast & Brunch](../README.md)
+
 ![Granola](images/moms-granola-01.jpg)
 
 ## Ingredients

recipes/breakfast-brunch/perfect-pancakes/index.md

@@ -47,6 +47,8 @@ verification:
 
 # Perfect Pancakes
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breakfast & Brunch](../README.md)
+
 ## Ingredients
 
 - 1 1/2 cups (360 ml) all-purpose flour

recipes/breakfast-brunch/sticky-cinnamon-buns/index.md

@@ -59,6 +59,8 @@ verification:
 
 # Sticky Cinnamon Buns
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Breakfast & Brunch](../README.md)
+
 ![IMG_3787](images/sticky-cinnamon-buns-02.jpg)
 
 *The filling used here is also available as a standalone recipe: [Cinnamon-Pecan Sticky Bun Filling](../../desserts/sticky-bun-cinnamon-filling/index.md).*

recipes/cakes/1476/index.md

@@ -56,6 +56,8 @@ verification:
 
 # Linda's Favorite Banana Cake
 
+<!-- nav --> [Home](../../../README.md) &middot; [All recipes](../../README.md) &middot; [Cakes](../README.md)
+
 My Phone rings at 8 p.m and my BFF Linda is on the phone telling me about this cake, she was very happy with the results.
 
 This Banana Cake is another great recipe adapted from Rose Levy Beranbaum's The Cake Bible. Instead of the more common 'creaming' method where the butter and sugar are creamed together and then you beat in the eggs, flour, and liquid, this recipe uses what we call the 'one bowl' or 'quick method'. This method entails first blending all the wet ingredients (bananas, sour cream, vanilla extract, and eggs) together. Then, in your electric mixer, all the dry ingredients (flour, sugar, leavening, salt, and ground cinnamon) are mixed together. Next, the butter, along with part of the wet ingredients, are beaten into the dry ingredients. This batter needs to be beaten for about 90 seconds (to develop the cake's structure) and then the remaining banana mixture is added. While this method may be a little unusual, it reduces gluten formation which results in a cake that literally melts-in-your-mouth with a velvety texture that is moist and dense. Just make sure to have all the ingredients at room temperature and to follow the instructions on mixing. I baked this cake in a 9 inch round cake pan, but you could bake it in a bundt pan with excellent results. This cake can be stored for several days at room temperature or in the refrigerator.