mirror of
https://github.com/nicholaswilde/recipes.git
synced 2026-02-04 16:15:35 +00:00
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:
30
AGENTS.md
30
AGENTS.md
@ -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
|
||||
|
||||
|
||||
1
cook/config/ignored_ingredients.yaml
Normal file
1
cook/config/ignored_ingredients.yaml
Normal file
@ -0,0 +1 @@
|
||||
- nonstick baking spray
|
||||
20
cook/cookies-and-bars/Pumpkin Blondies.cook
Normal file
20
cook/cookies-and-bars/Pumpkin Blondies.cook
Normal 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 that’s 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{}.
|
||||
BIN
cook/cookies-and-bars/Pumpkin Blondies.jpg
Normal file
BIN
cook/cookies-and-bars/Pumpkin Blondies.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 137 KiB |
BIN
docs/assets/images/pumpkin-blondies.jpg
Normal file
BIN
docs/assets/images/pumpkin-blondies.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 137 KiB |
85
docs/cookies-and-bars/pumpkin-blondies.md
Normal file
85
docs/cookies-and-bars/pumpkin-blondies.md
Normal 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
|
||||
that’s 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>
|
||||
@ -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 |
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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" },
|
||||
|
||||
Reference in New Issue
Block a user