feat(recipes): add Pumpkin Blondies and update docs/config

- Import 'Pumpkin Blondies' recipe (Issue #1311).
- Add gram measurements to recipe and update 'docs/reference/measuring.md'.
- Update 'AGENTS.md' with conversion instructions, GH CLI ops, and ignored ingredients.
- Create 'cook/config/ignored_ingredients.yaml'.
- Update 'includes/emoji.yaml' and 'zensical.toml'.
This commit is contained in:
nιcнolaѕ wιlde
2025-12-19 21:31:48 -08:00
parent 5cc8e42dd5
commit b5dbfe7581
9 changed files with 145 additions and 5 deletions

View File

@ -16,9 +16,9 @@ This project is a personal recipe collection managed as a documentation site usi
# Building and Running
* **Build Docker image:** `task build`
* **Start local development server (Docker):** `task serve` (access at `http://0.0.0.0:8000`)
* **Start local development server (local Zensical install):** `task serve-local`
* **Install Zensical:** `task docs:deps` (uses `uv` and `pip`)
* **Update Zensical:** `task docs:update`
* **Start local development server:** `task serve` (access at `http://127.0.0.1:8000`)
* **Start Cooklang server:** `task server`
* **Deploy to GitHub Pages:** The GitHub Actions workflow `ci.yaml` automatically deploys the docs on pushes to `main` branch (paths `docs/**`, `mkdocs.**`). Manually, this would involve `zensical gh-deploy --force` after installing dependencies.
@ -43,13 +43,33 @@ This project is a personal recipe collection managed as a documentation site usi
* **Recipe Markdown Pages:** Recipe markdown pages in `docs/` should use emoji from `includes/emoji.yaml`.
* **Recipe Markdown Format:** Recipe markdown pages should follow a consistent format, including front matter for metadata (e.g., comments, tags), a main title with an emoji, an image with `loading=lazy`, a table for serving and time information, and sections for ingredients, cookware, and instructions. Each ingredient in the ingredients section should be prefixed with an emoji shortcode from `includes/emoji.yaml`. Instructions should be numbered steps, with `!!! tip` used for additional information.
# Helper Tasks
* **Search Emojis:** `task emoji-search` (filters `includes/emoji.yaml`).
* **List Ingredients:** `task list-ingredients` (lists all used ingredients to help with consistency).
* **Validate Config:** `task validate` (checks `zensical.toml` syntax).
* **Spellcheck File:** `task spellcheck-file FILE=path/to/file`.
# GitHub CLI Operations
* **List Issues:** `gh issue list` (lists open issues in the repository).
* **Filter Issues by Label:** `gh issue list --label required` (filters issues to show only those requiring action).
# Recipe Import Process
1. **Create the `.cook` file:** Follow the specification in the [Cooklang Specification](#cooklang-specification) section.
* **Ignored Items:** Before tagging an item as an ingredient (with `@`), check `cook/config/ignored_ingredients.yaml`. If the item is listed there, do **not** tag it as an ingredient.
2. **Add the Image:** Download an image from the source, name it the same as the cook file (e.g., `Recipe Name.jpg`), and place it in the same directory as the `.cook` file.
3. **Run the Move Task:** Execute `FILES=<path/to/cookfile> task move`. This converts the `.cook` file to Markdown and runs spellcheck and link check.
4. **Update `zensical.toml`:** Add the recipe mapping (e.g., `{ "Recipe Name" = "category/recipe-name.md" },`) to the correct section in `zensical.toml`.
3. **Run the Move Task:** Execute `FILES=<path/to/cookfile> task move`. This converts the `.cook` file to Markdown, runs spellcheck and link check, and generates the `zensical.toml` mapping entry (copying it to clipboard if possible).
4. **Update `zensical.toml`:** Paste the mapping entry generated by the previous step into the correct section of `zensical.toml`.
5. **Add Ingredient Emojis:** Update the generated Markdown file by adding emoji shortcodes to each item in the ingredients section (referencing `includes/emoji.yaml`). If an ingredient is missing from `includes/emoji.yaml`, use your best judgement to pick one and update `includes/emoji.yaml` with the new mapping. Ensure that the selected emoji is compatible with mkdocs-material.
6. **Add Tags:** Generate relevant tags for the recipe and add them to the front matter of the generated Markdown file.
7. **Volumetric to Weight Conversions:** Convert volumetric measurements to grams in the Markdown file using the following rules:
* **Formatting:** Place the weight in parentheses after the volume, e.g., `2 cups (240 g) all-purpose flour`.
* **Reference:** Use `docs/reference/measuring.md` for weight conversions.
* **Missing Conversions:** If a conversion is missing from the reference file, look it up on the [King Arthur Baking Ingredient Weight Chart](https://www.kingarthurbaking.com/learn/ingredient-weight-chart).
* **Update Reference:** If a new conversion is found externally, add it to `docs/reference/measuring.md` for future use.
* **Exceptions:** Ignore gram conversions for small measurements (e.g., teaspoons, tablespoons) of spices, herbs, and seasonings.
# Cooklang Specification

View File

@ -0,0 +1 @@
- nonstick baking spray

View File

@ -0,0 +1,20 @@
>> source: https://cooking.nytimes.com/recipes/1021463-pumpkin-blondies
>> serves: 24
>> total time: 50 minutes
>> prep time: 5 minutes
>> cook time: 45 minutes
>> image: Pumpkin Blondies.png
Heat the oven to 350 degrees. Line a #9-by-13-inch baking pan{} with foil, then spray with nonstick baking spray.
In a #medium bowl{}, combine the @all-purpose flour{2%cups}, @pumpkin pie spice{1%tbsp}, @baking soda{1%tsp} and @kosher salt{1%tsp}. Stir together and set aside.
In the #bowl of an electric mixer{} fitted with the #paddle attachment{}, beat together the @unsalted butter{1%cup} (at room temperature) and @granulated sugar{1.25%cups} on medium-high speed until light and fluffy, about ~{2%minutes}. Beat in the @egg{1%large} and @vanilla extract{2%tsp} until well combined.
With the mixer on low, add the @pumpkin purée{1%cup} and beat until well blended. (It will look curdled at this point, and thats OK!)
Add the dry ingredients and mix until just incorporated. With the mixer still on low, add the @white chocolate chips{1%cup} and @butterscotch chips{1%cup} (and @chopped pecans or walnuts{0.5%cup}, if using), and mix until combined.
Spread the batter evenly into the prepared pan. Bake until the edges begin to pull away from the sides and a toothpick inserted in the center comes out with just a few crumbs, ~{30%minutes} to ~{35%minutes}. Transfer the pan to a #wire rack{} to cool completely before cutting.
To serve, lift the blondies from the pan using the foil, transfer to a #cutting board{} and peel off the foil. Cut into 24 squares using a #sharp knife{}.

Binary file not shown.

After

Width:  |  Height:  |  Size: 137 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 137 KiB

View File

@ -0,0 +1,85 @@
---
comments: true
tags:
- cookie
- bar
- dessert
- pumpkin
- fall
---
# Pumpkin Blondies
![Pumpkin Blondies][1]{ loading=lazy }
| :fork_and_knife_with_plate: Serves | :timer_clock: Total Time |
|:----------------------------------:|:-----------------------: |
| 24 | 1.12 hours |
## :salt: Ingredients
- :ear_of_rice: 2 cups (240 g) all-purpose flour
- :chestnut: 1 tbsp pumpkin pie spice
- :cup_with_straw: 1 tsp baking soda
- :salt: 1 tsp kosher salt
- :butter: 1 cup (227 g) unsalted butter
- :candy: 1.25 cups (248 g) granulated sugar
- :egg: 1 large egg
- :icecream: 2 tsp vanilla extract
- :jack_o_lantern: 1 cup (227 g) pumpkin purée
- :chocolate_bar: 1 cup (170 g) white chocolate chips
- :chocolate_bar: 1 cup (185 g) butterscotch chips
- :chestnut: 0.5 cup (57 g) chopped pecans or walnuts
## :cooking: Cookware
- 1 9-by-13-inch baking pan
- 1 medium bowl
- 1 bowl of an electric mixer
- 1 paddle attachment
- 1 wire rack
- 1 cutting board
- 1 sharp knife
## :pencil: Instructions
### Step 1
Heat the oven to 350 degrees. Line a 9-by-13-inch baking pan with foil, then spray with nonstick baking spray.
### Step 2
In a medium bowl, combine the all-purpose flour, pumpkin pie spice, baking soda and kosher salt. Stir together and set
aside.
### Step 3
In the bowl of an electric mixer fitted with the paddle attachment, beat together the unsalted butter (at room
temperature) and granulated sugar on medium-high speed until light and fluffy, about 2 minutes. Beat in the egg and
vanilla extract until well combined.
### Step 4
With the mixer on low, add the pumpkin purée and beat until well blended. (It will look curdled at this point, and
thats OK!)
### Step 5
Add the dry ingredients and mix until just incorporated. With the mixer still on low, add the white chocolate chips and
butterscotch chips (and chopped pecans or walnuts, if using), and mix until combined.
### Step 6
Spread the batter evenly into the prepared pan. Bake until the edges begin to pull away from the sides and a toothpick
inserted in the center comes out with just a few crumbs, 30 minutes to 35 minutes. Transfer the pan to a wire rack to
cool completely before cutting.
### Step 7
To serve, lift the blondies from the pan using the foil, transfer to a cutting board and peel off the foil. Cut into 24
squares using a sharp knife.
## :link: Source
- <https://cooking.nytimes.com/recipes/1021463-pumpkin-blondies>
[1]: <../assets/images/pumpkin-blondies.jpg>

View File

@ -247,6 +247,7 @@ $$
| Pineapple (fresh or canned, diced) | 1 cup | 170 | 6 |
| Pistachio Nuts (shlled) | 1/2 cup | 60 | 2-1/8 |
| Polenta (coarse ground cornmeal) | 1 cup | 163 | 5-3/4 |
| Pumpkin Purée | 1 cup | 227 | 8 |
| Quinoa (whole) | 1 cup | 177 | 6-1/4 |
| Quinoa Flour | 1 cup | 110 | 3-7/8 |
| Raisins (loose) | 1 cup | 149 | 5-1/4 |

View File

@ -27,10 +27,13 @@ emoji:
- butter:
- butter
- tofu
- unsalted butter
- nonstick baking spray
- candy:
- sugar
- powdered sugar
- confectioner's sugar
- granulated sugar
- carrot:
- carrot
- frozen vegetables
@ -44,9 +47,14 @@ emoji:
- nutmeg
- almonds
- pine nuts
- pumpkin pie spice
- pecans
- walnuts
- chocolate_bar:
- chocolate
- chocolate chips
- white chocolate chips
- butterscotch chips
- coconut:
- coconut
- cup_with_straw:
@ -65,6 +73,7 @@ emoji:
- ear_of_rice:
- flour
- oats
- all-purpose flour
- egg:
- egg
- mayonnaise
@ -121,10 +130,12 @@ emoji:
- icecream:
- vanilla
- icecream
- vanilla extract
- ice_cube:
- ice water
- jack_o_lantern:
- pumpkin
- pumpkin purée
- leafy_green:
- cabbage
- red cabbage
@ -163,6 +174,7 @@ emoji:
- salt:
- salt
- pepper
- kosher salt
- seedling:
- pumpkin seeds
- sunflower seeds

View File

@ -257,6 +257,7 @@ Breakfast = [
{ "Peanut Butter Stuffed Brownies" = "cookies-and-bars/peanut-butter-stuffed-brownies.md" },
{ "Persian Chickpea cookies with Pistachio" = "cookies-and-bars/persian-chickpea-cookies-with-pistachio.md" },
{ "Preposterously Peanut Butter Cup Cookies" = "cookies-and-bars/preposterously-peanut-butter-cup-cookies.md" },
{ "Pumpkin Blondies" = "cookies-and-bars/pumpkin-blondies.md" },
{ "Pumpkin Cheesecake Cookies" = "cookies-and-bars/pumpkin-cheesecake-cookies.md" },
{ "Pumpkin Chocolate Chip Cookies" = "cookies-and-bars/pumpkin-chocolate-chip-cookies.md" },
{ "Pumpkin Cookies with Cream Cheese Frosting" = "cookies-and-bars/pumpkin-cookies-with-cream-cheese-frosting.md" },