Recipedius - User contributions [en]

Template:Recipe/testcases

2026-09-25T14:04:06Z

Recipedius deploy: 0.015 T013: target missing ingredients and canonicalize fractions (1b80afc)

Cases for [[Template:Recipe/sandbox]]. Each one states what it is meant to
show. Check them after any change to the recipe template or to
[[Module:Recipedius]], and before that change is committed for deployment.

== Preferred parameter names ==

{{Recipe/sandbox
|serves=24
|time=50 min
|tags=dessert, baking
|contributor=Testcases
|description=Written with the preferred <code>description</code> and <code>instructions</code> names.
|ingredients=
Butter; 1; cup; creaming; softened
Granulated sugar; ½; cup; sweet
All-purpose flour; 2; cup; structure
|instructions=
# Beat the butter and sugar until pale.
# Stir in the flour.
}}

Must render Description, Ingredients and Instructions in that order, with the
substitution section after Instructions. The legacy Unicode fraction input must
render as the ASCII quantity `1/2 cup`.

== Legacy parameter names ==

{{Recipe/sandbox
|serves=24
|time=50 min
|contributor=Testcases
|lede=Written with the legacy <code>lede</code> and <code>method</code> names.
|ingredients=
Butter; 1; cup; creaming
|method=
# Melt the butter.
}}

Must render identically in structure to the case above. Existing pages and the
Page Forms still use these names.

== Preferred name wins over legacy ==

{{Recipe/sandbox
|serves=1
|description=This preferred description must be the one shown.
|lede=This legacy lede must not appear.
|ingredients=
Butter; 1; tbsp; melted
|instructions=
# These preferred instructions must be the ones shown.
|method=
# This legacy method must not appear.
}}

== Ingredient link resolution ==

{{Recipe/sandbox
|serves=2
|description=Three kinds of ingredient line.
|ingredients=
Butter; 1; cup; creaming
Classic shortbread; 1; each; inclusion
Nonexistent ingredient page; 1; cup; structure
|instructions=
# Nothing to do.
}}

The first line names an ingredient record and must be a plain internal link
that contributes calories and allergens. The second names an existing recipe
and must also be a plain internal link, with no missing marker. The third names
a page that does not exist: it must link to
`Special:FormEdit/Ingredient/Nonexistent ingredient page`, carry the missing
marker, and appear in the missing-nutrition warning above. That route must
open the pre-targeted Ingredient form rather than the generic raw editor.

== No description and no instructions ==

{{Recipe/sandbox
|serves=1
|ingredients=
Butter; 1; tbsp
}}

Both headings must still appear, each with its placeholder text, so the page
shape is predictable while a recipe is being written.

== Empty call ==

{{Recipe/sandbox}}

Must not raise a script error.
<noinclude>[[Category:Recipedius templates]]</noinclude>

Module:Recipedius/sandbox

2026-09-25T14:04:06Z

Recipedius deploy: 0.015 T013: target missing ingredients and canonicalize fractions (1b80afc)

-- Development copy of [[Module:Recipedius]]. Exercise changes at
-- [[Template:Recipe/testcases]] through [[Template:Recipe/sandbox]], then copy
-- an approved revision into the production module.
--
-- Keep this a faithful copy. It is the only place a module change can be seen
-- rendered before it reaches every recipe on the wiki.
--[[
Module:Recipedius
The computed layer of Recipedius. Reads ingredient records and substitution rules
from Cargo tables and renders recipe pages, the weekly sale ranking, and cookbooks.

Entry points (all via {{#invoke:Recipedius|fn}} from templates):
recipe - renders a recipe from Template:Recipe args and stores its rows
sale - ranks recipes by how many of their shopping items are on sale
cookbook - renders a printable book from a list of recipe pages
]]

local p = {}
local cargo = mw.ext.cargo

-- ---------------------------------------------------------------- helpers

local FRACTIONS = {
{ 0.125, '1/8' }, { 0.25, '1/4' }, { 1/3, '1/3' }, { 0.375, '3/8' }, { 0.5, '1/2' },
{ 0.625, '5/8' }, { 2/3, '2/3' }, { 0.75, '3/4' }, { 0.875, '7/8' },
}
local FRACTION_CHARS = { ['⅛']=0.125, ['¼']=0.25, ['⅓']=1/3, ['⅜']=0.375, ['½']=0.5, ['⅝']=0.625, ['⅔']=2/3, ['¾']=0.75, ['⅞']=0.875 }

local function trim(s) return mw.text.trim(s or '') end

local function ingredientTitle(s)
s = trim(s)
local linked = s:match('^%[%[([^%[%]|]+)%]%]$')
return linked and trim(linked) or s
end

-- A missing ingredient must open its pre-targeted Page Forms editor, not
-- MediaWiki's generic raw editor. mw.title normalizes and encodes the target.
local function ingredientFormLink(name, label)
local target = mw.title.new('Special:FormEdit/Ingredient/' .. name)
if not target then return mw.text.nowiki(label) end
return '[' .. target:fullUrl() .. ' ' .. mw.text.nowiki(label) .. ']'
end

-- "1 1/2", "3/4", "0.5", "1 ½" and "¾" all parse.
local function parseQty(s)
s = trim(s)
local total, found = 0, false
for tok in s:gmatch('%S+') do
if FRACTION_CHARS[tok] then total = total + FRACTION_CHARS[tok]; found = true
else
local a, b = tok:match('^(%d+)/(%d+)$')
if a then total = total + tonumber(a) / tonumber(b); found = true
elseif tonumber(tok) then total = total + tonumber(tok); found = true end
end
end
if found then return total end
return nil
end

local function fmtQty(q)
if not q then return '' end
local w = math.floor(q + 1e-6)
local f = q - w
if f > 0.94 then w = w + 1; f = 0 end
local fs = ''
if f > 0.06 then
local best, bd = nil, 1
for _, pair in ipairs(FRACTIONS) do
local d = math.abs(pair[1] - f)
if d < bd then bd = d; best = pair[2] end
end
if bd < 0.06 then fs = best else fs = string.format('%.2f', f):gsub('^0', '') end
end
if w == 0 then return fs ~= '' and fs or '0' end
if fs ~= '' then return w .. ' ' .. fs end
return tostring(w)
end

local PLURALS = { ['Garlic'] = 'Garlic cloves', ['Whole chicken'] = 'Whole chickens', ['Russet potato'] = 'Russet potatoes' }
-- Display name for a count-based ingredient: "2 eggs", "3 bananas", "6 garlic cloves".
local function countLabel(name, q, u)
if u ~= 'each' or not q or q <= 1 then return name end
if PLURALS[name] then return PLURALS[name] end
if name:sub(-1) == 's' then return name end
return name .. 's'
end

local function unitLabel(q, u)
if u == 'each' or u == '' then return '' end
if u == 'cup' and q and q > 1 then return 'cups' end
return u
end

local function sqlEsc(s) return (tostring(s):gsub("'", "\\'")) end

local function splitList(s)
local out = {}
for item in (s or ''):gmatch('[^,]+') do
item = trim(item)
if item ~= '' then table.insert(out, item) end
end
return out
end

local function round(x) return math.floor(x + 0.5) end

-- ---------------------------------------------------------------- data access

local ingredientCache = {}
local function getIngredient(name)
if ingredientCache[name] ~= nil then return ingredientCache[name] or nil end
local rows = cargo.query('Ingredients',
'_pageName=name,kcal100,g_tsp,g_tbsp,g_cup,g_each,allergens,pantry,price,price_per',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
ingredientCache[name] = rows[1] or false
return rows[1]
end

local recipeCache = {}
local function getRecipe(name)
if recipeCache[name] ~= nil then return recipeCache[name] or nil end
local rows = cargo.query('Recipes', '_pageName=name',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
recipeCache[name] = rows[1] or false
return rows[1]
end

local function gramsPer(ing, unit)
if not ing then return nil end
local key = ({ tsp = 'g_tsp', tbsp = 'g_tbsp', cup = 'g_cup', each = 'g_each' })[unit]
if not key then return nil end
return tonumber(ing[key])
end

local function kcalOf(ing, q, unit)
local g = gramsPer(ing, unit)
local k = ing and tonumber(ing.kcal100)
if not (g and k and q) then return 0 end
return q * g * k / 100
end

-- Substitution rules for an ingredient, resolved for the role it plays in this recipe.
-- A base row (role blank) applies everywhere; a row with a role overrides the base for that role.
-- An override with applicable=no removes the option for that role.
local subsCache = {}
local function rulesFor(name, role)
if not subsCache[name] then
subsCache[name] = cargo.query('Substitutions',
'sub_to,alt,role,ratio,conv,confidence,effect,warning,applicable',
{ where = "sub_from='" .. sqlEsc(name) .. "'", orderBy = 'sub_to', limit = 200 })
end
local groups, order = {}, {}
for _, r in ipairs(subsCache[name]) do
local key = (r.sub_to or '') .. '|' .. (r.alt or '')
if not groups[key] then groups[key] = {}; table.insert(order, key) end
if trim(r.role) == '' then groups[key].base = r
elseif trim(r.role) == role then groups[key].override = r end
end
local out = {}
for _, key in ipairs(order) do
local b, o = groups[key].base, groups[key].override
local blocked = o and trim(o.applicable):lower() == 'no'
if (b or o) and not blocked then
local m = {}
for _, k in ipairs({ 'sub_to', 'alt', 'ratio', 'conv', 'confidence', 'effect', 'warning' }) do
local ov = o and trim(o[k]) or ''
if ov ~= '' then m[k] = ov elseif b then m[k] = trim(b[k]) else m[k] = '' end
end
if m.warning == 'none' then m.warning = '' end
m.roleSpecific = o ~= nil
table.insert(out, m)
end
end
return out
end

-- ---------------------------------------------------------------- recipe

-- Ingredient lines are written one per line as: Ingredient; quantity; unit; role; preparation
local function parseLines(text)
local lines = {}
for raw in (text or ''):gmatch('[^\r\n]+') do
raw = trim(raw)
if raw ~= '' and not raw:match('^<!%-%-') then
local parts = mw.text.split(raw, ';', true)
local name = ingredientTitle(parts[1] or '')
if name ~= '' then
table.insert(lines, {
name = name,
qty = parseQty(parts[2] or ''),
unit = trim(parts[3] or ''),
role = trim(parts[4] or ''),
prep = trim(parts[5] or ''),
})
end
end
end
return lines
end

local function resolvedArg(args, preferred, legacy)
local value = trim(args[preferred])
if value ~= '' then return value end
return trim(args[legacy])
end

local CONF_DOTS = { high = '●●●', medium = '●●○', low = '●○○' }
local function confBadge(c)
c = trim(c):lower()
return '<span class="rp-conf rp-conf-' .. c .. '" title="confidence: ' .. c .. '">' .. (CONF_DOTS[c] or '○○○') .. ' ' .. c .. '</span>'
end

function p.recipe(frame)
local args = frame:getParent().args
local title = mw.title.getCurrentTitle()
local page = title.prefixedText
local serves = tonumber(args.serves) or 1
local description = resolvedArg(args, 'description', 'lede')
local instructions = resolvedArg(args, 'instructions', 'method')
local lines = parseLines(args.ingredients)

-- totals from the ingredient records
local kcalTotal, allergens, seen, missing = 0, {}, {}, {}
for _, l in ipairs(lines) do
local ing = getIngredient(l.name)
if ing then
kcalTotal = kcalTotal + kcalOf(ing, l.qty, l.unit)
for _, a in ipairs(splitList(ing.allergens)) do
if not seen[a] then seen[a] = true; table.insert(allergens, a) end
end
elseif not getRecipe(l.name) then
table.insert(missing, l.name)
end
end

local out = {}
local function add(s) table.insert(out, s) end

-- infobox
add('{| class="wikitable rp-infobox"\n|+ ' .. page)
add('|-\n! Serves\n| ' .. serves)
if trim(args.time) ~= '' then add('|-\n! Time\n| ' .. trim(args.time)) end
add('|-\n! Per serving\n| <b>' .. round(kcalTotal / serves) .. ' kcal</b> <small>(' .. round(kcalTotal) .. ' for the batch)</small>')
add('|-\n! Contains\n| ' .. (#allergens > 0 and table.concat(allergens, ', ') or "''nothing flagged''"))
if trim(args.contributor) ~= '' then add('|-\n! Contributed by\n| ' .. trim(args.contributor)) end
if trim(args.tags) ~= '' then
local tagLinks = {}
for _, t in ipairs(splitList(args.tags)) do table.insert(tagLinks, '[[:Category:' .. t .. '|' .. t .. ']]') end
add('|-\n! Tags\n| ' .. table.concat(tagLinks, ' · '))
end
add('|-\n| colspan="2" | <small>Calories are computed from the [[:Category:Ingredients|ingredient records]]. Approximate.</small>')
add('|}')

add('== Description ==')
if description ~= '' then add("<div class=\"rp-lede\">''" .. description .. "''</div>")
else add("''No description yet.''") end

if #missing > 0 then
-- Each name links to the ingredient form already targeted at that title, so
-- a contributor lands on the right form rather than being asked for a name
-- the page already knows. A bare Special:FormEdit link has no target and
-- answers "No target page specified".
local createLinks = {}
for _, name in ipairs(missing) do
table.insert(createLinks, ingredientFormLink(name, name))
end
add('<div class="rp-missing">These ingredients have no record yet, so they are left out of the nutrition and substitution tables: ' ..
table.concat(createLinks, ', ') .. '. Follow a name to create its record.</div>')
end

-- ingredients table
add('== Ingredients ==')
add('{| class="wikitable rp-ingredients"\n! Quantity !! Ingredient !! Its job here !! Swaps')
local swapSections = {}
for i, l in ipairs(lines) do
local ing = getIngredient(l.name)
local shown = countLabel(l.name, l.qty, l.unit)
local isRecipe = not ing and getRecipe(l.name)
local link = (ing or isRecipe) and ('[[' .. l.name .. '|' .. shown .. ']]') or
(ingredientFormLink(l.name, shown) .. '<sup class="rp-missing-mark">?</sup>')
local qty = fmtQty(l.qty) .. ' ' .. unitLabel(l.qty, l.unit)
local prep = l.prep ~= '' and (', <span class="rp-prep">' .. l.prep .. '</span>') or ''
local rules = ing and rulesFor(l.name, l.role) or {}
local swapCell = "''none''"
if #rules > 0 then
swapCell = '[[#Substitutions for this recipe|' .. #rules .. (#rules == 1 and ' option' or ' options') .. ']]'
table.insert(swapSections, { line = l, rules = rules })
end
add('|-\n| class="rp-qty" | ' .. trim(qty) .. '\n| ' .. link .. prep .. '\n| class="rp-role" | ' .. l.role .. '\n| ' .. swapCell)
end
add('|}')

add('== Instructions ==')
if instructions ~= '' then add(instructions)
else add("''No instructions yet.''") end

-- substitutions resolved for this recipe
if #swapSections > 0 then
add('== Substitutions for this recipe ==')
add('<p class="rp-note">Rules come from each ingredient\'s record and are resolved for the job the ingredient does in this recipe. Confidence is the community\'s, not a guarantee.</p>')
add('{| class="wikitable rp-subs"\n! Instead of !! Use !! How much !! What changes !! Confidence')
for _, s in ipairs(swapSections) do
for _, r in ipairs(s.rules) do
local useName = r.alt ~= '' and (r.alt .. ' ([[' .. r.sub_to .. ']])') or ('[[' .. r.sub_to .. ']]')
local howMuch
if r.conv ~= '' then howMuch = r.conv
else
local ratio = tonumber(r.ratio) or 1
local nq = s.line.qty and (s.line.qty * ratio) or nil
howMuch = nq and (fmtQty(nq) .. ' ' .. unitLabel(nq, s.line.unit) .. ' <small>(× ' .. ratio .. ')</small>') or ('× ' .. ratio)
end
local what = r.effect
if r.warning ~= '' then what = what .. '<br /><span class="rp-warn">⚠ ' .. r.warning .. '</span>' end
if r.roleSpecific then what = what .. ' <small class="rp-role-tag">rule for: ' .. s.line.role .. '</small>' end
add('|-\n| [[' .. s.line.name .. ']]\n| ' .. useName .. '\n| class="rp-qty" | ' .. howMuch .. '\n| ' .. what .. '\n| ' .. confBadge(r.confidence))
end
end
add('|}')
end

-- store rows (skipped when the page is being previewed inside another page)
if title.namespace == 0 then
for i, l in ipairs(lines) do
frame:callParserFunction('#cargo_store', {
'_table=RecipeIngredients', recipe = page, ingredient = l.name,
qty = l.qty and tostring(l.qty) or '', unit = l.unit, role = l.role, prep = l.prep, pos = tostring(i),
})
end
frame:callParserFunction('#cargo_store', {
'_table=Recipes', serves = tostring(serves), time = trim(args.time), tags = trim(args.tags),
contributor = trim(args.contributor), lede = description, method = instructions,
kcal_total = tostring(round(kcalTotal)), allergens = table.concat(allergens, ','), ingredient_count = tostring(#lines),
})
end

-- Categories belong to real recipe pages. Without this guard a /testcases
-- page that exercises the template would file itself under Category:Recipes
-- and every tag category it demonstrates.
if title.namespace == 0 then
local cats = { '[[Category:Recipes]]' }
for _, t in ipairs(splitList(args.tags)) do table.insert(cats, '[[Category:' .. t .. ']]') end
add(table.concat(cats, ''))
end
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- sale

function p.sale(frame)
local args = frame.args
local store = trim(args.store)
local where = store ~= '' and ("store='" .. sqlEsc(store) .. "'") or nil
local sale = cargo.query('SaleItems', 'ingredient,price,was,per,store', { where = where, limit = 200 })
if #sale == 0 then return "''No sale items have been entered yet. Add them with [[Template:SaleItem]].''" end
local onSale = {}
for _, s in ipairs(sale) do onSale[s.ingredient] = s end

local rows = cargo.query('RecipeIngredients=RI,Ingredients=I', 'RI.recipe=recipe,RI.ingredient=ingredient,I.pantry=pantry',
{ join = 'RI.ingredient=I._pageName', limit = 2000 })
local recipes, order = {}, {}
for _, r in ipairs(rows) do
if not recipes[r.recipe] then recipes[r.recipe] = { hits = {}, toBuy = 0, save = 0 }; table.insert(order, r.recipe) end
local rec = recipes[r.recipe]
local pantry = trim(r.pantry):lower() == 'yes'
if not pantry then
rec.toBuy = rec.toBuy + 1
local s = onSale[r.ingredient]
if s then
table.insert(rec.hits, r.ingredient)
rec.save = rec.save + ((tonumber(s.was) or 0) - (tonumber(s.price) or 0))
end
end
end
local ranked = {}
for _, name in ipairs(order) do
local rec = recipes[name]
if #rec.hits > 0 then rec.name = name; table.insert(ranked, rec) end
end
table.sort(ranked, function(a, b)
if #a.hits ~= #b.hits then return #a.hits > #b.hits end
return (#a.hits / math.max(1, a.toBuy)) > (#b.hits / math.max(1, b.toBuy))
end)

local out = { '{| class="wikitable rp-sale"\n! Recipe !! On sale !! Shopping list !! You save' }
for _, rec in ipairs(ranked) do
local links = {}
for _, h in ipairs(rec.hits) do table.insert(links, '[[' .. h .. ']]') end
table.insert(out, '|-\n| [[' .. rec.name .. ']]\n| ' .. table.concat(links, ', ') .. '\n| ' .. #rec.hits .. ' of ' .. rec.toBuy ..
' items <small>(pantry staples excluded)</small>\n| class="rp-qty" | $' .. string.format('%.2f', rec.save))
end
table.insert(out, '|}')
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- cookbook

local function chapterFor(tags)
local t = {}
for _, x in ipairs(splitList(tags)) do t[x:lower()] = true end
if t['breakfast'] then return 'Mornings' end
if t['dessert'] then return 'Sweets' end
if t['dinner'] or t['side'] or t['soup'] then return 'Suppers and sides' end
return 'Pantry and dressings'
end

function p.cookbook(frame)
local args = frame:getParent().args
local names = splitList(args.recipes)
local title = trim(args.title) ~= '' and trim(args.title) or 'Our kitchen'
local out = {}
local function add(s) table.insert(out, s) end

add('<div class="rp-book">')
add('<div class="rp-page rp-cover"><div class="rp-orn">✦</div><div class="rp-cover-title">' .. title .. '</div><div class="rp-cover-sub">' ..
#names .. (#names == 1 and ' recipe' or ' recipes') .. ' · assembled on Recipedius</div></div>')
if trim(args.dedication) ~= '' then
add('<div class="rp-page rp-dedication">' .. trim(args.dedication) .. '</div>')
end

-- gather
local recs, chapters, chapterOrder = {}, {}, {}
for _, n in ipairs(names) do
local r = cargo.query('Recipes', '_pageName=name,serves,time,tags,contributor,lede,method',
{ where = "_pageName='" .. sqlEsc(n) .. "'", limit = 1 })[1]
if r then
r.lines = cargo.query('RecipeIngredients', 'ingredient,qty,unit,prep,pos',
{ where = "recipe='" .. sqlEsc(n) .. "'", orderBy = 'pos', limit = 100 })
local ch = chapterFor(r.tags)
if not chapters[ch] then chapters[ch] = {}; table.insert(chapterOrder, ch) end
table.insert(chapters[ch], r)
else
add('<div class="rp-missing">No recipe page called "' .. n .. '" was found.</div>')
end
end

-- contents
add('<div class="rp-page rp-toc"><div class="rp-chap-label">Contents</div>')
for _, ch in ipairs(chapterOrder) do
add('<div class="rp-toc-chapter">' .. ch .. '</div>')
for _, r in ipairs(chapters[ch]) do add('<div class="rp-toc-row"><span>' .. r.name .. '</span><span>' .. r.time .. '</span></div>') end
end
add('</div>')

for _, ch in ipairs(chapterOrder) do
add('<div class="rp-page rp-chapter"><div class="rp-chap-label">Chapter</div><div class="rp-chapter-title">' .. ch .. '</div></div>')
for _, r in ipairs(chapters[ch]) do
add('<div class="rp-page rp-recipe-page"><div class="rp-chap-label">' .. ch .. '</div><div class="rp-recipe-title">' .. r.name .. '</div>')
if trim(r.lede) ~= '' then add("<div class=\"rp-lede\">''" .. r.lede .. "''</div>") end
add('<div class="rp-book-cols"><div class="rp-book-ings">')
for _, l in ipairs(r.lines) do
local q = tonumber(l.qty)
add('<div class="rp-book-ing"><span class="rp-qty">' .. fmtQty(q) .. ' ' .. unitLabel(q, l.unit) .. '</span><span>' .. countLabel(l.ingredient, q, l.unit) ..
(trim(l.prep) ~= '' and (', ' .. l.prep) or '') .. '</span></div>')
end
add('</div><div class="rp-book-method">\n' .. (r.method or '') .. '\n</div></div>')
add('<div class="rp-book-foot">Serves ' .. r.serves .. ' · ' .. r.time .. (trim(r.contributor) ~= '' and (' · contributed by ' .. r.contributor) or '') .. '</div></div>')
end
end
add('</div>')
return table.concat(out, '\n')
end

return p

Module:Recipedius

2026-09-25T14:04:05Z

Recipedius deploy: 0.015 T013: target missing ingredients and canonicalize fractions (1b80afc)

--[[
Module:Recipedius
The computed layer of Recipedius. Reads ingredient records and substitution rules
from Cargo tables and renders recipe pages, the weekly sale ranking, and cookbooks.

Entry points (all via {{#invoke:Recipedius|fn}} from templates):
recipe - renders a recipe from Template:Recipe args and stores its rows
sale - ranks recipes by how many of their shopping items are on sale
cookbook - renders a printable book from a list of recipe pages
]]

local p = {}
local cargo = mw.ext.cargo

-- ---------------------------------------------------------------- helpers

local FRACTIONS = {
{ 0.125, '1/8' }, { 0.25, '1/4' }, { 1/3, '1/3' }, { 0.375, '3/8' }, { 0.5, '1/2' },
{ 0.625, '5/8' }, { 2/3, '2/3' }, { 0.75, '3/4' }, { 0.875, '7/8' },
}
local FRACTION_CHARS = { ['⅛']=0.125, ['¼']=0.25, ['⅓']=1/3, ['⅜']=0.375, ['½']=0.5, ['⅝']=0.625, ['⅔']=2/3, ['¾']=0.75, ['⅞']=0.875 }

local function trim(s) return mw.text.trim(s or '') end

-- AI-assisted recipe imports persist ingredient titles as ordinary wiki links
-- so the form value itself remains navigable. Keep the existing plain-title
-- format compatible, while resolving that narrow importer-owned syntax before
-- data lookup, Cargo storage, pluralization, and generated display links.
local function ingredientTitle(s)
s = trim(s)
local linked = s:match('^%[%[([^%[%]|]+)%]%]$')
return linked and trim(linked) or s
end

-- A missing ingredient must open its pre-targeted Page Forms editor, not
-- MediaWiki's generic raw editor. mw.title normalizes and encodes the target.
local function ingredientFormLink(name, label)
local target = mw.title.new('Special:FormEdit/Ingredient/' .. name)
if not target then return mw.text.nowiki(label) end
return '[' .. target:fullUrl() .. ' ' .. mw.text.nowiki(label) .. ']'
end

-- "1 1/2", "3/4", "0.5", "1 ½" and "¾" all parse.
local function parseQty(s)
s = trim(s)
local total, found = 0, false
for tok in s:gmatch('%S+') do
if FRACTION_CHARS[tok] then total = total + FRACTION_CHARS[tok]; found = true
else
local a, b = tok:match('^(%d+)/(%d+)$')
if a then total = total + tonumber(a) / tonumber(b); found = true
elseif tonumber(tok) then total = total + tonumber(tok); found = true end
end
end
if found then return total end
return nil
end

local function fmtQty(q)
if not q then return '' end
local w = math.floor(q + 1e-6)
local f = q - w
if f > 0.94 then w = w + 1; f = 0 end
local fs = ''
if f > 0.06 then
local best, bd = nil, 1
for _, pair in ipairs(FRACTIONS) do
local d = math.abs(pair[1] - f)
if d < bd then bd = d; best = pair[2] end
end
if bd < 0.06 then fs = best else fs = string.format('%.2f', f):gsub('^0', '') end
end
if w == 0 then return fs ~= '' and fs or '0' end
if fs ~= '' then return w .. ' ' .. fs end
return tostring(w)
end

local PLURALS = { ['Garlic'] = 'Garlic cloves', ['Whole chicken'] = 'Whole chickens', ['Russet potato'] = 'Russet potatoes' }
-- Display name for a count-based ingredient: "2 eggs", "3 bananas", "6 garlic cloves".
local function countLabel(name, q, u)
if u ~= 'each' or not q or q <= 1 then return name end
if PLURALS[name] then return PLURALS[name] end
if name:sub(-1) == 's' then return name end
return name .. 's'
end

local function unitLabel(q, u)
if u == 'each' or u == '' then return '' end
if u == 'cup' and q and q > 1 then return 'cups' end
return u
end

local function sqlEsc(s) return (tostring(s):gsub("'", "\\'")) end

local function splitList(s)
local out = {}
for item in (s or ''):gmatch('[^,]+') do
item = trim(item)
if item ~= '' then table.insert(out, item) end
end
return out
end

local function round(x) return math.floor(x + 0.5) end

-- ---------------------------------------------------------------- data access

local ingredientCache = {}
local function getIngredient(name)
if ingredientCache[name] ~= nil then return ingredientCache[name] or nil end
local rows = cargo.query('Ingredients',
'_pageName=name,kcal100,g_tsp,g_tbsp,g_cup,g_each,allergens,pantry,price,price_per',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
ingredientCache[name] = rows[1] or false
return rows[1]
end

local recipeCache = {}
local function getRecipe(name)
if recipeCache[name] ~= nil then return recipeCache[name] or nil end
local rows = cargo.query('Recipes', '_pageName=name',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
recipeCache[name] = rows[1] or false
return rows[1]
end

local function gramsPer(ing, unit)
if not ing then return nil end
local key = ({ tsp = 'g_tsp', tbsp = 'g_tbsp', cup = 'g_cup', each = 'g_each' })[unit]
if not key then return nil end
return tonumber(ing[key])
end

local function kcalOf(ing, q, unit)
local g = gramsPer(ing, unit)
local k = ing and tonumber(ing.kcal100)
if not (g and k and q) then return 0 end
return q * g * k / 100
end

-- Substitution rules for an ingredient, resolved for the role it plays in this recipe.
-- A base row (role blank) applies everywhere; a row with a role overrides the base for that role.
-- An override with applicable=no removes the option for that role.
local subsCache = {}
local function rulesFor(name, role)
if not subsCache[name] then
subsCache[name] = cargo.query('Substitutions',
'sub_to,alt,role,ratio,conv,confidence,effect,warning,applicable',
{ where = "sub_from='" .. sqlEsc(name) .. "'", orderBy = 'sub_to', limit = 200 })
end
local groups, order = {}, {}
for _, r in ipairs(subsCache[name]) do
local key = (r.sub_to or '') .. '|' .. (r.alt or '')
if not groups[key] then groups[key] = {}; table.insert(order, key) end
if trim(r.role) == '' then groups[key].base = r
elseif trim(r.role) == role then groups[key].override = r end
end
local out = {}
for _, key in ipairs(order) do
local b, o = groups[key].base, groups[key].override
local blocked = o and trim(o.applicable):lower() == 'no'
if (b or o) and not blocked then
local m = {}
for _, k in ipairs({ 'sub_to', 'alt', 'ratio', 'conv', 'confidence', 'effect', 'warning' }) do
local ov = o and trim(o[k]) or ''
if ov ~= '' then m[k] = ov elseif b then m[k] = trim(b[k]) else m[k] = '' end
end
if m.warning == 'none' then m.warning = '' end
m.roleSpecific = o ~= nil
table.insert(out, m)
end
end
return out
end

-- ---------------------------------------------------------------- recipe

-- Ingredient lines are written one per line as: Ingredient; quantity; unit; role; preparation
local function parseLines(text)
local lines = {}
for raw in (text or ''):gmatch('[^\r\n]+') do
raw = trim(raw)
if raw ~= '' and not raw:match('^<!%-%-') then
local parts = mw.text.split(raw, ';', true)
local name = ingredientTitle(parts[1] or '')
if name ~= '' then
table.insert(lines, {
name = name,
qty = parseQty(parts[2] or ''),
unit = trim(parts[3] or ''),
role = trim(parts[4] or ''),
prep = trim(parts[5] or ''),
})
end
end
end
return lines
end

local function resolvedArg(args, preferred, legacy)
local value = trim(args[preferred])
if value ~= '' then return value end
return trim(args[legacy])
end

local CONF_DOTS = { high = '●●●', medium = '●●○', low = '●○○' }
local function confBadge(c)
c = trim(c):lower()
return '<span class="rp-conf rp-conf-' .. c .. '" title="confidence: ' .. c .. '">' .. (CONF_DOTS[c] or '○○○') .. ' ' .. c .. '</span>'
end

function p.recipe(frame)
local args = frame:getParent().args
local title = mw.title.getCurrentTitle()
local page = title.prefixedText
local serves = tonumber(args.serves) or 1
local description = resolvedArg(args, 'description', 'lede')
local instructions = resolvedArg(args, 'instructions', 'method')
local lines = parseLines(args.ingredients)

-- totals from the ingredient records
local kcalTotal, allergens, seen, missing = 0, {}, {}, {}
for _, l in ipairs(lines) do
local ing = getIngredient(l.name)
if ing then
kcalTotal = kcalTotal + kcalOf(ing, l.qty, l.unit)
for _, a in ipairs(splitList(ing.allergens)) do
if not seen[a] then seen[a] = true; table.insert(allergens, a) end
end
elseif not getRecipe(l.name) then
table.insert(missing, l.name)
end
end

local out = {}
local function add(s) table.insert(out, s) end

-- infobox
add('{| class="wikitable rp-infobox"\n|+ ' .. page)
add('|-\n! Serves\n| ' .. serves)
if trim(args.time) ~= '' then add('|-\n! Time\n| ' .. trim(args.time)) end
add('|-\n! Per serving\n| <b>' .. round(kcalTotal / serves) .. ' kcal</b> <small>(' .. round(kcalTotal) .. ' for the batch)</small>')
add('|-\n! Contains\n| ' .. (#allergens > 0 and table.concat(allergens, ', ') or "''nothing flagged''"))
if trim(args.contributor) ~= '' then add('|-\n! Contributed by\n| ' .. trim(args.contributor)) end
if trim(args.tags) ~= '' then
local tagLinks = {}
for _, t in ipairs(splitList(args.tags)) do table.insert(tagLinks, '[[:Category:' .. t .. '|' .. t .. ']]') end
add('|-\n! Tags\n| ' .. table.concat(tagLinks, ' · '))
end
add('|-\n| colspan="2" | <small>Calories are computed from the [[:Category:Ingredients|ingredient records]]. Approximate.</small>')
add('|}')

add('== Description ==')
if description ~= '' then add("<div class=\"rp-lede\">''" .. description .. "''</div>")
else add("''No description yet.''") end

if #missing > 0 then
-- Each name links to the ingredient form already targeted at that title, so
-- a contributor lands on the right form rather than being asked for a name
-- the page already knows. A bare Special:FormEdit link has no target and
-- answers "No target page specified".
local createLinks = {}
for _, name in ipairs(missing) do
table.insert(createLinks, ingredientFormLink(name, name))
end
add('<div class="rp-missing">These ingredients have no record yet, so they are left out of the nutrition and substitution tables: ' ..
table.concat(createLinks, ', ') .. '. Follow a name to create its record.</div>')
end

-- ingredients table
add('== Ingredients ==')
add('{| class="wikitable rp-ingredients"\n! Quantity !! Ingredient !! Its job here !! Swaps')
local swapSections = {}
for i, l in ipairs(lines) do
local ing = getIngredient(l.name)
local shown = countLabel(l.name, l.qty, l.unit)
local isRecipe = not ing and getRecipe(l.name)
local link = (ing or isRecipe) and ('[[' .. l.name .. '|' .. shown .. ']]') or
(ingredientFormLink(l.name, shown) .. '<sup class="rp-missing-mark">?</sup>')
local qty = fmtQty(l.qty) .. ' ' .. unitLabel(l.qty, l.unit)
local prep = l.prep ~= '' and (', <span class="rp-prep">' .. l.prep .. '</span>') or ''
local rules = ing and rulesFor(l.name, l.role) or {}
local swapCell = "''none''"
if #rules > 0 then
swapCell = '[[#Substitutions for this recipe|' .. #rules .. (#rules == 1 and ' option' or ' options') .. ']]'
table.insert(swapSections, { line = l, rules = rules })
end
add('|-\n| class="rp-qty" | ' .. trim(qty) .. '\n| ' .. link .. prep .. '\n| class="rp-role" | ' .. l.role .. '\n| ' .. swapCell)
end
add('|}')

add('== Instructions ==')
if instructions ~= '' then add(instructions)
else add("''No instructions yet.''") end

-- substitutions resolved for this recipe
if #swapSections > 0 then
add('== Substitutions for this recipe ==')
add('<p class="rp-note">Rules come from each ingredient\'s record and are resolved for the job the ingredient does in this recipe. Confidence is the community\'s, not a guarantee.</p>')
add('{| class="wikitable rp-subs"\n! Instead of !! Use !! How much !! What changes !! Confidence')
for _, s in ipairs(swapSections) do
for _, r in ipairs(s.rules) do
local useName = r.alt ~= '' and (r.alt .. ' ([[' .. r.sub_to .. ']])') or ('[[' .. r.sub_to .. ']]')
local howMuch
if r.conv ~= '' then howMuch = r.conv
else
local ratio = tonumber(r.ratio) or 1
local nq = s.line.qty and (s.line.qty * ratio) or nil
howMuch = nq and (fmtQty(nq) .. ' ' .. unitLabel(nq, s.line.unit) .. ' <small>(× ' .. ratio .. ')</small>') or ('× ' .. ratio)
end
local what = r.effect
if r.warning ~= '' then what = what .. '<br /><span class="rp-warn">⚠ ' .. r.warning .. '</span>' end
if r.roleSpecific then what = what .. ' <small class="rp-role-tag">rule for: ' .. s.line.role .. '</small>' end
add('|-\n| [[' .. s.line.name .. ']]\n| ' .. useName .. '\n| class="rp-qty" | ' .. howMuch .. '\n| ' .. what .. '\n| ' .. confBadge(r.confidence))
end
end
add('|}')
end

-- store rows (skipped when the page is being previewed inside another page)
if title.namespace == 0 then
for i, l in ipairs(lines) do
frame:callParserFunction('#cargo_store', {
'_table=RecipeIngredients', recipe = page, ingredient = l.name,
qty = l.qty and tostring(l.qty) or '', unit = l.unit, role = l.role, prep = l.prep, pos = tostring(i),
})
end
frame:callParserFunction('#cargo_store', {
'_table=Recipes', serves = tostring(serves), time = trim(args.time), tags = trim(args.tags),
contributor = trim(args.contributor), lede = description, method = instructions,
kcal_total = tostring(round(kcalTotal)), allergens = table.concat(allergens, ','), ingredient_count = tostring(#lines),
})
end

-- Categories belong to real recipe pages. Without this guard a /testcases
-- page that exercises the template would file itself under Category:Recipes
-- and every tag category it demonstrates.
if title.namespace == 0 then
local cats = { '[[Category:Recipes]]' }
for _, t in ipairs(splitList(args.tags)) do table.insert(cats, '[[Category:' .. t .. ']]') end
add(table.concat(cats, ''))
end
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- sale

function p.sale(frame)
local args = frame.args
local store = trim(args.store)
local where = store ~= '' and ("store='" .. sqlEsc(store) .. "'") or nil
local sale = cargo.query('SaleItems', 'ingredient,price,was,per,store', { where = where, limit = 200 })
if #sale == 0 then return "''No sale items have been entered yet. Add them with [[Template:SaleItem]].''" end
local onSale = {}
for _, s in ipairs(sale) do onSale[s.ingredient] = s end

local rows = cargo.query('RecipeIngredients=RI,Ingredients=I', 'RI.recipe=recipe,RI.ingredient=ingredient,I.pantry=pantry',
{ join = 'RI.ingredient=I._pageName', limit = 2000 })
local recipes, order = {}, {}
for _, r in ipairs(rows) do
if not recipes[r.recipe] then recipes[r.recipe] = { hits = {}, toBuy = 0, save = 0 }; table.insert(order, r.recipe) end
local rec = recipes[r.recipe]
local pantry = trim(r.pantry):lower() == 'yes'
if not pantry then
rec.toBuy = rec.toBuy + 1
local s = onSale[r.ingredient]
if s then
table.insert(rec.hits, r.ingredient)
rec.save = rec.save + ((tonumber(s.was) or 0) - (tonumber(s.price) or 0))
end
end
end
local ranked = {}
for _, name in ipairs(order) do
local rec = recipes[name]
if #rec.hits > 0 then rec.name = name; table.insert(ranked, rec) end
end
table.sort(ranked, function(a, b)
if #a.hits ~= #b.hits then return #a.hits > #b.hits end
return (#a.hits / math.max(1, a.toBuy)) > (#b.hits / math.max(1, b.toBuy))
end)

local out = { '{| class="wikitable rp-sale"\n! Recipe !! On sale !! Shopping list !! You save' }
for _, rec in ipairs(ranked) do
local links = {}
for _, h in ipairs(rec.hits) do table.insert(links, '[[' .. h .. ']]') end
table.insert(out, '|-\n| [[' .. rec.name .. ']]\n| ' .. table.concat(links, ', ') .. '\n| ' .. #rec.hits .. ' of ' .. rec.toBuy ..
' items <small>(pantry staples excluded)</small>\n| class="rp-qty" | $' .. string.format('%.2f', rec.save))
end
table.insert(out, '|}')
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- cookbook

local function chapterFor(tags)
local t = {}
for _, x in ipairs(splitList(tags)) do t[x:lower()] = true end
if t['breakfast'] then return 'Mornings' end
if t['dessert'] then return 'Sweets' end
if t['dinner'] or t['side'] or t['soup'] then return 'Suppers and sides' end
return 'Pantry and dressings'
end

function p.cookbook(frame)
local args = frame:getParent().args
local names = splitList(args.recipes)
local title = trim(args.title) ~= '' and trim(args.title) or 'Our kitchen'
local out = {}
local function add(s) table.insert(out, s) end

add('<div class="rp-book">')
add('<div class="rp-page rp-cover"><div class="rp-orn">✦</div><div class="rp-cover-title">' .. title .. '</div><div class="rp-cover-sub">' ..
#names .. (#names == 1 and ' recipe' or ' recipes') .. ' · assembled on Recipedius</div></div>')
if trim(args.dedication) ~= '' then
add('<div class="rp-page rp-dedication">' .. trim(args.dedication) .. '</div>')
end

-- gather
local recs, chapters, chapterOrder = {}, {}, {}
for _, n in ipairs(names) do
local r = cargo.query('Recipes', '_pageName=name,serves,time,tags,contributor,lede,method',
{ where = "_pageName='" .. sqlEsc(n) .. "'", limit = 1 })[1]
if r then
r.lines = cargo.query('RecipeIngredients', 'ingredient,qty,unit,prep,pos',
{ where = "recipe='" .. sqlEsc(n) .. "'", orderBy = 'pos', limit = 100 })
local ch = chapterFor(r.tags)
if not chapters[ch] then chapters[ch] = {}; table.insert(chapterOrder, ch) end
table.insert(chapters[ch], r)
else
add('<div class="rp-missing">No recipe page called "' .. n .. '" was found.</div>')
end
end

-- contents
add('<div class="rp-page rp-toc"><div class="rp-chap-label">Contents</div>')
for _, ch in ipairs(chapterOrder) do
add('<div class="rp-toc-chapter">' .. ch .. '</div>')
for _, r in ipairs(chapters[ch]) do add('<div class="rp-toc-row"><span>' .. r.name .. '</span><span>' .. r.time .. '</span></div>') end
end
add('</div>')

for _, ch in ipairs(chapterOrder) do
add('<div class="rp-page rp-chapter"><div class="rp-chap-label">Chapter</div><div class="rp-chapter-title">' .. ch .. '</div></div>')
for _, r in ipairs(chapters[ch]) do
add('<div class="rp-page rp-recipe-page"><div class="rp-chap-label">' .. ch .. '</div><div class="rp-recipe-title">' .. r.name .. '</div>')
if trim(r.lede) ~= '' then add("<div class=\"rp-lede\">''" .. r.lede .. "''</div>") end
add('<div class="rp-book-cols"><div class="rp-book-ings">')
for _, l in ipairs(r.lines) do
local q = tonumber(l.qty)
add('<div class="rp-book-ing"><span class="rp-qty">' .. fmtQty(q) .. ' ' .. unitLabel(q, l.unit) .. '</span><span>' .. countLabel(l.ingredient, q, l.unit) ..
(trim(l.prep) ~= '' and (', ' .. l.prep) or '') .. '</span></div>')
end
add('</div><div class="rp-book-method">\n' .. (r.method or '') .. '\n</div></div>')
add('<div class="rp-book-foot">Serves ' .. r.serves .. ' · ' .. r.time .. (trim(r.contributor) ~= '' and (' · contributed by ' .. r.contributor) or '') .. '</div></div>')
end
end
add('</div>')
return table.concat(out, '\n')
end

return p

Form:Recipe

2026-09-25T12:55:49Z

Recipedius deploy: 0.014 T014: deploy AI-assisted Recipe import (e0496d8)

<noinclude>
This is the form for creating a recipe. Enter a title below.
{{#forminput:form=Recipe|autocomplete on category=Recipes}}
</noinclude><includeonly>
<div id="rp-ai-recipe-import" class="rp-ai-import">
'''Create a draft with AI (optional)'''

Copy prompt, use ChatGPT, Claude, Gemini, or DeepSeek, then paste the returned JSON here. AI-assisted import needs JavaScript; you can still complete every field manually below.
</div>
{{{for template|Recipe}}}
{| class="formtable"
! Serves:
| {{{field|serves|input type=text|size=4}}}
|-
! Time:
| {{{field|time|size=20|placeholder=50 min}}}
|-
! Tags (comma-separated):
| {{{field|tags|size=40|placeholder=dessert, baking, cookie}}}
|-
! Contributed by:
| {{{field|contributor|size=30}}}
|-
! Description:
| {{{field|lede|input type=textarea|rows=2|cols=70}}}
|-
! Ingredients:<br /><small>One per line: Ingredient; quantity; unit; role; preparation<br />e.g. Butter; 1; cup; creaming; softened</small>
| {{{field|ingredients|input type=textarea|rows=10|cols=70}}}
|-
! Instructions:<br /><small>Numbered steps, one per line, starting with #</small>
| {{{field|method|input type=textarea|rows=10|cols=70}}}
|}
{{{end template}}}
'''Edit summary:''' {{{standard input|summary}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|cancel}}}
</includeonly>

MediaWiki:Common.js

2026-09-25T12:55:48Z

Recipedius deploy: 0.014 T014: deploy AI-assisted Recipe import (e0496d8)

/* AI-assisted Ingredient draft import. Runs only on Form:Ingredient. */
(function ($, mw) {
'use strict';

$(function () {
var panel = document.getElementById('rp-ai-ingredient-import');
if (!panel) return;

var fields = {
form: 'Ingredient[form]',
role: 'Ingredient[role]',
storage: 'Ingredient[storage]',
season: 'Ingredient[season]',
kcal100: 'Ingredient[kcal100]',
g_tsp: 'Ingredient[g_tsp]',
g_tbsp: 'Ingredient[g_tbsp]',
g_cup: 'Ingredient[g_cup]',
g_each: 'Ingredient[g_each]',
allergens: 'Ingredient[allergens]',
pantry: 'Ingredient[pantry]',
price: 'Ingredient[price]',
price_per: 'Ingredient[price_per]',
summary: 'Ingredient[summary]'
};
var requiredStrings = ['name', 'form', 'role', 'storage', 'season', 'summary'];
var optionalNumbers = ['g_tsp', 'g_tbsp', 'g_cup', 'g_each', 'price'];
var allKeys = requiredStrings.concat(['kcal100'], optionalNumbers, ['allergens', 'pantry', 'price_per']);
// FormEdit is a Special page, so wgPageName is the Special-page route.
// Page Forms exposes the actual selected edit target separately.
var expectedTitle = String(mw.config.get('wgPageFormsTargetName') || '').replace(/_/g, ' ');
if (!expectedTitle) return;
// The wikitext fallback is useful without JavaScript and to rendered-page
// checks. Replace it only after the enhanced controls can be created.
panel.textContent = '';

function addTextElement(tag, text) {
var element = document.createElement(tag);
element.textContent = text;
panel.appendChild(element);
return element;
}

function addProviderLink(provider, url) {
var link = document.createElement('a');
link.href = url;
link.target = '_blank';
link.rel = 'noopener';
link.setAttribute('data-rp-ai-provider', provider);
link.textContent = provider;
return link;
}

var title = addTextElement('strong', 'Create a draft with AI (optional)');
title.className = 'rp-ai-heading';
addTextElement('p', 'AI output is a draft. Verify nutrition, allergens, weights, and price against a reliable source before saving.');
var actions = document.createElement('p');
var copyButton = document.createElement('button');
copyButton.type = 'button';
copyButton.id = 'rp-ai-copy-prompt';
copyButton.textContent = 'Copy prompt';
actions.appendChild(copyButton);
actions.appendChild(document.createTextNode(' '));
[
['ChatGPT', 'https://chatgpt.com/'],
['Claude', 'https://claude.ai/new'],
['Gemini', 'https://gemini.google.com/app'],
['DeepSeek', 'https://chat.deepseek.com/']
].forEach(function (provider, index) {
if (index) actions.appendChild(document.createTextNode(' · '));
actions.appendChild(addProviderLink(provider[0], provider[1]));
});
panel.appendChild(actions);
var importLabel = document.createElement('label');
importLabel.htmlFor = 'rp-ai-ingredient-json';
importLabel.textContent = 'Paste the returned JSON';
var importArea = document.createElement('textarea');
importArea.id = 'rp-ai-ingredient-json';
importArea.rows = 12;
importArea.cols = 70;
importArea.spellcheck = false;
importArea.placeholder = '{"name":"This page title", ...}';
var importControl = document.createElement('p');
importControl.appendChild(importLabel);
importControl.appendChild(document.createElement('br'));
importControl.appendChild(importArea);
panel.appendChild(importControl);
var importButton = document.createElement('button');
importButton.type = 'button';
importButton.id = 'rp-ai-import-json';
importButton.textContent = 'Import draft into this form';
var importAction = document.createElement('p');
importAction.appendChild(importButton);
panel.appendChild(importAction);
var status = document.createElement('div');
status.id = 'rp-ai-ingredient-status';
status.className = 'rp-ai-status';
status.setAttribute('role', 'status');
status.setAttribute('aria-live', 'polite');
panel.appendChild(status);
var input = importArea;

function setStatus(message, isError) {
status.textContent = message;
status.className = isError ? 'rp-ai-status rp-ai-status-error' : 'rp-ai-status rp-ai-status-success';
}

function promptFor(title) {
return 'Create a draft Recipedius ingredient record for "' + title + '". ' +
'Return only one JSON object with exactly these keys: ' +
'name, form, role, storage, season, kcal100, g_tsp, g_tbsp, g_cup, g_each, allergens, pantry, price, price_per, summary. ' +
'Use this title exactly as name. form, role, storage, season, and summary must be strings. ' +
'kcal100 must be a non-negative number. g_tsp, g_tbsp, g_cup, g_each, and price must be non-negative numbers or null. ' +
'price_per must be a string or null. allergens must be an array of strings. pantry must be true or false. ' +
'Use null when a unit weight or typical price is unknown; do not invent values. ' +
'Nutrition, allergens, weights, and price are a draft for the contributor to verify against a reliable source before saving.';
}

function copyText(text) {
if (navigator.clipboard && navigator.clipboard.writeText) {
return navigator.clipboard.writeText(text);
}
var temporary = document.createElement('textarea');
temporary.value = text;
temporary.setAttribute('readonly', '');
temporary.style.position = 'fixed';
temporary.style.opacity = '0';
document.body.appendChild(temporary);
temporary.select();
var copied = document.execCommand('copy');
document.body.removeChild(temporary);
return copied ? Promise.resolve() : Promise.reject(new Error('Clipboard unavailable'));
}

function copyPrompt() {
return copyText(promptFor(expectedTitle)).then(function () {
setStatus('Prompt copied. Review the AI draft before importing it.', false);
}).catch(function () {
setStatus('Your browser did not allow copying. Select and copy the prompt shown below.', true);
});
}

function hasOwn(object, key) {
return Object.prototype.hasOwnProperty.call(object, key);
}

function validString(value) {
return typeof value === 'string' && value.trim() !== '';
}

function validNumber(value) {
return typeof value === 'number' && Number.isFinite(value) && value >= 0;
}

function validate(record) {
var i;
if (!record || Array.isArray(record) || typeof record !== 'object') return 'The draft must be one JSON object.';
for (i = 0; i < Object.keys(record).length; i++) {
if (allKeys.indexOf(Object.keys(record)[i]) === -1) return 'Unknown property: ' + Object.keys(record)[i] + '.';
}
for (i = 0; i < allKeys.length; i++) {
if (!hasOwn(record, allKeys[i])) return 'Missing property: ' + allKeys[i] + '.';
}
for (i = 0; i < requiredStrings.length; i++) {
if (!validString(record[requiredStrings[i]])) return requiredStrings[i] + ' must be a non-empty string.';
}
if (record.name !== expectedTitle) return 'The JSON name must exactly match this page title: ' + expectedTitle + '.';
if (!validNumber(record.kcal100)) return 'kcal100 must be a non-negative number.';
for (i = 0; i < optionalNumbers.length; i++) {
if (record[optionalNumbers[i]] !== null && !validNumber(record[optionalNumbers[i]])) {
return optionalNumbers[i] + ' must be a non-negative number or null.';
}
}
if (!Array.isArray(record.allergens) || !record.allergens.every(validString)) return 'allergens must be an array of non-empty strings.';
if (typeof record.pantry !== 'boolean') return 'pantry must be true or false.';
if (record.price_per !== null && !validString(record.price_per)) return 'price_per must be a non-empty string or null.';
return null;
}

function setField(key, value) {
var control = document.querySelector('[name="' + fields[key] + '"]');
if (!control) throw new Error('The Ingredient form is missing the ' + key + ' field.');
control.value = value === null ? '' : String(value);
}

copyButton.addEventListener('click', copyPrompt);
Array.prototype.forEach.call(panel.querySelectorAll('[data-rp-ai-provider]'), function (link) {
link.addEventListener('click', copyPrompt);
});
importButton.addEventListener('click', function () {
var record;
try {
record = JSON.parse(input.value);
} catch (error) {
setStatus('Invalid JSON: ' + error.message, true);
return;
}
var problem = validate(record);
if (problem) {
setStatus(problem, true);
return;
}
try {
Object.keys(fields).forEach(function (key) {
var value = record[key];
if (key === 'allergens') value = value.join(', ');
if (key === 'pantry') value = value ? 'yes' : 'no';
setField(key, value);
});
} catch (error) {
setStatus(error.message, true);
return;
}
setStatus('Draft imported. Review every field, then use the normal Save button to create ' + expectedTitle + '.', false);
});
});
}(jQuery, mediaWiki));

/* AI-assisted Recipe draft import. Runs only on Form:Recipe. */
(function ($, mw) {
'use strict';

$(function () {
var panel = document.getElementById('rp-ai-recipe-import');
if (!panel) return;

var fields = {
serves: 'Recipe[serves]',
time: 'Recipe[time]',
tags: 'Recipe[tags]',
contributor: 'Recipe[contributor]',
lede: 'Recipe[lede]',
ingredients: 'Recipe[ingredients]',
instructions: 'Recipe[method]'
};
var requiredKeys = ['name', 'serves', 'time', 'tags', 'lede', 'ingredients', 'instructions'];
var allKeys = requiredKeys.concat(['contributor']);
var expectedTitle = String(mw.config.get('wgPageFormsTargetName') || '').replace(/_/g, ' ');
if (!expectedTitle) return;
panel.textContent = '';

function addTextElement(tag, text) {
var element = document.createElement(tag);
element.textContent = text;
panel.appendChild(element);
return element;
}

function addProviderLink(provider, url) {
var link = document.createElement('a');
link.href = url;
link.target = '_blank';
link.rel = 'noopener';
link.setAttribute('data-rp-ai-provider', provider);
link.textContent = provider;
return link;
}

var title = addTextElement('strong', 'Create a recipe draft with AI (optional)');
title.className = 'rp-ai-heading';
addTextElement('p', 'AI output is a draft. Verify quantities, timings, allergens, and food-safety guidance before saving. Imported ingredient names become internal links.');
var actions = document.createElement('p');
var copyButton = document.createElement('button');
copyButton.type = 'button';
copyButton.id = 'rp-ai-recipe-copy-prompt';
copyButton.textContent = 'Copy prompt';
actions.appendChild(copyButton);
actions.appendChild(document.createTextNode(' '));
[
['ChatGPT', 'https://chatgpt.com/'],
['Claude', 'https://claude.ai/new'],
['Gemini', 'https://gemini.google.com/app'],
['DeepSeek', 'https://chat.deepseek.com/']
].forEach(function (provider, index) {
if (index) actions.appendChild(document.createTextNode(' · '));
actions.appendChild(addProviderLink(provider[0], provider[1]));
});
panel.appendChild(actions);

var importLabel = document.createElement('label');
importLabel.htmlFor = 'rp-ai-recipe-json';
importLabel.textContent = 'Paste the returned JSON';
var input = document.createElement('textarea');
input.id = 'rp-ai-recipe-json';
input.rows = 16;
input.cols = 70;
input.spellcheck = false;
input.placeholder = '{"name":"This page title", "ingredients":[...], ...}';
var importControl = document.createElement('p');
importControl.appendChild(importLabel);
importControl.appendChild(document.createElement('br'));
importControl.appendChild(input);
panel.appendChild(importControl);
var importButton = document.createElement('button');
importButton.type = 'button';
importButton.id = 'rp-ai-recipe-import-json';
importButton.textContent = 'Import draft into this form';
var importAction = document.createElement('p');
importAction.appendChild(importButton);
panel.appendChild(importAction);
var status = document.createElement('div');
status.id = 'rp-ai-recipe-status';
status.className = 'rp-ai-status';
status.setAttribute('role', 'status');
status.setAttribute('aria-live', 'polite');
panel.appendChild(status);

function setStatus(message, isError) {
status.textContent = message;
status.className = isError ? 'rp-ai-status rp-ai-status-error' : 'rp-ai-status rp-ai-status-success';
}

function promptFor(recipeTitle) {
return 'Create a draft Recipedius recipe for "' + recipeTitle + '". ' +
'Return only one JSON object with exactly these keys: name, serves, time, tags, contributor, lede, ingredients, instructions. ' +
'Use this title exactly as name. serves must be a positive integer. time and lede must be non-empty strings. ' +
'tags must be an array of non-empty strings. contributor must be a non-empty string or null. ' +
'ingredients must be a non-empty array of objects with exactly name, quantity, unit, role, preparation. ' +
'Each ingredient name must be a plain title, not wiki markup; quantity must be a positive number; unit, role, and preparation must be non-empty strings or null. ' +
'instructions must be an array of non-empty step strings. Do not use semicolons or newlines in any string, commas in tags, or [, ], or | in ingredient names. ' +
'Use null for unknown contributor, unit, role, or preparation; do not invent them. ' +
'Quantities, timing, allergy information, and food-safety guidance are a draft for the contributor to verify before saving.';
}

function copyText(text) {
if (navigator.clipboard && navigator.clipboard.writeText) return navigator.clipboard.writeText(text);
var temporary = document.createElement('textarea');
temporary.value = text;
temporary.setAttribute('readonly', '');
temporary.style.position = 'fixed';
temporary.style.opacity = '0';
document.body.appendChild(temporary);
temporary.select();
var copied = document.execCommand('copy');
document.body.removeChild(temporary);
return copied ? Promise.resolve() : Promise.reject(new Error('Clipboard unavailable'));
}

function copyPrompt() {
return copyText(promptFor(expectedTitle)).then(function () {
setStatus('Prompt copied. Review the AI draft before importing it.', false);
}).catch(function () {
setStatus('Your browser did not allow copying. Select and copy the prompt shown below.', true);
});
}

function hasOwn(object, key) {
return Object.prototype.hasOwnProperty.call(object, key);
}

function validString(value) {
return typeof value === 'string' && value.trim() !== '';
}

function hasSeparator(value) {
return /[;\r\n]/.test(value);
}

function validatePlainString(value, property) {
if (!validString(value)) return property + ' must be a non-empty string.';
if (hasSeparator(value)) return property + ' must not contain a semicolon or newline.';
return null;
}

function validateIngredient(ingredient, index) {
var keys = ['name', 'quantity', 'unit', 'role', 'preparation'];
var key;
if (!ingredient || Array.isArray(ingredient) || typeof ingredient !== 'object') return 'ingredients[' + index + '] must be an object.';
for (key in ingredient) {
if (hasOwn(ingredient, key) && keys.indexOf(key) === -1) return 'Unknown property: ingredients[' + index + '].' + key + '.';
}
for (var i = 0; i < keys.length; i++) {
if (!hasOwn(ingredient, keys[i])) return 'Missing property: ingredients[' + index + '].' + keys[i] + '.';
}
var nameProblem = validatePlainString(ingredient.name, 'ingredients[' + index + '].name');
if (nameProblem) return nameProblem;
if (/[\[\]|]/.test(ingredient.name)) return 'ingredients[' + index + '].name must be a plain title without wiki-link markup.';
if (typeof ingredient.quantity !== 'number' || !Number.isFinite(ingredient.quantity) || ingredient.quantity <= 0) {
return 'ingredients[' + index + '].quantity must be a positive number.';
}
for (var j = 0; j < 3; j++) {
key = keys[j + 2];
if (ingredient[key] !== null) {
var problem = validatePlainString(ingredient[key], 'ingredients[' + index + '].' + key);
if (problem) return problem;
}
}
return null;
}

function validate(record) {
var i;
if (!record || Array.isArray(record) || typeof record !== 'object') return 'The draft must be one JSON object.';
for (i = 0; i < Object.keys(record).length; i++) {
if (allKeys.indexOf(Object.keys(record)[i]) === -1) return 'Unknown property: ' + Object.keys(record)[i] + '.';
}
for (i = 0; i < allKeys.length; i++) {
if (!hasOwn(record, allKeys[i])) return 'Missing property: ' + allKeys[i] + '.';
}
if (!validString(record.name)) return 'name must be a non-empty string.';
if (record.name !== expectedTitle) return 'The JSON name must exactly match this page title: ' + expectedTitle + '.';
if (!Number.isInteger(record.serves) || record.serves <= 0) return 'serves must be a positive integer.';
for (i = 0; i < 2; i++) {
var stringProblem = validatePlainString(record[i === 0 ? 'time' : 'lede'], i === 0 ? 'time' : 'lede');
if (stringProblem) return stringProblem;
}
if (record.contributor !== null) {
var contributorProblem = validatePlainString(record.contributor, 'contributor');
if (contributorProblem) return contributorProblem;
}
if (!Array.isArray(record.tags) || !record.tags.length) return 'tags must be a non-empty array of strings.';
for (i = 0; i < record.tags.length; i++) {
var tagProblem = validatePlainString(record.tags[i], 'tags[' + i + ']');
if (tagProblem) return tagProblem;
if (record.tags[i].indexOf(',') !== -1) return 'tags[' + i + '] must not contain a comma.';
}
if (!Array.isArray(record.ingredients) || !record.ingredients.length) return 'ingredients must be a non-empty array.';
for (i = 0; i < record.ingredients.length; i++) {
var ingredientProblem = validateIngredient(record.ingredients[i], i);
if (ingredientProblem) return ingredientProblem;
}
if (!Array.isArray(record.instructions) || !record.instructions.length) return 'instructions must be a non-empty array of strings.';
for (i = 0; i < record.instructions.length; i++) {
var instructionProblem = validatePlainString(record.instructions[i], 'instructions[' + i + ']');
if (instructionProblem) return instructionProblem;
}
return null;
}

function ingredientLine(ingredient) {
return '[[' + ingredient.name.trim() + ']]; ' + ingredient.quantity + '; ' +
(ingredient.unit === null ? '' : ingredient.unit.trim()) + '; ' +
(ingredient.role === null ? '' : ingredient.role.trim()) + '; ' +
(ingredient.preparation === null ? '' : ingredient.preparation.trim());
}

function valuesFor(record) {
return {
serves: record.serves,
time: record.time.trim(),
tags: record.tags.map(function (tag) { return tag.trim(); }).join(', '),
contributor: record.contributor === null ? '' : record.contributor.trim(),
lede: record.lede.trim(),
ingredients: record.ingredients.map(ingredientLine).join('\n'),
instructions: record.instructions.map(function (step) { return '# ' + step.trim(); }).join('\n')
};
}

function setFields(values) {
var controls = {};
Object.keys(fields).forEach(function (key) {
var control = document.querySelector('[name="' + fields[key] + '"]');
if (!control) throw new Error('The Recipe form is missing the ' + key + ' field.');
controls[key] = control;
});
Object.keys(fields).forEach(function (key) {
controls[key].value = String(values[key]);
});
}

copyButton.addEventListener('click', copyPrompt);
Array.prototype.forEach.call(panel.querySelectorAll('[data-rp-ai-provider]'), function (link) {
link.addEventListener('click', copyPrompt);
});
importButton.addEventListener('click', function () {
var record;
try {
record = JSON.parse(input.value);
} catch (error) {
setStatus('Invalid JSON: ' + error.message, true);
return;
}
var problem = validate(record);
if (problem) {
setStatus(problem, true);
return;
}
try {
setFields(valuesFor(record));
} catch (error) {
setStatus(error.message, true);
return;
}
setStatus('Draft imported. Review every field, then use the normal Save button to create ' + expectedTitle + '.', false);
});
});
}(jQuery, mediaWiki));

Module:Recipedius

2026-09-25T12:55:48Z

Recipedius deploy: 0.014 T014: deploy AI-assisted Recipe import (e0496d8)

--[[
Module:Recipedius
The computed layer of Recipedius. Reads ingredient records and substitution rules
from Cargo tables and renders recipe pages, the weekly sale ranking, and cookbooks.

Entry points (all via {{#invoke:Recipedius|fn}} from templates):
recipe - renders a recipe from Template:Recipe args and stores its rows
sale - ranks recipes by how many of their shopping items are on sale
cookbook - renders a printable book from a list of recipe pages
]]

local p = {}
local cargo = mw.ext.cargo

-- ---------------------------------------------------------------- helpers

local FRACTIONS = {
{ 0.125, '⅛' }, { 0.25, '¼' }, { 1/3, '⅓' }, { 0.375, '⅜' }, { 0.5, '½' },
{ 0.625, '⅝' }, { 2/3, '⅔' }, { 0.75, '¾' }, { 0.875, '⅞' },
}
local FRACTION_CHARS = { ['⅛']=0.125, ['¼']=0.25, ['⅓']=1/3, ['⅜']=0.375, ['½']=0.5, ['⅝']=0.625, ['⅔']=2/3, ['¾']=0.75, ['⅞']=0.875 }

local function trim(s) return mw.text.trim(s or '') end

-- AI-assisted recipe imports persist ingredient titles as ordinary wiki links
-- so the form value itself remains navigable. Keep the existing plain-title
-- format compatible, while resolving that narrow importer-owned syntax before
-- data lookup, Cargo storage, pluralization, and generated display links.
local function ingredientTitle(s)
s = trim(s)
local linked = s:match('^%[%[([^%[%]|]+)%]%]$')
return linked and trim(linked) or s
end

-- "1 1/2", "3/4", "0.5", "1 ½" and "¾" all parse.
local function parseQty(s)
s = trim(s)
local total, found = 0, false
for tok in s:gmatch('%S+') do
if FRACTION_CHARS[tok] then total = total + FRACTION_CHARS[tok]; found = true
else
local a, b = tok:match('^(%d+)/(%d+)$')
if a then total = total + tonumber(a) / tonumber(b); found = true
elseif tonumber(tok) then total = total + tonumber(tok); found = true end
end
end
if found then return total end
return nil
end

local function fmtQty(q)
if not q then return '' end
local w = math.floor(q + 1e-6)
local f = q - w
if f > 0.94 then w = w + 1; f = 0 end
local fs = ''
if f > 0.06 then
local best, bd = nil, 1
for _, pair in ipairs(FRACTIONS) do
local d = math.abs(pair[1] - f)
if d < bd then bd = d; best = pair[2] end
end
if bd < 0.06 then fs = best else fs = string.format('%.2f', f):gsub('^0', '') end
end
if w == 0 then return fs ~= '' and fs or '0' end
if fs ~= '' then return w .. ' ' .. fs end
return tostring(w)
end

local PLURALS = { ['Garlic'] = 'Garlic cloves', ['Whole chicken'] = 'Whole chickens', ['Russet potato'] = 'Russet potatoes' }
-- Display name for a count-based ingredient: "2 eggs", "3 bananas", "6 garlic cloves".
local function countLabel(name, q, u)
if u ~= 'each' or not q or q <= 1 then return name end
if PLURALS[name] then return PLURALS[name] end
if name:sub(-1) == 's' then return name end
return name .. 's'
end

local function unitLabel(q, u)
if u == 'each' or u == '' then return '' end
if u == 'cup' and q and q > 1 then return 'cups' end
return u
end

local function sqlEsc(s) return (tostring(s):gsub("'", "\\'")) end

local function splitList(s)
local out = {}
for item in (s or ''):gmatch('[^,]+') do
item = trim(item)
if item ~= '' then table.insert(out, item) end
end
return out
end

local function round(x) return math.floor(x + 0.5) end

-- ---------------------------------------------------------------- data access

local ingredientCache = {}
local function getIngredient(name)
if ingredientCache[name] ~= nil then return ingredientCache[name] or nil end
local rows = cargo.query('Ingredients',
'_pageName=name,kcal100,g_tsp,g_tbsp,g_cup,g_each,allergens,pantry,price,price_per',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
ingredientCache[name] = rows[1] or false
return rows[1]
end

local recipeCache = {}
local function getRecipe(name)
if recipeCache[name] ~= nil then return recipeCache[name] or nil end
local rows = cargo.query('Recipes', '_pageName=name',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
recipeCache[name] = rows[1] or false
return rows[1]
end

local function gramsPer(ing, unit)
if not ing then return nil end
local key = ({ tsp = 'g_tsp', tbsp = 'g_tbsp', cup = 'g_cup', each = 'g_each' })[unit]
if not key then return nil end
return tonumber(ing[key])
end

local function kcalOf(ing, q, unit)
local g = gramsPer(ing, unit)
local k = ing and tonumber(ing.kcal100)
if not (g and k and q) then return 0 end
return q * g * k / 100
end

-- Substitution rules for an ingredient, resolved for the role it plays in this recipe.
-- A base row (role blank) applies everywhere; a row with a role overrides the base for that role.
-- An override with applicable=no removes the option for that role.
local subsCache = {}
local function rulesFor(name, role)
if not subsCache[name] then
subsCache[name] = cargo.query('Substitutions',
'sub_to,alt,role,ratio,conv,confidence,effect,warning,applicable',
{ where = "sub_from='" .. sqlEsc(name) .. "'", orderBy = 'sub_to', limit = 200 })
end
local groups, order = {}, {}
for _, r in ipairs(subsCache[name]) do
local key = (r.sub_to or '') .. '|' .. (r.alt or '')
if not groups[key] then groups[key] = {}; table.insert(order, key) end
if trim(r.role) == '' then groups[key].base = r
elseif trim(r.role) == role then groups[key].override = r end
end
local out = {}
for _, key in ipairs(order) do
local b, o = groups[key].base, groups[key].override
local blocked = o and trim(o.applicable):lower() == 'no'
if (b or o) and not blocked then
local m = {}
for _, k in ipairs({ 'sub_to', 'alt', 'ratio', 'conv', 'confidence', 'effect', 'warning' }) do
local ov = o and trim(o[k]) or ''
if ov ~= '' then m[k] = ov elseif b then m[k] = trim(b[k]) else m[k] = '' end
end
if m.warning == 'none' then m.warning = '' end
m.roleSpecific = o ~= nil
table.insert(out, m)
end
end
return out
end

-- ---------------------------------------------------------------- recipe

-- Ingredient lines are written one per line as: Ingredient; quantity; unit; role; preparation
local function parseLines(text)
local lines = {}
for raw in (text or ''):gmatch('[^\r\n]+') do
raw = trim(raw)
if raw ~= '' and not raw:match('^<!%-%-') then
local parts = mw.text.split(raw, ';', true)
local name = ingredientTitle(parts[1] or '')
if name ~= '' then
table.insert(lines, {
name = name,
qty = parseQty(parts[2] or ''),
unit = trim(parts[3] or ''),
role = trim(parts[4] or ''),
prep = trim(parts[5] or ''),
})
end
end
end
return lines
end

local function resolvedArg(args, preferred, legacy)
local value = trim(args[preferred])
if value ~= '' then return value end
return trim(args[legacy])
end

local CONF_DOTS = { high = '●●●', medium = '●●○', low = '●○○' }
local function confBadge(c)
c = trim(c):lower()
return '<span class="rp-conf rp-conf-' .. c .. '" title="confidence: ' .. c .. '">' .. (CONF_DOTS[c] or '○○○') .. ' ' .. c .. '</span>'
end

function p.recipe(frame)
local args = frame:getParent().args
local title = mw.title.getCurrentTitle()
local page = title.prefixedText
local serves = tonumber(args.serves) or 1
local description = resolvedArg(args, 'description', 'lede')
local instructions = resolvedArg(args, 'instructions', 'method')
local lines = parseLines(args.ingredients)

-- totals from the ingredient records
local kcalTotal, allergens, seen, missing = 0, {}, {}, {}
for _, l in ipairs(lines) do
local ing = getIngredient(l.name)
if ing then
kcalTotal = kcalTotal + kcalOf(ing, l.qty, l.unit)
for _, a in ipairs(splitList(ing.allergens)) do
if not seen[a] then seen[a] = true; table.insert(allergens, a) end
end
elseif not getRecipe(l.name) then
table.insert(missing, l.name)
end
end

local out = {}
local function add(s) table.insert(out, s) end

-- infobox
add('{| class="wikitable rp-infobox"\n|+ ' .. page)
add('|-\n! Serves\n| ' .. serves)
if trim(args.time) ~= '' then add('|-\n! Time\n| ' .. trim(args.time)) end
add('|-\n! Per serving\n| <b>' .. round(kcalTotal / serves) .. ' kcal</b> <small>(' .. round(kcalTotal) .. ' for the batch)</small>')
add('|-\n! Contains\n| ' .. (#allergens > 0 and table.concat(allergens, ', ') or "''nothing flagged''"))
if trim(args.contributor) ~= '' then add('|-\n! Contributed by\n| ' .. trim(args.contributor)) end
if trim(args.tags) ~= '' then
local tagLinks = {}
for _, t in ipairs(splitList(args.tags)) do table.insert(tagLinks, '[[:Category:' .. t .. '|' .. t .. ']]') end
add('|-\n! Tags\n| ' .. table.concat(tagLinks, ' · '))
end
add('|-\n| colspan="2" | <small>Calories are computed from the [[:Category:Ingredients|ingredient records]]. Approximate.</small>')
add('|}')

add('== Description ==')
if description ~= '' then add("<div class=\"rp-lede\">''" .. description .. "''</div>")
else add("''No description yet.''") end

if #missing > 0 then
-- Each name links to the ingredient form already targeted at that title, so
-- a contributor lands on the right form rather than being asked for a name
-- the page already knows. A bare Special:FormEdit link has no target and
-- answers "No target page specified".
local createLinks = {}
for _, name in ipairs(missing) do
table.insert(createLinks, '[[Special:FormEdit/Ingredient/' .. name .. '|' .. name .. ']]')
end
add('<div class="rp-missing">These ingredients have no record yet, so they are left out of the nutrition and substitution tables: ' ..
table.concat(createLinks, ', ') .. '. Follow a name to create its record.</div>')
end

-- ingredients table
add('== Ingredients ==')
add('{| class="wikitable rp-ingredients"\n! Quantity !! Ingredient !! Its job here !! Swaps')
local swapSections = {}
for i, l in ipairs(lines) do
local ing = getIngredient(l.name)
local shown = countLabel(l.name, l.qty, l.unit)
local isRecipe = not ing and getRecipe(l.name)
local link = (ing or isRecipe) and ('[[' .. l.name .. '|' .. shown .. ']]') or ('[[' .. l.name .. '|' .. shown .. ']]<sup class="rp-missing-mark">?</sup>')
local qty = fmtQty(l.qty) .. ' ' .. unitLabel(l.qty, l.unit)
local prep = l.prep ~= '' and (', <span class="rp-prep">' .. l.prep .. '</span>') or ''
local rules = ing and rulesFor(l.name, l.role) or {}
local swapCell = "''none''"
if #rules > 0 then
swapCell = '[[#Substitutions for this recipe|' .. #rules .. (#rules == 1 and ' option' or ' options') .. ']]'
table.insert(swapSections, { line = l, rules = rules })
end
add('|-\n| class="rp-qty" | ' .. trim(qty) .. '\n| ' .. link .. prep .. '\n| class="rp-role" | ' .. l.role .. '\n| ' .. swapCell)
end
add('|}')

add('== Instructions ==')
if instructions ~= '' then add(instructions)
else add("''No instructions yet.''") end

-- substitutions resolved for this recipe
if #swapSections > 0 then
add('== Substitutions for this recipe ==')
add('<p class="rp-note">Rules come from each ingredient\'s record and are resolved for the job the ingredient does in this recipe. Confidence is the community\'s, not a guarantee.</p>')
add('{| class="wikitable rp-subs"\n! Instead of !! Use !! How much !! What changes !! Confidence')
for _, s in ipairs(swapSections) do
for _, r in ipairs(s.rules) do
local useName = r.alt ~= '' and (r.alt .. ' ([[' .. r.sub_to .. ']])') or ('[[' .. r.sub_to .. ']]')
local howMuch
if r.conv ~= '' then howMuch = r.conv
else
local ratio = tonumber(r.ratio) or 1
local nq = s.line.qty and (s.line.qty * ratio) or nil
howMuch = nq and (fmtQty(nq) .. ' ' .. unitLabel(nq, s.line.unit) .. ' <small>(× ' .. ratio .. ')</small>') or ('× ' .. ratio)
end
local what = r.effect
if r.warning ~= '' then what = what .. '<br /><span class="rp-warn">⚠ ' .. r.warning .. '</span>' end
if r.roleSpecific then what = what .. ' <small class="rp-role-tag">rule for: ' .. s.line.role .. '</small>' end
add('|-\n| [[' .. s.line.name .. ']]\n| ' .. useName .. '\n| class="rp-qty" | ' .. howMuch .. '\n| ' .. what .. '\n| ' .. confBadge(r.confidence))
end
end
add('|}')
end

-- store rows (skipped when the page is being previewed inside another page)
if title.namespace == 0 then
for i, l in ipairs(lines) do
frame:callParserFunction('#cargo_store', {
'_table=RecipeIngredients', recipe = page, ingredient = l.name,
qty = l.qty and tostring(l.qty) or '', unit = l.unit, role = l.role, prep = l.prep, pos = tostring(i),
})
end
frame:callParserFunction('#cargo_store', {
'_table=Recipes', serves = tostring(serves), time = trim(args.time), tags = trim(args.tags),
contributor = trim(args.contributor), lede = description, method = instructions,
kcal_total = tostring(round(kcalTotal)), allergens = table.concat(allergens, ','), ingredient_count = tostring(#lines),
})
end

-- Categories belong to real recipe pages. Without this guard a /testcases
-- page that exercises the template would file itself under Category:Recipes
-- and every tag category it demonstrates.
if title.namespace == 0 then
local cats = { '[[Category:Recipes]]' }
for _, t in ipairs(splitList(args.tags)) do table.insert(cats, '[[Category:' .. t .. ']]') end
add(table.concat(cats, ''))
end
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- sale

function p.sale(frame)
local args = frame.args
local store = trim(args.store)
local where = store ~= '' and ("store='" .. sqlEsc(store) .. "'") or nil
local sale = cargo.query('SaleItems', 'ingredient,price,was,per,store', { where = where, limit = 200 })
if #sale == 0 then return "''No sale items have been entered yet. Add them with [[Template:SaleItem]].''" end
local onSale = {}
for _, s in ipairs(sale) do onSale[s.ingredient] = s end

local rows = cargo.query('RecipeIngredients=RI,Ingredients=I', 'RI.recipe=recipe,RI.ingredient=ingredient,I.pantry=pantry',
{ join = 'RI.ingredient=I._pageName', limit = 2000 })
local recipes, order = {}, {}
for _, r in ipairs(rows) do
if not recipes[r.recipe] then recipes[r.recipe] = { hits = {}, toBuy = 0, save = 0 }; table.insert(order, r.recipe) end
local rec = recipes[r.recipe]
local pantry = trim(r.pantry):lower() == 'yes'
if not pantry then
rec.toBuy = rec.toBuy + 1
local s = onSale[r.ingredient]
if s then
table.insert(rec.hits, r.ingredient)
rec.save = rec.save + ((tonumber(s.was) or 0) - (tonumber(s.price) or 0))
end
end
end
local ranked = {}
for _, name in ipairs(order) do
local rec = recipes[name]
if #rec.hits > 0 then rec.name = name; table.insert(ranked, rec) end
end
table.sort(ranked, function(a, b)
if #a.hits ~= #b.hits then return #a.hits > #b.hits end
return (#a.hits / math.max(1, a.toBuy)) > (#b.hits / math.max(1, b.toBuy))
end)

local out = { '{| class="wikitable rp-sale"\n! Recipe !! On sale !! Shopping list !! You save' }
for _, rec in ipairs(ranked) do
local links = {}
for _, h in ipairs(rec.hits) do table.insert(links, '[[' .. h .. ']]') end
table.insert(out, '|-\n| [[' .. rec.name .. ']]\n| ' .. table.concat(links, ', ') .. '\n| ' .. #rec.hits .. ' of ' .. rec.toBuy ..
' items <small>(pantry staples excluded)</small>\n| class="rp-qty" | $' .. string.format('%.2f', rec.save))
end
table.insert(out, '|}')
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- cookbook

local function chapterFor(tags)
local t = {}
for _, x in ipairs(splitList(tags)) do t[x:lower()] = true end
if t['breakfast'] then return 'Mornings' end
if t['dessert'] then return 'Sweets' end
if t['dinner'] or t['side'] or t['soup'] then return 'Suppers and sides' end
return 'Pantry and dressings'
end

function p.cookbook(frame)
local args = frame:getParent().args
local names = splitList(args.recipes)
local title = trim(args.title) ~= '' and trim(args.title) or 'Our kitchen'
local out = {}
local function add(s) table.insert(out, s) end

add('<div class="rp-book">')
add('<div class="rp-page rp-cover"><div class="rp-orn">✦</div><div class="rp-cover-title">' .. title .. '</div><div class="rp-cover-sub">' ..
#names .. (#names == 1 and ' recipe' or ' recipes') .. ' · assembled on Recipedius</div></div>')
if trim(args.dedication) ~= '' then
add('<div class="rp-page rp-dedication">' .. trim(args.dedication) .. '</div>')
end

-- gather
local recs, chapters, chapterOrder = {}, {}, {}
for _, n in ipairs(names) do
local r = cargo.query('Recipes', '_pageName=name,serves,time,tags,contributor,lede,method',
{ where = "_pageName='" .. sqlEsc(n) .. "'", limit = 1 })[1]
if r then
r.lines = cargo.query('RecipeIngredients', 'ingredient,qty,unit,prep,pos',
{ where = "recipe='" .. sqlEsc(n) .. "'", orderBy = 'pos', limit = 100 })
local ch = chapterFor(r.tags)
if not chapters[ch] then chapters[ch] = {}; table.insert(chapterOrder, ch) end
table.insert(chapters[ch], r)
else
add('<div class="rp-missing">No recipe page called "' .. n .. '" was found.</div>')
end
end

-- contents
add('<div class="rp-page rp-toc"><div class="rp-chap-label">Contents</div>')
for _, ch in ipairs(chapterOrder) do
add('<div class="rp-toc-chapter">' .. ch .. '</div>')
for _, r in ipairs(chapters[ch]) do add('<div class="rp-toc-row"><span>' .. r.name .. '</span><span>' .. r.time .. '</span></div>') end
end
add('</div>')

for _, ch in ipairs(chapterOrder) do
add('<div class="rp-page rp-chapter"><div class="rp-chap-label">Chapter</div><div class="rp-chapter-title">' .. ch .. '</div></div>')
for _, r in ipairs(chapters[ch]) do
add('<div class="rp-page rp-recipe-page"><div class="rp-chap-label">' .. ch .. '</div><div class="rp-recipe-title">' .. r.name .. '</div>')
if trim(r.lede) ~= '' then add("<div class=\"rp-lede\">''" .. r.lede .. "''</div>") end
add('<div class="rp-book-cols"><div class="rp-book-ings">')
for _, l in ipairs(r.lines) do
local q = tonumber(l.qty)
add('<div class="rp-book-ing"><span class="rp-qty">' .. fmtQty(q) .. ' ' .. unitLabel(q, l.unit) .. '</span><span>' .. countLabel(l.ingredient, q, l.unit) ..
(trim(l.prep) ~= '' and (', ' .. l.prep) or '') .. '</span></div>')
end
add('</div><div class="rp-book-method">\n' .. (r.method or '') .. '\n</div></div>')
add('<div class="rp-book-foot">Serves ' .. r.serves .. ' · ' .. r.time .. (trim(r.contributor) ~= '' and (' · contributed by ' .. r.contributor) or '') .. '</div></div>')
end
end
add('</div>')
return table.concat(out, '\n')
end

return p

Form:Ingredient

2026-09-24T16:02:34Z

Recipedius deploy: 0.013 T014: deploy AI ingredient draft import (ac09cdd)

<noinclude>
This is the form for creating an ingredient record. Enter the ingredient's name below.
{{#forminput:form=Ingredient|autocomplete on category=Ingredients}}
</noinclude><includeonly>
<div id="rp-ai-ingredient-import" class="rp-ai-import">
'''Create a draft with AI (optional)'''

Copy prompt, use ChatGPT, Claude, Gemini, or DeepSeek, then Paste the returned JSON here. AI-assisted import needs JavaScript; you can still complete every field manually below.
</div>
{{{for template|Ingredient}}}
{| class="formtable"
! Form:
| {{{field|form|size=40|placeholder=Unsalted, solid}}}
|-
! Role in the kitchen:
| {{{field|role|size=40|placeholder=Fat · structure, flavor, creaming}}}
|-
! Storage:
| {{{field|storage|size=40}}}
|-
! Season:
| {{{field|season|size=40}}}
|-
! kcal per 100 g:
| {{{field|kcal100|size=6}}}
|-
! Grams per teaspoon / tablespoon / cup / each:
| {{{field|g_tsp|size=5}}} {{{field|g_tbsp|size=5}}} {{{field|g_cup|size=5}}} {{{field|g_each|size=5}}}
|-
! Allergens (comma-separated):
| {{{field|allergens|size=40|placeholder=dairy}}}
|-
! Pantry staple (left off shopping lists)?
| {{{field|pantry|input type=dropdown|values=no,yes}}}
|-
! Typical price and unit:
| ${{{field|price|size=6}}} per {{{field|price_per|size=10|placeholder=1 lb}}}
|-
! Description:
| {{{field|summary|input type=textarea|rows=5|cols=70}}}
|}
{{{end template}}}
{{{standard input|free text|rows=8|cols=70}}}
<small>Add substitution rules in the free-text area with [[Template:Substitution]].</small>

'''Edit summary:''' {{{standard input|summary}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|cancel}}}
</includeonly>

MediaWiki:Common.js

2026-09-24T16:02:33Z

Recipedius deploy: 0.013 T014: deploy AI ingredient draft import (ac09cdd)

MediaWiki:Common.css

2026-09-24T16:02:33Z

Recipedius deploy: 0.013 T014: deploy AI ingredient draft import (ac09cdd)

/* Recipedius styling */
.rp-infobox { float: right; clear: right; margin: 0 0 1em 1.5em; width: 300px; font-size: 0.92em; }
.rp-infobox caption { font-weight: bold; font-size: 1.1em; padding: 0.4em; }
.rp-infobox th { text-align: left; width: 38%; }
.rp-lede { font-size: 1.15em; margin: 0.5em 0 1em; max-width: 65ch; }
.rp-qty { font-family: ui-monospace, Menlo, Consolas, monospace; font-size: 0.92em; white-space: nowrap; font-variant-numeric: tabular-nums; }
.rp-was { text-decoration: line-through; color: #72777d; }
.rp-prep { color: #54595d; }
.rp-role { color: #54595d; font-size: 0.9em; }
.rp-warn { color: #b32424; }
.rp-note { color: #54595d; max-width: 70ch; }
.rp-role-tag { color: #6b4fbb; }
.rp-missing { background: #fef6e7; border-left: 4px solid #edab00; padding: 0.5em 1em; margin: 0.8em 0; }
.rp-missing-mark { color: #b32424; }
.rp-conf { white-space: nowrap; font-size: 0.85em; letter-spacing: 0.02em; }
.rp-conf-high { color: #14866d; }
.rp-conf-medium { color: #ac6600; }
.rp-conf-low { color: #b32424; }
.rp-ingredients, .rp-subs, .rp-sale, .rp-rules { width: 100%; }
.rp-subs td:nth-child(3) { white-space: normal; width: 18%; }
.rp-subs td:nth-child(4) { width: 46%; }
.rp-subs .rp-qty, .rp-rules .rp-qty { white-space: normal; }

/* Optional AI-assisted ingredient draft import */
.rp-ai-import { border: 1px solid #a2a9b1; background: #f8f9fa; margin: 0 0 1em; padding: 1em; max-width: 70ch; }
.rp-ai-import > :first-child { margin-top: 0; }
.rp-ai-import textarea { box-sizing: border-box; max-width: 100%; font-family: ui-monospace, Menlo, Consolas, monospace; }
.rp-ai-import a, .rp-ai-import button { margin-right: 0.35em; }
.rp-ai-status { min-height: 1.4em; font-weight: 600; }
.rp-ai-status-error { color: #b32424; }
.rp-ai-status-success { color: #14866d; }

/* Main Page actions */
.rp-main-layout { display: grid; grid-template-columns: minmax(11rem, 0.28fr) minmax(0, 1fr); gap: 1.5rem; align-items: start; }
.rp-main-actions { background: #f8f9fa; border: 1px solid #c8ccd1; padding: 1rem; }
.rp-main-actions h2 { border: 0; font-size: 1.1em; margin: 0 0 0.65rem; padding: 0; }
.rp-main-actions ul { list-style: none; margin: 0; }
.rp-main-actions li + li { margin-top: 0.5rem; }
.rp-main-actions a { font-weight: bold; }

/* Cookbook */
.rp-book { max-width: 820px; }
.rp-page { background: #fbfaf4; color: #22251c; border: 1px solid #ddd; padding: 40px 48px; margin: 0 0 18px; min-height: 420px; position: relative; box-shadow: 0 2px 8px rgba(0,0,0,0.06); }
.rp-cover { background: #2e3a2a; color: #f3efd8; text-align: center; display: flex; flex-direction: column; justify-content: center; align-items: center; gap: 12px; min-height: 380px; }
.rp-orn { width: 44px; height: 44px; border-radius: 50%; border: 2px solid #e2a600; display: grid; place-items: center; font-size: 1.2em; }
.rp-cover-title { font-size: 2.4em; font-weight: bold; line-height: 1.05; }
.rp-cover-sub { font-style: italic; opacity: 0.8; }
.rp-dedication { display: flex; align-items: center; justify-content: center; text-align: center; font-style: italic; font-size: 1.2em; }
.rp-chapter { display: flex; flex-direction: column; justify-content: center; align-items: center; text-align: center; }
.rp-chapter-title { font-size: 2em; font-weight: bold; }
.rp-chap-label { font-size: 0.75em; text-transform: uppercase; letter-spacing: 0.12em; color: #7a7c6e; margin-bottom: 10px; }
.rp-recipe-title { font-size: 1.7em; font-weight: bold; margin-bottom: 4px; }
.rp-toc-chapter { font-weight: bold; margin-top: 10px; }
.rp-toc-row { display: flex; justify-content: space-between; border-bottom: 1px dotted #c9c7b4; padding: 3px 0; }
.rp-book-cols { display: grid; grid-template-columns: 1fr 1.4fr; gap: 28px; margin-top: 14px; }
.rp-book-ing { display: grid; grid-template-columns: 5em 1fr; gap: 8px; padding: 2px 0; font-size: 0.95em; }
.rp-book-method ol { margin-left: 1.2em; }
.rp-book-foot { margin-top: 18px; font-size: 0.8em; color: #7a7c6e; border-top: 1px solid #ddd; padding-top: 8px; }
@media (max-width: 720px) { .rp-book-cols, .rp-main-layout { grid-template-columns: 1fr; } .rp-infobox { float: none; width: auto; margin: 0 0 1em; } }

Main Page

2026-09-24T13:37:04Z

Recipedius deploy: 0.012 T009: deploy working form entry points (6e8250e)

<div class="rp-main-layout">
<div class="rp-main-actions">
== Add to Recipedius ==
* [[Special:FormStart/Recipe|Add recipe]]
* [[Special:FormStart/Ingredient|Add ingredient]]
</div>
<div class="rp-main-content">
<div class="rp-lede">'''Recipedius''' is an encyclopedia of what's in your kitchen. Every recipe is built from ingredient records, not text: swap the butter and the calories, allergens and shopping list follow. Put lemons on sale and the recipes that use them float to the top. Pick your favorites and turn them into a printed book.</div>

'''Start here:''' open [[Classic shortbread]] and look at the substitution table, then [[Banana bread]]; the same olive-oil swap is low-confidence in one and high in the other, because the butter's job is different. That is the whole idea in one click. Then see [[This week's sale]] and [[Cookbook/Sample]].

== Recipes ==
{{#cargo_query:tables=Recipes
|fields=_pageName=Recipe,serves=Serves,time=Time,ROUND(kcal_total/serves)=kcal per serving,allergens=Contains,contributor=Contributed by
|order by=_pageName
|format=table
}}
''Add one: [[Special:FormStart/Recipe|create a recipe with the form]], or make a page and use [[Template:Recipe]].''

== Ingredient records ==
{{#cargo_query:tables=Ingredients
|fields=_pageName=Ingredient,role=Role,ROUND(g_tbsp*kcal100/100)=kcal per tbsp,allergens=Allergens
|order by=_pageName
|format=table
}}
''Add one: [[Special:FormStart/Ingredient|create an ingredient record with the form]].''

== Elsewhere ==
* [[This week's sale]] — recipes ranked by what's cheap at an example store
* [[Cookbook/Sample]] — a printable book assembled from the recipe database
* [[Special:CargoTables]] — the database behind the pages
* [[Recipedius:About]] — what this is, what's real and what's still to build
</div>
</div>

Module:Recipedius/sandbox

2026-09-24T13:37:04Z

Recipedius deploy: 0.012 T009: deploy working form entry points (6e8250e)

-- Development copy of [[Module:Recipedius]]. Exercise changes at
-- [[Template:Recipe/testcases]] through [[Template:Recipe/sandbox]], then copy
-- an approved revision into the production module.
--
-- Keep this a faithful copy. It is the only place a module change can be seen
-- rendered before it reaches every recipe on the wiki.
--[[
Module:Recipedius
The computed layer of Recipedius. Reads ingredient records and substitution rules
from Cargo tables and renders recipe pages, the weekly sale ranking, and cookbooks.

Entry points (all via {{#invoke:Recipedius|fn}} from templates):
recipe - renders a recipe from Template:Recipe args and stores its rows
sale - ranks recipes by how many of their shopping items are on sale
cookbook - renders a printable book from a list of recipe pages
]]

local p = {}
local cargo = mw.ext.cargo

-- ---------------------------------------------------------------- helpers

local FRACTIONS = {
{ 0.125, '⅛' }, { 0.25, '¼' }, { 1/3, '⅓' }, { 0.375, '⅜' }, { 0.5, '½' },
{ 0.625, '⅝' }, { 2/3, '⅔' }, { 0.75, '¾' }, { 0.875, '⅞' },
}
local FRACTION_CHARS = { ['⅛']=0.125, ['¼']=0.25, ['⅓']=1/3, ['⅜']=0.375, ['½']=0.5, ['⅝']=0.625, ['⅔']=2/3, ['¾']=0.75, ['⅞']=0.875 }

local function trim(s) return mw.text.trim(s or '') end

-- "1 1/2", "3/4", "0.5", "1 ½" and "¾" all parse.
local function parseQty(s)
s = trim(s)
local total, found = 0, false
for tok in s:gmatch('%S+') do
if FRACTION_CHARS[tok] then total = total + FRACTION_CHARS[tok]; found = true
else
local a, b = tok:match('^(%d+)/(%d+)$')
if a then total = total + tonumber(a) / tonumber(b); found = true
elseif tonumber(tok) then total = total + tonumber(tok); found = true end
end
end
if found then return total end
return nil
end

local function fmtQty(q)
if not q then return '' end
local w = math.floor(q + 1e-6)
local f = q - w
if f > 0.94 then w = w + 1; f = 0 end
local fs = ''
if f > 0.06 then
local best, bd = nil, 1
for _, pair in ipairs(FRACTIONS) do
local d = math.abs(pair[1] - f)
if d < bd then bd = d; best = pair[2] end
end
if bd < 0.06 then fs = best else fs = string.format('%.2f', f):gsub('^0', '') end
end
if w == 0 then return fs ~= '' and fs or '0' end
if fs ~= '' then return w .. ' ' .. fs end
return tostring(w)
end

local PLURALS = { ['Garlic'] = 'Garlic cloves', ['Whole chicken'] = 'Whole chickens', ['Russet potato'] = 'Russet potatoes' }
-- Display name for a count-based ingredient: "2 eggs", "3 bananas", "6 garlic cloves".
local function countLabel(name, q, u)
if u ~= 'each' or not q or q <= 1 then return name end
if PLURALS[name] then return PLURALS[name] end
if name:sub(-1) == 's' then return name end
return name .. 's'
end

local function unitLabel(q, u)
if u == 'each' or u == '' then return '' end
if u == 'cup' and q and q > 1 then return 'cups' end
return u
end

local function sqlEsc(s) return (tostring(s):gsub("'", "\\'")) end

local function splitList(s)
local out = {}
for item in (s or ''):gmatch('[^,]+') do
item = trim(item)
if item ~= '' then table.insert(out, item) end
end
return out
end

local function round(x) return math.floor(x + 0.5) end

-- ---------------------------------------------------------------- data access

local ingredientCache = {}
local function getIngredient(name)
if ingredientCache[name] ~= nil then return ingredientCache[name] or nil end
local rows = cargo.query('Ingredients',
'_pageName=name,kcal100,g_tsp,g_tbsp,g_cup,g_each,allergens,pantry,price,price_per',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
ingredientCache[name] = rows[1] or false
return rows[1]
end

local recipeCache = {}
local function getRecipe(name)
if recipeCache[name] ~= nil then return recipeCache[name] or nil end
local rows = cargo.query('Recipes', '_pageName=name',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
recipeCache[name] = rows[1] or false
return rows[1]
end

local function gramsPer(ing, unit)
if not ing then return nil end
local key = ({ tsp = 'g_tsp', tbsp = 'g_tbsp', cup = 'g_cup', each = 'g_each' })[unit]
if not key then return nil end
return tonumber(ing[key])
end

local function kcalOf(ing, q, unit)
local g = gramsPer(ing, unit)
local k = ing and tonumber(ing.kcal100)
if not (g and k and q) then return 0 end
return q * g * k / 100
end

-- Substitution rules for an ingredient, resolved for the role it plays in this recipe.
-- A base row (role blank) applies everywhere; a row with a role overrides the base for that role.
-- An override with applicable=no removes the option for that role.
local subsCache = {}
local function rulesFor(name, role)
if not subsCache[name] then
subsCache[name] = cargo.query('Substitutions',
'sub_to,alt,role,ratio,conv,confidence,effect,warning,applicable',
{ where = "sub_from='" .. sqlEsc(name) .. "'", orderBy = 'sub_to', limit = 200 })
end
local groups, order = {}, {}
for _, r in ipairs(subsCache[name]) do
local key = (r.sub_to or '') .. '|' .. (r.alt or '')
if not groups[key] then groups[key] = {}; table.insert(order, key) end
if trim(r.role) == '' then groups[key].base = r
elseif trim(r.role) == role then groups[key].override = r end
end
local out = {}
for _, key in ipairs(order) do
local b, o = groups[key].base, groups[key].override
local blocked = o and trim(o.applicable):lower() == 'no'
if (b or o) and not blocked then
local m = {}
for _, k in ipairs({ 'sub_to', 'alt', 'ratio', 'conv', 'confidence', 'effect', 'warning' }) do
local ov = o and trim(o[k]) or ''
if ov ~= '' then m[k] = ov elseif b then m[k] = trim(b[k]) else m[k] = '' end
end
if m.warning == 'none' then m.warning = '' end
m.roleSpecific = o ~= nil
table.insert(out, m)
end
end
return out
end

-- ---------------------------------------------------------------- recipe

-- Ingredient lines are written one per line as: Ingredient; quantity; unit; role; preparation
local function parseLines(text)
local lines = {}
for raw in (text or ''):gmatch('[^\r\n]+') do
raw = trim(raw)
if raw ~= '' and not raw:match('^<!%-%-') then
local parts = mw.text.split(raw, ';', true)
local name = trim(parts[1] or '')
if name ~= '' then
table.insert(lines, {
name = name,
qty = parseQty(parts[2] or ''),
unit = trim(parts[3] or ''),
role = trim(parts[4] or ''),
prep = trim(parts[5] or ''),
})
end
end
end
return lines
end

local function resolvedArg(args, preferred, legacy)
local value = trim(args[preferred])
if value ~= '' then return value end
return trim(args[legacy])
end

local CONF_DOTS = { high = '●●●', medium = '●●○', low = '●○○' }
local function confBadge(c)
c = trim(c):lower()
return '<span class="rp-conf rp-conf-' .. c .. '" title="confidence: ' .. c .. '">' .. (CONF_DOTS[c] or '○○○') .. ' ' .. c .. '</span>'
end

function p.recipe(frame)
local args = frame:getParent().args
local title = mw.title.getCurrentTitle()
local page = title.prefixedText
local serves = tonumber(args.serves) or 1
local description = resolvedArg(args, 'description', 'lede')
local instructions = resolvedArg(args, 'instructions', 'method')
local lines = parseLines(args.ingredients)

-- totals from the ingredient records
local kcalTotal, allergens, seen, missing = 0, {}, {}, {}
for _, l in ipairs(lines) do
local ing = getIngredient(l.name)
if ing then
kcalTotal = kcalTotal + kcalOf(ing, l.qty, l.unit)
for _, a in ipairs(splitList(ing.allergens)) do
if not seen[a] then seen[a] = true; table.insert(allergens, a) end
end
elseif not getRecipe(l.name) then
table.insert(missing, l.name)
end
end

local out = {}
local function add(s) table.insert(out, s) end

-- infobox
add('{| class="wikitable rp-infobox"\n|+ ' .. page)
add('|-\n! Serves\n| ' .. serves)
if trim(args.time) ~= '' then add('|-\n! Time\n| ' .. trim(args.time)) end
add('|-\n! Per serving\n| <b>' .. round(kcalTotal / serves) .. ' kcal</b> <small>(' .. round(kcalTotal) .. ' for the batch)</small>')
add('|-\n! Contains\n| ' .. (#allergens > 0 and table.concat(allergens, ', ') or "''nothing flagged''"))
if trim(args.contributor) ~= '' then add('|-\n! Contributed by\n| ' .. trim(args.contributor)) end
if trim(args.tags) ~= '' then
local tagLinks = {}
for _, t in ipairs(splitList(args.tags)) do table.insert(tagLinks, '[[:Category:' .. t .. '|' .. t .. ']]') end
add('|-\n! Tags\n| ' .. table.concat(tagLinks, ' · '))
end
add('|-\n| colspan="2" | <small>Calories are computed from the [[:Category:Ingredients|ingredient records]]. Approximate.</small>')
add('|}')

add('== Description ==')
if description ~= '' then add("<div class=\"rp-lede\">''" .. description .. "''</div>")
else add("''No description yet.''") end

if #missing > 0 then
-- Each name links to the ingredient form already targeted at that title, so
-- a contributor lands on the right form rather than being asked for a name
-- the page already knows. A bare Special:FormEdit link has no target and
-- answers "No target page specified".
local createLinks = {}
for _, name in ipairs(missing) do
table.insert(createLinks, '[[Special:FormEdit/Ingredient/' .. name .. '|' .. name .. ']]')
end
add('<div class="rp-missing">These ingredients have no record yet, so they are left out of the nutrition and substitution tables: ' ..
table.concat(createLinks, ', ') .. '. Follow a name to create its record.</div>')
end

-- ingredients table
add('== Ingredients ==')
add('{| class="wikitable rp-ingredients"\n! Quantity !! Ingredient !! Its job here !! Swaps')
local swapSections = {}
for i, l in ipairs(lines) do
local ing = getIngredient(l.name)
local shown = countLabel(l.name, l.qty, l.unit)
local isRecipe = not ing and getRecipe(l.name)
local link = (ing or isRecipe) and ('[[' .. l.name .. '|' .. shown .. ']]') or ('[[' .. l.name .. '|' .. shown .. ']]<sup class="rp-missing-mark">?</sup>')
local qty = fmtQty(l.qty) .. ' ' .. unitLabel(l.qty, l.unit)
local prep = l.prep ~= '' and (', <span class="rp-prep">' .. l.prep .. '</span>') or ''
local rules = ing and rulesFor(l.name, l.role) or {}
local swapCell = "''none''"
if #rules > 0 then
swapCell = '[[#Substitutions for this recipe|' .. #rules .. (#rules == 1 and ' option' or ' options') .. ']]'
table.insert(swapSections, { line = l, rules = rules })
end
add('|-\n| class="rp-qty" | ' .. trim(qty) .. '\n| ' .. link .. prep .. '\n| class="rp-role" | ' .. l.role .. '\n| ' .. swapCell)
end
add('|}')

add('== Instructions ==')
if instructions ~= '' then add(instructions)
else add("''No instructions yet.''") end

-- substitutions resolved for this recipe
if #swapSections > 0 then
add('== Substitutions for this recipe ==')
add('<p class="rp-note">Rules come from each ingredient\'s record and are resolved for the job the ingredient does in this recipe. Confidence is the community\'s, not a guarantee.</p>')
add('{| class="wikitable rp-subs"\n! Instead of !! Use !! How much !! What changes !! Confidence')
for _, s in ipairs(swapSections) do
for _, r in ipairs(s.rules) do
local useName = r.alt ~= '' and (r.alt .. ' ([[' .. r.sub_to .. ']])') or ('[[' .. r.sub_to .. ']]')
local howMuch
if r.conv ~= '' then howMuch = r.conv
else
local ratio = tonumber(r.ratio) or 1
local nq = s.line.qty and (s.line.qty * ratio) or nil
howMuch = nq and (fmtQty(nq) .. ' ' .. unitLabel(nq, s.line.unit) .. ' <small>(× ' .. ratio .. ')</small>') or ('× ' .. ratio)
end
local what = r.effect
if r.warning ~= '' then what = what .. '<br /><span class="rp-warn">⚠ ' .. r.warning .. '</span>' end
if r.roleSpecific then what = what .. ' <small class="rp-role-tag">rule for: ' .. s.line.role .. '</small>' end
add('|-\n| [[' .. s.line.name .. ']]\n| ' .. useName .. '\n| class="rp-qty" | ' .. howMuch .. '\n| ' .. what .. '\n| ' .. confBadge(r.confidence))
end
end
add('|}')
end

-- store rows (skipped when the page is being previewed inside another page)
if title.namespace == 0 then
for i, l in ipairs(lines) do
frame:callParserFunction('#cargo_store', {
'_table=RecipeIngredients', recipe = page, ingredient = l.name,
qty = l.qty and tostring(l.qty) or '', unit = l.unit, role = l.role, prep = l.prep, pos = tostring(i),
})
end
frame:callParserFunction('#cargo_store', {
'_table=Recipes', serves = tostring(serves), time = trim(args.time), tags = trim(args.tags),
contributor = trim(args.contributor), lede = description, method = instructions,
kcal_total = tostring(round(kcalTotal)), allergens = table.concat(allergens, ','), ingredient_count = tostring(#lines),
})
end

-- Categories belong to real recipe pages. Without this guard a /testcases
-- page that exercises the template would file itself under Category:Recipes
-- and every tag category it demonstrates.
if title.namespace == 0 then
local cats = { '[[Category:Recipes]]' }
for _, t in ipairs(splitList(args.tags)) do table.insert(cats, '[[Category:' .. t .. ']]') end
add(table.concat(cats, ''))
end
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- sale

function p.sale(frame)
local args = frame.args
local store = trim(args.store)
local where = store ~= '' and ("store='" .. sqlEsc(store) .. "'") or nil
local sale = cargo.query('SaleItems', 'ingredient,price,was,per,store', { where = where, limit = 200 })
if #sale == 0 then return "''No sale items have been entered yet. Add them with [[Template:SaleItem]].''" end
local onSale = {}
for _, s in ipairs(sale) do onSale[s.ingredient] = s end

local rows = cargo.query('RecipeIngredients=RI,Ingredients=I', 'RI.recipe=recipe,RI.ingredient=ingredient,I.pantry=pantry',
{ join = 'RI.ingredient=I._pageName', limit = 2000 })
local recipes, order = {}, {}
for _, r in ipairs(rows) do
if not recipes[r.recipe] then recipes[r.recipe] = { hits = {}, toBuy = 0, save = 0 }; table.insert(order, r.recipe) end
local rec = recipes[r.recipe]
local pantry = trim(r.pantry):lower() == 'yes'
if not pantry then
rec.toBuy = rec.toBuy + 1
local s = onSale[r.ingredient]
if s then
table.insert(rec.hits, r.ingredient)
rec.save = rec.save + ((tonumber(s.was) or 0) - (tonumber(s.price) or 0))
end
end
end
local ranked = {}
for _, name in ipairs(order) do
local rec = recipes[name]
if #rec.hits > 0 then rec.name = name; table.insert(ranked, rec) end
end
table.sort(ranked, function(a, b)
if #a.hits ~= #b.hits then return #a.hits > #b.hits end
return (#a.hits / math.max(1, a.toBuy)) > (#b.hits / math.max(1, b.toBuy))
end)

local out = { '{| class="wikitable rp-sale"\n! Recipe !! On sale !! Shopping list !! You save' }
for _, rec in ipairs(ranked) do
local links = {}
for _, h in ipairs(rec.hits) do table.insert(links, '[[' .. h .. ']]') end
table.insert(out, '|-\n| [[' .. rec.name .. ']]\n| ' .. table.concat(links, ', ') .. '\n| ' .. #rec.hits .. ' of ' .. rec.toBuy ..
' items <small>(pantry staples excluded)</small>\n| class="rp-qty" | $' .. string.format('%.2f', rec.save))
end
table.insert(out, '|}')
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- cookbook

local function chapterFor(tags)
local t = {}
for _, x in ipairs(splitList(tags)) do t[x:lower()] = true end
if t['breakfast'] then return 'Mornings' end
if t['dessert'] then return 'Sweets' end
if t['dinner'] or t['side'] or t['soup'] then return 'Suppers and sides' end
return 'Pantry and dressings'
end

function p.cookbook(frame)
local args = frame:getParent().args
local names = splitList(args.recipes)
local title = trim(args.title) ~= '' and trim(args.title) or 'Our kitchen'
local out = {}
local function add(s) table.insert(out, s) end

add('<div class="rp-book">')
add('<div class="rp-page rp-cover"><div class="rp-orn">✦</div><div class="rp-cover-title">' .. title .. '</div><div class="rp-cover-sub">' ..
#names .. (#names == 1 and ' recipe' or ' recipes') .. ' · assembled on Recipedius</div></div>')
if trim(args.dedication) ~= '' then
add('<div class="rp-page rp-dedication">' .. trim(args.dedication) .. '</div>')
end

-- gather
local recs, chapters, chapterOrder = {}, {}, {}
for _, n in ipairs(names) do
local r = cargo.query('Recipes', '_pageName=name,serves,time,tags,contributor,lede,method',
{ where = "_pageName='" .. sqlEsc(n) .. "'", limit = 1 })[1]
if r then
r.lines = cargo.query('RecipeIngredients', 'ingredient,qty,unit,prep,pos',
{ where = "recipe='" .. sqlEsc(n) .. "'", orderBy = 'pos', limit = 100 })
local ch = chapterFor(r.tags)
if not chapters[ch] then chapters[ch] = {}; table.insert(chapterOrder, ch) end
table.insert(chapters[ch], r)
else
add('<div class="rp-missing">No recipe page called "' .. n .. '" was found.</div>')
end
end

-- contents
add('<div class="rp-page rp-toc"><div class="rp-chap-label">Contents</div>')
for _, ch in ipairs(chapterOrder) do
add('<div class="rp-toc-chapter">' .. ch .. '</div>')
for _, r in ipairs(chapters[ch]) do add('<div class="rp-toc-row"><span>' .. r.name .. '</span><span>' .. r.time .. '</span></div>') end
end
add('</div>')

for _, ch in ipairs(chapterOrder) do
add('<div class="rp-page rp-chapter"><div class="rp-chap-label">Chapter</div><div class="rp-chapter-title">' .. ch .. '</div></div>')
for _, r in ipairs(chapters[ch]) do
add('<div class="rp-page rp-recipe-page"><div class="rp-chap-label">' .. ch .. '</div><div class="rp-recipe-title">' .. r.name .. '</div>')
if trim(r.lede) ~= '' then add("<div class=\"rp-lede\">''" .. r.lede .. "''</div>") end
add('<div class="rp-book-cols"><div class="rp-book-ings">')
for _, l in ipairs(r.lines) do
local q = tonumber(l.qty)
add('<div class="rp-book-ing"><span class="rp-qty">' .. fmtQty(q) .. ' ' .. unitLabel(q, l.unit) .. '</span><span>' .. countLabel(l.ingredient, q, l.unit) ..
(trim(l.prep) ~= '' and (', ' .. l.prep) or '') .. '</span></div>')
end
add('</div><div class="rp-book-method">\n' .. (r.method or '') .. '\n</div></div>')
add('<div class="rp-book-foot">Serves ' .. r.serves .. ' · ' .. r.time .. (trim(r.contributor) ~= '' and (' · contributed by ' .. r.contributor) or '') .. '</div></div>')
end
end
add('</div>')
return table.concat(out, '\n')
end

return p

Module:Recipedius

2026-09-24T13:37:03Z

Recipedius deploy: 0.012 T009: deploy working form entry points (6e8250e)

--[[
Module:Recipedius
The computed layer of Recipedius. Reads ingredient records and substitution rules
from Cargo tables and renders recipe pages, the weekly sale ranking, and cookbooks.

Entry points (all via {{#invoke:Recipedius|fn}} from templates):
recipe - renders a recipe from Template:Recipe args and stores its rows
sale - ranks recipes by how many of their shopping items are on sale
cookbook - renders a printable book from a list of recipe pages
]]

local p = {}
local cargo = mw.ext.cargo

-- ---------------------------------------------------------------- helpers

local FRACTIONS = {
{ 0.125, '⅛' }, { 0.25, '¼' }, { 1/3, '⅓' }, { 0.375, '⅜' }, { 0.5, '½' },
{ 0.625, '⅝' }, { 2/3, '⅔' }, { 0.75, '¾' }, { 0.875, '⅞' },
}
local FRACTION_CHARS = { ['⅛']=0.125, ['¼']=0.25, ['⅓']=1/3, ['⅜']=0.375, ['½']=0.5, ['⅝']=0.625, ['⅔']=2/3, ['¾']=0.75, ['⅞']=0.875 }

local function trim(s) return mw.text.trim(s or '') end

-- "1 1/2", "3/4", "0.5", "1 ½" and "¾" all parse.
local function parseQty(s)
s = trim(s)
local total, found = 0, false
for tok in s:gmatch('%S+') do
if FRACTION_CHARS[tok] then total = total + FRACTION_CHARS[tok]; found = true
else
local a, b = tok:match('^(%d+)/(%d+)$')
if a then total = total + tonumber(a) / tonumber(b); found = true
elseif tonumber(tok) then total = total + tonumber(tok); found = true end
end
end
if found then return total end
return nil
end

local function fmtQty(q)
if not q then return '' end
local w = math.floor(q + 1e-6)
local f = q - w
if f > 0.94 then w = w + 1; f = 0 end
local fs = ''
if f > 0.06 then
local best, bd = nil, 1
for _, pair in ipairs(FRACTIONS) do
local d = math.abs(pair[1] - f)
if d < bd then bd = d; best = pair[2] end
end
if bd < 0.06 then fs = best else fs = string.format('%.2f', f):gsub('^0', '') end
end
if w == 0 then return fs ~= '' and fs or '0' end
if fs ~= '' then return w .. ' ' .. fs end
return tostring(w)
end

local PLURALS = { ['Garlic'] = 'Garlic cloves', ['Whole chicken'] = 'Whole chickens', ['Russet potato'] = 'Russet potatoes' }
-- Display name for a count-based ingredient: "2 eggs", "3 bananas", "6 garlic cloves".
local function countLabel(name, q, u)
if u ~= 'each' or not q or q <= 1 then return name end
if PLURALS[name] then return PLURALS[name] end
if name:sub(-1) == 's' then return name end
return name .. 's'
end

local function unitLabel(q, u)
if u == 'each' or u == '' then return '' end
if u == 'cup' and q and q > 1 then return 'cups' end
return u
end

local function sqlEsc(s) return (tostring(s):gsub("'", "\\'")) end

local function splitList(s)
local out = {}
for item in (s or ''):gmatch('[^,]+') do
item = trim(item)
if item ~= '' then table.insert(out, item) end
end
return out
end

local function round(x) return math.floor(x + 0.5) end

-- ---------------------------------------------------------------- data access

local ingredientCache = {}
local function getIngredient(name)
if ingredientCache[name] ~= nil then return ingredientCache[name] or nil end
local rows = cargo.query('Ingredients',
'_pageName=name,kcal100,g_tsp,g_tbsp,g_cup,g_each,allergens,pantry,price,price_per',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
ingredientCache[name] = rows[1] or false
return rows[1]
end

local recipeCache = {}
local function getRecipe(name)
if recipeCache[name] ~= nil then return recipeCache[name] or nil end
local rows = cargo.query('Recipes', '_pageName=name',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
recipeCache[name] = rows[1] or false
return rows[1]
end

local function gramsPer(ing, unit)
if not ing then return nil end
local key = ({ tsp = 'g_tsp', tbsp = 'g_tbsp', cup = 'g_cup', each = 'g_each' })[unit]
if not key then return nil end
return tonumber(ing[key])
end

local function kcalOf(ing, q, unit)
local g = gramsPer(ing, unit)
local k = ing and tonumber(ing.kcal100)
if not (g and k and q) then return 0 end
return q * g * k / 100
end

-- Substitution rules for an ingredient, resolved for the role it plays in this recipe.
-- A base row (role blank) applies everywhere; a row with a role overrides the base for that role.
-- An override with applicable=no removes the option for that role.
local subsCache = {}
local function rulesFor(name, role)
if not subsCache[name] then
subsCache[name] = cargo.query('Substitutions',
'sub_to,alt,role,ratio,conv,confidence,effect,warning,applicable',
{ where = "sub_from='" .. sqlEsc(name) .. "'", orderBy = 'sub_to', limit = 200 })
end
local groups, order = {}, {}
for _, r in ipairs(subsCache[name]) do
local key = (r.sub_to or '') .. '|' .. (r.alt or '')
if not groups[key] then groups[key] = {}; table.insert(order, key) end
if trim(r.role) == '' then groups[key].base = r
elseif trim(r.role) == role then groups[key].override = r end
end
local out = {}
for _, key in ipairs(order) do
local b, o = groups[key].base, groups[key].override
local blocked = o and trim(o.applicable):lower() == 'no'
if (b or o) and not blocked then
local m = {}
for _, k in ipairs({ 'sub_to', 'alt', 'ratio', 'conv', 'confidence', 'effect', 'warning' }) do
local ov = o and trim(o[k]) or ''
if ov ~= '' then m[k] = ov elseif b then m[k] = trim(b[k]) else m[k] = '' end
end
if m.warning == 'none' then m.warning = '' end
m.roleSpecific = o ~= nil
table.insert(out, m)
end
end
return out
end

-- ---------------------------------------------------------------- recipe

-- Ingredient lines are written one per line as: Ingredient; quantity; unit; role; preparation
local function parseLines(text)
local lines = {}
for raw in (text or ''):gmatch('[^\r\n]+') do
raw = trim(raw)
if raw ~= '' and not raw:match('^<!%-%-') then
local parts = mw.text.split(raw, ';', true)
local name = trim(parts[1] or '')
if name ~= '' then
table.insert(lines, {
name = name,
qty = parseQty(parts[2] or ''),
unit = trim(parts[3] or ''),
role = trim(parts[4] or ''),
prep = trim(parts[5] or ''),
})
end
end
end
return lines
end

local function resolvedArg(args, preferred, legacy)
local value = trim(args[preferred])
if value ~= '' then return value end
return trim(args[legacy])
end

local CONF_DOTS = { high = '●●●', medium = '●●○', low = '●○○' }
local function confBadge(c)
c = trim(c):lower()
return '<span class="rp-conf rp-conf-' .. c .. '" title="confidence: ' .. c .. '">' .. (CONF_DOTS[c] or '○○○') .. ' ' .. c .. '</span>'
end

function p.recipe(frame)
local args = frame:getParent().args
local title = mw.title.getCurrentTitle()
local page = title.prefixedText
local serves = tonumber(args.serves) or 1
local description = resolvedArg(args, 'description', 'lede')
local instructions = resolvedArg(args, 'instructions', 'method')
local lines = parseLines(args.ingredients)

-- totals from the ingredient records
local kcalTotal, allergens, seen, missing = 0, {}, {}, {}
for _, l in ipairs(lines) do
local ing = getIngredient(l.name)
if ing then
kcalTotal = kcalTotal + kcalOf(ing, l.qty, l.unit)
for _, a in ipairs(splitList(ing.allergens)) do
if not seen[a] then seen[a] = true; table.insert(allergens, a) end
end
elseif not getRecipe(l.name) then
table.insert(missing, l.name)
end
end

local out = {}
local function add(s) table.insert(out, s) end

-- infobox
add('{| class="wikitable rp-infobox"\n|+ ' .. page)
add('|-\n! Serves\n| ' .. serves)
if trim(args.time) ~= '' then add('|-\n! Time\n| ' .. trim(args.time)) end
add('|-\n! Per serving\n| <b>' .. round(kcalTotal / serves) .. ' kcal</b> <small>(' .. round(kcalTotal) .. ' for the batch)</small>')
add('|-\n! Contains\n| ' .. (#allergens > 0 and table.concat(allergens, ', ') or "''nothing flagged''"))
if trim(args.contributor) ~= '' then add('|-\n! Contributed by\n| ' .. trim(args.contributor)) end
if trim(args.tags) ~= '' then
local tagLinks = {}
for _, t in ipairs(splitList(args.tags)) do table.insert(tagLinks, '[[:Category:' .. t .. '|' .. t .. ']]') end
add('|-\n! Tags\n| ' .. table.concat(tagLinks, ' · '))
end
add('|-\n| colspan="2" | <small>Calories are computed from the [[:Category:Ingredients|ingredient records]]. Approximate.</small>')
add('|}')

add('== Description ==')
if description ~= '' then add("<div class=\"rp-lede\">''" .. description .. "''</div>")
else add("''No description yet.''") end

if #missing > 0 then
-- Each name links to the ingredient form already targeted at that title, so
-- a contributor lands on the right form rather than being asked for a name
-- the page already knows. A bare Special:FormEdit link has no target and
-- answers "No target page specified".
local createLinks = {}
for _, name in ipairs(missing) do
table.insert(createLinks, '[[Special:FormEdit/Ingredient/' .. name .. '|' .. name .. ']]')
end
add('<div class="rp-missing">These ingredients have no record yet, so they are left out of the nutrition and substitution tables: ' ..
table.concat(createLinks, ', ') .. '. Follow a name to create its record.</div>')
end

-- ingredients table
add('== Ingredients ==')
add('{| class="wikitable rp-ingredients"\n! Quantity !! Ingredient !! Its job here !! Swaps')
local swapSections = {}
for i, l in ipairs(lines) do
local ing = getIngredient(l.name)
local shown = countLabel(l.name, l.qty, l.unit)
local isRecipe = not ing and getRecipe(l.name)
local link = (ing or isRecipe) and ('[[' .. l.name .. '|' .. shown .. ']]') or ('[[' .. l.name .. '|' .. shown .. ']]<sup class="rp-missing-mark">?</sup>')
local qty = fmtQty(l.qty) .. ' ' .. unitLabel(l.qty, l.unit)
local prep = l.prep ~= '' and (', <span class="rp-prep">' .. l.prep .. '</span>') or ''
local rules = ing and rulesFor(l.name, l.role) or {}
local swapCell = "''none''"
if #rules > 0 then
swapCell = '[[#Substitutions for this recipe|' .. #rules .. (#rules == 1 and ' option' or ' options') .. ']]'
table.insert(swapSections, { line = l, rules = rules })
end
add('|-\n| class="rp-qty" | ' .. trim(qty) .. '\n| ' .. link .. prep .. '\n| class="rp-role" | ' .. l.role .. '\n| ' .. swapCell)
end
add('|}')

add('== Instructions ==')
if instructions ~= '' then add(instructions)
else add("''No instructions yet.''") end

-- substitutions resolved for this recipe
if #swapSections > 0 then
add('== Substitutions for this recipe ==')
add('<p class="rp-note">Rules come from each ingredient\'s record and are resolved for the job the ingredient does in this recipe. Confidence is the community\'s, not a guarantee.</p>')
add('{| class="wikitable rp-subs"\n! Instead of !! Use !! How much !! What changes !! Confidence')
for _, s in ipairs(swapSections) do
for _, r in ipairs(s.rules) do
local useName = r.alt ~= '' and (r.alt .. ' ([[' .. r.sub_to .. ']])') or ('[[' .. r.sub_to .. ']]')
local howMuch
if r.conv ~= '' then howMuch = r.conv
else
local ratio = tonumber(r.ratio) or 1
local nq = s.line.qty and (s.line.qty * ratio) or nil
howMuch = nq and (fmtQty(nq) .. ' ' .. unitLabel(nq, s.line.unit) .. ' <small>(× ' .. ratio .. ')</small>') or ('× ' .. ratio)
end
local what = r.effect
if r.warning ~= '' then what = what .. '<br /><span class="rp-warn">⚠ ' .. r.warning .. '</span>' end
if r.roleSpecific then what = what .. ' <small class="rp-role-tag">rule for: ' .. s.line.role .. '</small>' end
add('|-\n| [[' .. s.line.name .. ']]\n| ' .. useName .. '\n| class="rp-qty" | ' .. howMuch .. '\n| ' .. what .. '\n| ' .. confBadge(r.confidence))
end
end
add('|}')
end

-- store rows (skipped when the page is being previewed inside another page)
if title.namespace == 0 then
for i, l in ipairs(lines) do
frame:callParserFunction('#cargo_store', {
'_table=RecipeIngredients', recipe = page, ingredient = l.name,
qty = l.qty and tostring(l.qty) or '', unit = l.unit, role = l.role, prep = l.prep, pos = tostring(i),
})
end
frame:callParserFunction('#cargo_store', {
'_table=Recipes', serves = tostring(serves), time = trim(args.time), tags = trim(args.tags),
contributor = trim(args.contributor), lede = description, method = instructions,
kcal_total = tostring(round(kcalTotal)), allergens = table.concat(allergens, ','), ingredient_count = tostring(#lines),
})
end

-- Categories belong to real recipe pages. Without this guard a /testcases
-- page that exercises the template would file itself under Category:Recipes
-- and every tag category it demonstrates.
if title.namespace == 0 then
local cats = { '[[Category:Recipes]]' }
for _, t in ipairs(splitList(args.tags)) do table.insert(cats, '[[Category:' .. t .. ']]') end
add(table.concat(cats, ''))
end
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- sale

function p.sale(frame)
local args = frame.args
local store = trim(args.store)
local where = store ~= '' and ("store='" .. sqlEsc(store) .. "'") or nil
local sale = cargo.query('SaleItems', 'ingredient,price,was,per,store', { where = where, limit = 200 })
if #sale == 0 then return "''No sale items have been entered yet. Add them with [[Template:SaleItem]].''" end
local onSale = {}
for _, s in ipairs(sale) do onSale[s.ingredient] = s end

local rows = cargo.query('RecipeIngredients=RI,Ingredients=I', 'RI.recipe=recipe,RI.ingredient=ingredient,I.pantry=pantry',
{ join = 'RI.ingredient=I._pageName', limit = 2000 })
local recipes, order = {}, {}
for _, r in ipairs(rows) do
if not recipes[r.recipe] then recipes[r.recipe] = { hits = {}, toBuy = 0, save = 0 }; table.insert(order, r.recipe) end
local rec = recipes[r.recipe]
local pantry = trim(r.pantry):lower() == 'yes'
if not pantry then
rec.toBuy = rec.toBuy + 1
local s = onSale[r.ingredient]
if s then
table.insert(rec.hits, r.ingredient)
rec.save = rec.save + ((tonumber(s.was) or 0) - (tonumber(s.price) or 0))
end
end
end
local ranked = {}
for _, name in ipairs(order) do
local rec = recipes[name]
if #rec.hits > 0 then rec.name = name; table.insert(ranked, rec) end
end
table.sort(ranked, function(a, b)
if #a.hits ~= #b.hits then return #a.hits > #b.hits end
return (#a.hits / math.max(1, a.toBuy)) > (#b.hits / math.max(1, b.toBuy))
end)

local out = { '{| class="wikitable rp-sale"\n! Recipe !! On sale !! Shopping list !! You save' }
for _, rec in ipairs(ranked) do
local links = {}
for _, h in ipairs(rec.hits) do table.insert(links, '[[' .. h .. ']]') end
table.insert(out, '|-\n| [[' .. rec.name .. ']]\n| ' .. table.concat(links, ', ') .. '\n| ' .. #rec.hits .. ' of ' .. rec.toBuy ..
' items <small>(pantry staples excluded)</small>\n| class="rp-qty" | $' .. string.format('%.2f', rec.save))
end
table.insert(out, '|}')
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- cookbook

local function chapterFor(tags)
local t = {}
for _, x in ipairs(splitList(tags)) do t[x:lower()] = true end
if t['breakfast'] then return 'Mornings' end
if t['dessert'] then return 'Sweets' end
if t['dinner'] or t['side'] or t['soup'] then return 'Suppers and sides' end
return 'Pantry and dressings'
end

function p.cookbook(frame)
local args = frame:getParent().args
local names = splitList(args.recipes)
local title = trim(args.title) ~= '' and trim(args.title) or 'Our kitchen'
local out = {}
local function add(s) table.insert(out, s) end

add('<div class="rp-book">')
add('<div class="rp-page rp-cover"><div class="rp-orn">✦</div><div class="rp-cover-title">' .. title .. '</div><div class="rp-cover-sub">' ..
#names .. (#names == 1 and ' recipe' or ' recipes') .. ' · assembled on Recipedius</div></div>')
if trim(args.dedication) ~= '' then
add('<div class="rp-page rp-dedication">' .. trim(args.dedication) .. '</div>')
end

-- gather
local recs, chapters, chapterOrder = {}, {}, {}
for _, n in ipairs(names) do
local r = cargo.query('Recipes', '_pageName=name,serves,time,tags,contributor,lede,method',
{ where = "_pageName='" .. sqlEsc(n) .. "'", limit = 1 })[1]
if r then
r.lines = cargo.query('RecipeIngredients', 'ingredient,qty,unit,prep,pos',
{ where = "recipe='" .. sqlEsc(n) .. "'", orderBy = 'pos', limit = 100 })
local ch = chapterFor(r.tags)
if not chapters[ch] then chapters[ch] = {}; table.insert(chapterOrder, ch) end
table.insert(chapters[ch], r)
else
add('<div class="rp-missing">No recipe page called "' .. n .. '" was found.</div>')
end
end

-- contents
add('<div class="rp-page rp-toc"><div class="rp-chap-label">Contents</div>')
for _, ch in ipairs(chapterOrder) do
add('<div class="rp-toc-chapter">' .. ch .. '</div>')
for _, r in ipairs(chapters[ch]) do add('<div class="rp-toc-row"><span>' .. r.name .. '</span><span>' .. r.time .. '</span></div>') end
end
add('</div>')

for _, ch in ipairs(chapterOrder) do
add('<div class="rp-page rp-chapter"><div class="rp-chap-label">Chapter</div><div class="rp-chapter-title">' .. ch .. '</div></div>')
for _, r in ipairs(chapters[ch]) do
add('<div class="rp-page rp-recipe-page"><div class="rp-chap-label">' .. ch .. '</div><div class="rp-recipe-title">' .. r.name .. '</div>')
if trim(r.lede) ~= '' then add("<div class=\"rp-lede\">''" .. r.lede .. "''</div>") end
add('<div class="rp-book-cols"><div class="rp-book-ings">')
for _, l in ipairs(r.lines) do
local q = tonumber(l.qty)
add('<div class="rp-book-ing"><span class="rp-qty">' .. fmtQty(q) .. ' ' .. unitLabel(q, l.unit) .. '</span><span>' .. countLabel(l.ingredient, q, l.unit) ..
(trim(l.prep) ~= '' and (', ' .. l.prep) or '') .. '</span></div>')
end
add('</div><div class="rp-book-method">\n' .. (r.method or '') .. '\n</div></div>')
add('<div class="rp-book-foot">Serves ' .. r.serves .. ' · ' .. r.time .. (trim(r.contributor) ~= '' and (' · contributed by ' .. r.contributor) or '') .. '</div></div>')
end
end
add('</div>')
return table.concat(out, '\n')
end

return p

This week's sale

2026-09-23T19:28:27Z

Recipedius deploy: Protected "This week's sale": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Recipes ranked by how many of their shopping-list items are on sale this week. Pantry staples (salt, flour, sugar, soda, vanilla) don't count, because nobody buys them for one recipe.

Sale items come from [[Sale/Oak & Fair Market]], an example retailer. A real grocery partner would feed that page from its promotions system, and the handoff at the end is a shopping partner such as Instacart or the store's own pickup.

== What to cook ==
{{#invoke:Recipedius|sale|store=Oak & Fair Market}}

== On sale now ==
{{#cargo_query:tables=SaleItems
|fields=ingredient=Ingredient,price=Sale price,was=Was,per=Per,week=Week of
|where=store='Oak & Fair Market'
|order by=ingredient
|format=table
}}

Recipedius:About

2026-09-23T19:28:27Z

Recipedius deploy: Protected "Recipedius:About": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Recipedius is a sandbox exploration of a twenty-year-old idea: Wikipedia, but for recipes, where every ingredient is a record that recipes link to instead of a word they retype.

This wiki is the second prototype. The first was a single-page mock-up; this one runs on MediaWiki with the Cargo, Scribunto and Page Forms extensions, because most of what the idea needs already exists here: revision history, attribution, talk pages, upload licensing, categories, and structured data with queries.

== How the pieces fit ==
; Ingredient layer
: [[Template:Ingredient]] is the record: form, role, storage, season, allergens, price, grams per unit, kcal per 100 g. It stores to the <code>Ingredients</code> table.
; Recipe layer
: [[Template:Recipe]] takes ingredient lines (<code>Ingredient; quantity; unit; role; preparation</code>) and hands them to [[Module:Recipedius]], which computes calories and allergens from the records, resolves substitutions for each line's role, renders the page, and stores rows to <code>Recipes</code> and <code>RecipeIngredients</code>.
; Substitution layer
: [[Template:Substitution]] rows live on the page of the ingredient being replaced. A blank-role row applies everywhere; a role row overrides it. <code>applicable=no</code> removes an option for a role.
; Commerce layer
: [[Template:SaleItem]] rows on a <code>Sale/Store</code> page. [[This week's sale]] joins them to recipe ingredients and ranks recipes, excluding pantry staples.
; Collection layer
: [[Template:Cookbook]] renders a book from the database with a print stylesheet. Print-on-demand is the next step (the Collection extension, or a PDF export to a printer).
; Contribution layer
: MediaWiki itself: every edit has a history and an author, every upload carries a license, and moderation extensions (FlaggedRevs, Moderation, AbuseFilter) bolt on when needed.

== What's illustrative ==
Nutrition values are USDA-style approximations entered by hand, not licensed data. Prices, the store, contributor names and the sample cookbook are examples. Nothing here is dietary advice.

== Where to dig ==
* [[Special:CargoTables]] shows every table and its rows.
* [[Special:Drilldown]] filters recipes and ingredients by any field.
* [[Special:Version]] lists the extensions in use.

Main Page

2026-09-23T19:28:26Z

Recipedius deploy: Protected "Main Page": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<div class="rp-main-layout">
<div class="rp-main-actions">
== Add to Recipedius ==
* [[Special:FormEdit/Recipe|Add recipe]]
* [[Special:FormEdit/Ingredient|Add ingredient]]
</div>
<div class="rp-main-content">
<div class="rp-lede">'''Recipedius''' is an encyclopedia of what's in your kitchen. Every recipe is built from ingredient records, not text: swap the butter and the calories, allergens and shopping list follow. Put lemons on sale and the recipes that use them float to the top. Pick your favorites and turn them into a printed book.</div>

'''Start here:''' open [[Classic shortbread]] and look at the substitution table, then [[Banana bread]]; the same olive-oil swap is low-confidence in one and high in the other, because the butter's job is different. That is the whole idea in one click. Then see [[This week's sale]] and [[Cookbook/Sample]].

== Recipes ==
{{#cargo_query:tables=Recipes
|fields=_pageName=Recipe,serves=Serves,time=Time,ROUND(kcal_total/serves)=kcal per serving,allergens=Contains,contributor=Contributed by
|order by=_pageName
|format=table
}}
''Add one: [[Special:FormEdit/Recipe|create a recipe with the form]], or make a page and use [[Template:Recipe]].''

== Ingredient records ==
{{#cargo_query:tables=Ingredients
|fields=_pageName=Ingredient,role=Role,ROUND(g_tbsp*kcal100/100)=kcal per tbsp,allergens=Allergens
|order by=_pageName
|format=table
}}
''Add one: [[Special:FormEdit/Ingredient|create an ingredient record with the form]].''

== Elsewhere ==
* [[This week's sale]] — recipes ranked by what's cheap at an example store
* [[Cookbook/Sample]] — a printable book assembled from the recipe database
* [[Special:CargoTables]] — the database behind the pages
* [[Recipedius:About]] — what this is, what's real and what's still to build
</div>
</div>

Category:Techniques

2026-09-23T19:28:26Z

Recipedius deploy: Protected "Category:Techniques": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Cooking methods, preparations, and foundational skills. Add a page with
[[Template:Technique]] to include it here.

Category:Recipes by tag

2026-09-23T19:28:26Z

Recipedius deploy: Protected "Category:Recipes by tag": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

One category per tag used in [[Template:Recipe]].

Category:Recipes

2026-09-23T19:28:26Z

Recipedius deploy: Protected "Category:Recipes": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Every recipe on Recipedius. {{#default_form:Recipe}}

Category:Recipedius templates

2026-09-23T19:28:26Z

Recipedius deploy: Protected "Category:Recipedius templates": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

The templates and module that make Recipedius work. Start with [[Recipedius:About]].

Category:Ingredients

2026-09-23T19:28:26Z

Recipedius deploy: Protected "Category:Ingredients": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Every ingredient record on Recipedius. {{#default_form:Ingredient}}

Category:Cookbooks

2026-09-23T19:28:26Z

Recipedius deploy: Protected "Category:Cookbooks": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Books assembled from the recipe database with [[Template:Cookbook]].

Form:Recipe

2026-09-23T19:28:26Z

Recipedius deploy: Protected "Form:Recipe": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
This is the form for creating a recipe. Enter a title below.
{{#forminput:form=Recipe|autocomplete on category=Recipes}}
</noinclude><includeonly>
{{{for template|Recipe}}}
{| class="formtable"
! Serves:
| {{{field|serves|input type=text|size=4}}}
|-
! Time:
| {{{field|time|size=20|placeholder=50 min}}}
|-
! Tags (comma-separated):
| {{{field|tags|size=40|placeholder=dessert, baking, cookie}}}
|-
! Contributed by:
| {{{field|contributor|size=30}}}
|-
! Description:
| {{{field|lede|input type=textarea|rows=2|cols=70}}}
|-
! Ingredients:<br /><small>One per line: Ingredient; quantity; unit; role; preparation<br />e.g. Butter; 1; cup; creaming; softened</small>
| {{{field|ingredients|input type=textarea|rows=10|cols=70}}}
|-
! Instructions:<br /><small>Numbered steps, one per line, starting with #</small>
| {{{field|method|input type=textarea|rows=10|cols=70}}}
|}
{{{end template}}}
'''Edit summary:''' {{{standard input|summary}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|cancel}}}
</includeonly>

Form:Ingredient

2026-09-23T19:28:25Z

Recipedius deploy: Protected "Form:Ingredient": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
This is the form for creating an ingredient record. Enter the ingredient's name below.
{{#forminput:form=Ingredient|autocomplete on category=Ingredients}}
</noinclude><includeonly>
{{{for template|Ingredient}}}
{| class="formtable"
! Form:
| {{{field|form|size=40|placeholder=Unsalted, solid}}}
|-
! Role in the kitchen:
| {{{field|role|size=40|placeholder=Fat · structure, flavor, creaming}}}
|-
! Storage:
| {{{field|storage|size=40}}}
|-
! Season:
| {{{field|season|size=40}}}
|-
! kcal per 100 g:
| {{{field|kcal100|size=6}}}
|-
! Grams per teaspoon / tablespoon / cup / each:
| {{{field|g_tsp|size=5}}} {{{field|g_tbsp|size=5}}} {{{field|g_cup|size=5}}} {{{field|g_each|size=5}}}
|-
! Allergens (comma-separated):
| {{{field|allergens|size=40|placeholder=dairy}}}
|-
! Pantry staple (left off shopping lists)?
| {{{field|pantry|input type=dropdown|values=no,yes}}}
|-
! Typical price and unit:
| ${{{field|price|size=6}}} per {{{field|price_per|size=10|placeholder=1 lb}}}
|-
! Description:
| {{{field|summary|input type=textarea|rows=5|cols=70}}}
|}
{{{end template}}}
{{{standard input|free text|rows=8|cols=70}}}
<small>Add substitution rules in the free-text area with [[Template:Substitution]].</small>

'''Edit summary:''' {{{standard input|summary}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|cancel}}}
</includeonly>

MediaWiki:Print.css

2026-09-23T19:28:25Z

Recipedius deploy: Protected "MediaWiki:Print.css": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

/* Cookbook print layout: one recipe per page */
.rp-page { page-break-after: always; break-after: page; border: 0; box-shadow: none; min-height: 0; padding: 0; margin: 0; background: #fff; color: #000; }
.rp-cover { background: #2e3a2a !important; color: #f3efd8 !important; -webkit-print-color-adjust: exact; print-color-adjust: exact; min-height: 90vh; }
.rp-book-cols { display: grid; grid-template-columns: 1fr 1.4fr; gap: 24px; }
.rp-infobox { float: none; width: auto; }

MediaWiki:Common.css

2026-09-23T19:28:25Z

Recipedius deploy: Protected "MediaWiki:Common.css": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

/* Recipedius styling */
.rp-infobox { float: right; clear: right; margin: 0 0 1em 1.5em; width: 300px; font-size: 0.92em; }
.rp-infobox caption { font-weight: bold; font-size: 1.1em; padding: 0.4em; }
.rp-infobox th { text-align: left; width: 38%; }
.rp-lede { font-size: 1.15em; margin: 0.5em 0 1em; max-width: 65ch; }
.rp-qty { font-family: ui-monospace, Menlo, Consolas, monospace; font-size: 0.92em; white-space: nowrap; font-variant-numeric: tabular-nums; }
.rp-was { text-decoration: line-through; color: #72777d; }
.rp-prep { color: #54595d; }
.rp-role { color: #54595d; font-size: 0.9em; }
.rp-warn { color: #b32424; }
.rp-note { color: #54595d; max-width: 70ch; }
.rp-role-tag { color: #6b4fbb; }
.rp-missing { background: #fef6e7; border-left: 4px solid #edab00; padding: 0.5em 1em; margin: 0.8em 0; }
.rp-missing-mark { color: #b32424; }
.rp-conf { white-space: nowrap; font-size: 0.85em; letter-spacing: 0.02em; }
.rp-conf-high { color: #14866d; }
.rp-conf-medium { color: #ac6600; }
.rp-conf-low { color: #b32424; }
.rp-ingredients, .rp-subs, .rp-sale, .rp-rules { width: 100%; }
.rp-subs td:nth-child(3) { white-space: normal; width: 18%; }
.rp-subs td:nth-child(4) { width: 46%; }
.rp-subs .rp-qty, .rp-rules .rp-qty { white-space: normal; }

/* Main Page actions */
.rp-main-layout { display: grid; grid-template-columns: minmax(11rem, 0.28fr) minmax(0, 1fr); gap: 1.5rem; align-items: start; }
.rp-main-actions { background: #f8f9fa; border: 1px solid #c8ccd1; padding: 1rem; }
.rp-main-actions h2 { border: 0; font-size: 1.1em; margin: 0 0 0.65rem; padding: 0; }
.rp-main-actions ul { list-style: none; margin: 0; }
.rp-main-actions li + li { margin-top: 0.5rem; }
.rp-main-actions a { font-weight: bold; }

/* Cookbook */
.rp-book { max-width: 820px; }
.rp-page { background: #fbfaf4; color: #22251c; border: 1px solid #ddd; padding: 40px 48px; margin: 0 0 18px; min-height: 420px; position: relative; box-shadow: 0 2px 8px rgba(0,0,0,0.06); }
.rp-cover { background: #2e3a2a; color: #f3efd8; text-align: center; display: flex; flex-direction: column; justify-content: center; align-items: center; gap: 12px; min-height: 380px; }
.rp-orn { width: 44px; height: 44px; border-radius: 50%; border: 2px solid #e2a600; display: grid; place-items: center; font-size: 1.2em; }
.rp-cover-title { font-size: 2.4em; font-weight: bold; line-height: 1.05; }
.rp-cover-sub { font-style: italic; opacity: 0.8; }
.rp-dedication { display: flex; align-items: center; justify-content: center; text-align: center; font-style: italic; font-size: 1.2em; }
.rp-chapter { display: flex; flex-direction: column; justify-content: center; align-items: center; text-align: center; }
.rp-chapter-title { font-size: 2em; font-weight: bold; }
.rp-chap-label { font-size: 0.75em; text-transform: uppercase; letter-spacing: 0.12em; color: #7a7c6e; margin-bottom: 10px; }
.rp-recipe-title { font-size: 1.7em; font-weight: bold; margin-bottom: 4px; }
.rp-toc-chapter { font-weight: bold; margin-top: 10px; }
.rp-toc-row { display: flex; justify-content: space-between; border-bottom: 1px dotted #c9c7b4; padding: 3px 0; }
.rp-book-cols { display: grid; grid-template-columns: 1fr 1.4fr; gap: 28px; margin-top: 14px; }
.rp-book-ing { display: grid; grid-template-columns: 5em 1fr; gap: 8px; padding: 2px 0; font-size: 0.95em; }
.rp-book-method ol { margin-left: 1.2em; }
.rp-book-foot { margin-top: 18px; font-size: 0.8em; color: #7a7c6e; border-top: 1px solid #ddd; padding-top: 8px; }
@media (max-width: 720px) { .rp-book-cols, .rp-main-layout { grid-template-columns: 1fr; } .rp-infobox { float: none; width: auto; margin: 0 0 1em; } }

Template:Technique/testcases

2026-09-23T19:28:25Z

Recipedius deploy: Protected "Template:Technique/testcases": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

== Complete parameters ==

{{Technique/sandbox
|summary=Whisking oil gradually into an acid-based liquid so it stays suspended.
|purpose=Create a stable, glossy dressing or sauce.
|time=2–5 minutes
|heat=No heat
|equipment=[[Whisk]], [[Mixing bowl]]
|ingredients=[[Olive oil]], [[Lemon]]
|related=[[Lemon vinaigrette]]
|safety=Keep cold emulsions refrigerated.
}}

== Required parameter only ==

{{Technique/sandbox
|summary=Fold a light ingredient into a heavier mixture while preserving as much air as possible.
}}

The partial example must render only its title and Summary row; no empty
optional rows should appear.

Template:Recipe/testcases

2026-09-23T19:28:25Z

Recipedius deploy: Protected "Template:Recipe/testcases": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Cases for [[Template:Recipe/sandbox]]. Each one states what it is meant to
show. Check them after any change to the recipe template or to
[[Module:Recipedius]], and before that change is committed for deployment.

== Preferred parameter names ==

{{Recipe/sandbox
|serves=24
|time=50 min
|tags=dessert, baking
|contributor=Testcases
|description=Written with the preferred <code>description</code> and <code>instructions</code> names.
|ingredients=
Butter; 1; cup; creaming; softened
Granulated sugar; 1/2; cup; sweet
All-purpose flour; 2; cup; structure
|instructions=
# Beat the butter and sugar until pale.
# Stir in the flour.
}}

Must render Description, Ingredients and Instructions in that order, with the
substitution section after Instructions.

== Legacy parameter names ==

{{Recipe/sandbox
|serves=24
|time=50 min
|contributor=Testcases
|lede=Written with the legacy <code>lede</code> and <code>method</code> names.
|ingredients=
Butter; 1; cup; creaming
|method=
# Melt the butter.
}}

Must render identically in structure to the case above. Existing pages and the
Page Forms still use these names.

== Preferred name wins over legacy ==

{{Recipe/sandbox
|serves=1
|description=This preferred description must be the one shown.
|lede=This legacy lede must not appear.
|ingredients=
Butter; 1; tbsp; melted
|instructions=
# These preferred instructions must be the ones shown.
|method=
# This legacy method must not appear.
}}

== Ingredient link resolution ==

{{Recipe/sandbox
|serves=2
|description=Three kinds of ingredient line.
|ingredients=
Butter; 1; cup; creaming
Classic shortbread; 1; each; inclusion
Nonexistent ingredient page; 1; cup; structure
|instructions=
# Nothing to do.
}}

The first line names an ingredient record and must be a plain internal link
that contributes calories and allergens. The second names an existing recipe
and must also be a plain internal link, with no missing marker. The third names
a page that does not exist: it must be a red link, carry the missing marker,
and appear in the missing-nutrition warning above.

== No description and no instructions ==

{{Recipe/sandbox
|serves=1
|ingredients=
Butter; 1; tbsp
}}

Both headings must still appear, each with its placeholder text, so the page
shape is predictable while a recipe is being written.

== Empty call ==

{{Recipe/sandbox}}

Must not raise a script error.
<noinclude>[[Category:Recipedius templates]]</noinclude>

Template:Ingredient/testcases

2026-09-23T19:28:25Z

Recipedius deploy: Protected "Template:Ingredient/testcases": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Cases for [[Template:Ingredient/sandbox]]. Each one states what it is meant to
show. Check them after any change to the ingredient template, and before that
change is committed for deployment.

The sandbox does not write Cargo rows, so the "Used in" and "Can stand in for"
sections below query against this page's title and will be empty. That is
expected here and is not a failure.

== Preferred parameter name ==

{{Ingredient/sandbox
|form=Unsalted, solid
|role=Fat · structure, flavor
|storage=Fridge, 1–3 months
|season=Year-round
|kcal100=717
|g_tsp=4.7 |g_tbsp=14.2 |g_cup=227
|allergens=dairy
|pantry=no
|price=4.49 |price_per=1 lb
|description=Written with the preferred <code>description</code> name.
}}

Must show the infobox, a Description section carrying that text, and a Find out
more section with both search links. Per-teaspoon, per-tablespoon and per-cup
calories must be computed; the Each row must not appear.

== Legacy parameter name ==

{{Ingredient/sandbox
|form=Large, whole
|role=Bind
|kcal100=143
|g_each=50
|allergens=egg
|summary=Written with the legacy <code>summary</code> name.
}}

Must render the description from <code>summary</code>, so existing pages and
the Page Forms keep working. Only the Each row should appear in the nutrition
block.

== Preferred name wins over legacy ==

{{Ingredient/sandbox
|kcal100=100
|description=This preferred description must be the one shown.
|summary=This legacy summary must not appear.
}}

== No description ==

{{Ingredient/sandbox
|form=Fine, white
|kcal100=387
|g_cup=200
}}

The Description heading must still appear with its placeholder text, and the
allergens row must read that none are flagged.

== Multiword title encoding ==

The search links are built from <code>{{PAGENAME}}</code>, which on this page is
<code>{{PAGENAME}}</code>. On a page such as [[All-purpose flour]] both links
must carry the whole name as a single URL-encoded query value, so check them
there as well as here.

== Empty call ==

{{Ingredient/sandbox}}

Must not raise an error, and must not show calorie rows for units it has no
weight for.
<noinclude>[[Category:Recipedius templates]]</noinclude>

Template:Technique/sandbox

2026-09-23T19:28:25Z

Recipedius deploy: Protected "Template:Technique/sandbox": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
== Technique sandbox ==

Development copy of [[Template:Technique]]. Test changes at
[[Template:Technique/testcases]] before copying an approved revision to the
production template.
</noinclude><includeonly>{| class="wikitable rp-infobox"
|+ {{PAGENAME}}
|-
! Summary
| {{{summary|}}}
{{#if:{{{purpose|}}}|
{{!}}-
! Purpose
{{!}} {{{purpose}}}}}
{{#if:{{{time|}}}|
{{!}}-
! Typical time
{{!}} {{{time}}}}}
{{#if:{{{heat|}}}|
{{!}}-
! Heat
{{!}} {{{heat}}}}}
{{#if:{{{equipment|}}}|
{{!}}-
! Equipment
{{!}} {{{equipment}}}}}
{{#if:{{{ingredients|}}}|
{{!}}-
! Ingredients
{{!}} {{{ingredients}}}}}
{{#if:{{{related|}}}|
{{!}}-
! Related pages
{{!}} {{{related}}}}}
{{#if:{{{safety|}}}|
{{!}}-
! Safety
{{!}} {{{safety}}}}}
|}
[[Category:Techniques]]</includeonly>

Template:Technique

2026-09-23T19:28:25Z

Recipedius deploy: Protected "Template:Technique": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
== Technique ==

Use this template once at the top of an article about a cooking technique. The
article body below the template holds the procedure, variations, examples, and
citations. Link ingredients, equipment, and related pages with ordinary
wikitext when a corresponding Recipedius page exists.

<pre>
{{Technique
|summary=Whisking oil gradually into an acid-based liquid so it stays suspended.
|purpose=Create a stable, glossy dressing or sauce.
|time=2–5 minutes
|equipment=[[Whisk]], [[Mixing bowl]]
|ingredients=[[Olive oil]], [[Lemon]]
|related=[[Lemon vinaigrette]]
|safety=Keep cold emulsions refrigerated; discard leftovers that have stood at room temperature.
}}

== Procedure ==
# Add the acid and seasoning to a bowl.
# Whisk while adding the oil in a thin stream.
</pre>

Only <code>summary</code> is required. Omit any optional field that does not
apply; empty rows do not render. This template stores no Cargo data.

[[Category:Recipedius templates]]
</noinclude><includeonly>{| class="wikitable rp-infobox"
|+ {{PAGENAME}}
|-
! Summary
| {{{summary|}}}
{{#if:{{{purpose|}}}|
{{!}}-
! Purpose
{{!}} {{{purpose}}}}}
{{#if:{{{time|}}}|
{{!}}-
! Typical time
{{!}} {{{time}}}}}
{{#if:{{{heat|}}}|
{{!}}-
! Heat
{{!}} {{{heat}}}}}
{{#if:{{{equipment|}}}|
{{!}}-
! Equipment
{{!}} {{{equipment}}}}}
{{#if:{{{ingredients|}}}|
{{!}}-
! Ingredients
{{!}} {{{ingredients}}}}}
{{#if:{{{related|}}}|
{{!}}-
! Related pages
{{!}} {{{related}}}}}
{{#if:{{{safety|}}}|
{{!}}-
! Safety
{{!}} {{{safety}}}}}
|}
[[Category:Techniques]]</includeonly>

Template:Substitution

2026-09-23T19:28:24Z

Recipedius deploy: Protected "Template:Substitution": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
{{#cargo_declare:_table=Substitutions
|sub_from=Page
|sub_to=Page
|alt=String
|role=String
|ratio=Float
|conv=String
|confidence=String
|effect=Text
|warning=Text
|applicable=String
}}
== Substitution rule ==
Place these on the page of the ingredient being replaced, inside a table. Each call is one row: one option, for all roles (leave <code>role</code> blank) or for one specific job the ingredient does in a recipe (<code>role=creaming</code>). A role row overrides the blank row's fields for that role only; set <code>applicable=no</code> on a role row to remove the option for that role.

<pre>
{| class="wikitable rp-rules"
! Use instead !! When its job is !! How much !! Confidence !! What changes
{{Substitution|to=Margarine|ratio=1|confidence=high|effect=Nearly identical result.}}
{{Substitution|to=Olive oil|ratio=0.75|confidence=medium|effect=Use ¾ the amount.|warning=Oil cannot be creamed.}}
{{Substitution|to=Olive oil|role=melted|confidence=high|effect=Use ¾ the amount; mix with the wet ingredients.}}
{{Substitution|to=Olive oil|role=dressing|applicable=no}}
|}
</pre>
Fields: <code>to</code> (ingredient page), <code>alt</code> (a variant name, e.g. "Bottled lemon juice"), <code>role</code>, <code>ratio</code> (multiply the original quantity), <code>conv</code> (free-text conversion when a ratio isn't enough, e.g. "1 tbsp per egg + 3 tbsp water"), <code>confidence</code> (high / medium / low), <code>effect</code>, <code>warning</code>, <code>applicable</code>.
[[Category:Recipedius templates]]
</noinclude><includeonly>{{#cargo_store:_table=Substitutions
|sub_from={{PAGENAME}}
|sub_to={{{to|}}}
|alt={{{alt|}}}
|role={{{role|}}}
|ratio={{{ratio|}}}
|conv={{{conv|}}}
|confidence={{{confidence|}}}
|effect={{{effect|}}}
|warning={{{warning|}}}
|applicable={{{applicable|}}}
}}
|-
| {{#if:{{{alt|}}}|{{{alt}}} ([[{{{to|}}}]])|[[{{{to|}}}]]}}
| {{#if:{{{role|}}}|{{{role}}}|''any''}}
| {{#ifeq:{{{applicable|}}}|no|''not applicable''|{{#if:{{{conv|}}}|{{{conv}}}|{{#if:{{{ratio|}}}|× {{{ratio}}}|''as base rule''}}}}}}
| {{{confidence|}}}
| {{{effect|}}}{{#if:{{{warning|}}}|<br /><span class="rp-warn">⚠ {{{warning}}}</span>}}</includeonly>

Template:SaleItem

2026-09-23T19:28:24Z

Recipedius deploy: Protected "Template:SaleItem": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
{{#cargo_declare:_table=SaleItems
|ingredient=Page
|price=Float
|was=Float
|per=String
|store=String
|week=Date
}}
== Sale item ==
One row per promoted ingredient, on a page named <code>Sale/Store name</code>. The [[This week's sale]] page ranks recipes by these rows.
<pre>
{| class="wikitable"
! Ingredient !! Sale price !! Was !! Per
{{SaleItem|ingredient=Lemon|price=0.39|was=0.89|per=each|store=Oak & Fair Market|week=2026-09-07}}
|}
</pre>
[[Category:Recipedius templates]]
</noinclude><includeonly>{{#cargo_store:_table=SaleItems
|ingredient={{{ingredient|}}}
|price={{{price|}}}
|was={{{was|}}}
|per={{{per|}}}
|store={{{store|}}}
|week={{{week|}}}
}}
|-
| [[{{{ingredient|}}}]]
| class="rp-qty" | ${{{price|}}}
| class="rp-qty rp-was" | ${{{was|}}}
| {{{per|}}}</includeonly>

Template:RecipeIngredient

2026-09-23T19:28:24Z

Recipedius deploy: Protected "Template:RecipeIngredient": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
{{#cargo_declare:_table=RecipeIngredients
|recipe=Page
|ingredient=Page
|qty=Float
|unit=String
|role=String
|prep=String
|pos=Integer
}}
This template only declares the <code>RecipeIngredients</code> table (one row per ingredient line of every recipe). Rows are written by [[Module:Recipedius]] when a page uses [[Template:Recipe]]; you never call this template directly.
[[Category:Recipedius templates]]
</noinclude>

Template:Recipe/sandbox

2026-09-23T19:28:24Z

Recipedius deploy: Protected "Template:Recipe/sandbox": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
== Recipe sandbox ==

Development copy of [[Template:Recipe]]. It invokes
[[Module:Recipedius/sandbox]], so a module change can be seen rendered at
[[Template:Recipe/testcases]] before it reaches every recipe on the wiki.

Change the sandbox, check the testcases, then copy the approved revision into
[[Template:Recipe]] and [[Module:Recipedius]].

This copy deliberately omits the <code>#cargo_declare</code> and
<code>#cargo_attach</code> declarations that [[Template:Recipe]] carries. Two
templates must not declare the same Cargo table.
[[Category:Recipedius templates]]
</noinclude><includeonly>{{#invoke:Recipedius/sandbox|recipe}}</includeonly>

Template:Recipe

2026-09-23T19:28:24Z

Recipedius deploy: Protected "Template:Recipe": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
{{#cargo_declare:_table=Recipes
|serves=Integer
|time=String
|tags=List (,) of String
|contributor=String
|lede=Text
|method=Text
|kcal_total=Float
|allergens=List (,) of String
|ingredient_count=Integer
}}
{{#cargo_attach:_table=RecipeIngredients}}
== Recipe ==
One page per recipe. The reader-facing sections are Description, Ingredients,
and Instructions. Ingredient lines are written one per line as
<code>page title; quantity; unit; role; preparation</code>. The page title can
name an [[:Category:Ingredients|ingredient record]] or another Recipe, such as
<code>Simple syrup</code>. Every title is an internal wiki link; a red link is
valid while the target is being created. Only Ingredient records participate in
nutrition and substitution calculations.

<pre>
{{Recipe
|serves=24
|time=50 min
|tags=dessert, baking, cookie
|contributor=Marta O.
|description=Three ingredients and a hot oven.
|ingredients=
Butter; 1; cup; creaming; softened
Granulated sugar; 1/2; cup; sweet
All-purpose flour; 2; cup; structure
Kosher salt; 1/4; tsp; season
|instructions=
# Beat the butter and sugar until pale.
# Stir in the flour and salt.
# Bake at 325°F for 30 minutes.
}}
</pre>
<code>description</code> and <code>instructions</code> are the preferred
parameter names. The existing <code>lede</code> and <code>method</code> names
remain supported for existing pages and forms. When both are supplied, the
preferred name wins.

The computed <code>Substitutions for this recipe</code> section, when present,
is supplemental content after Instructions.
Units the calculator understands (quantities may be decimals, fractions like 1/2, or mixed like 1 1/2): <code>tsp</code>, <code>tbsp</code>, <code>cup</code>, <code>each</code>. Roles in use: creaming, melted, cutin, cooking, dressing, leaven, bind, liquid, sweet, structure, finish, juice, zest, aroma, season, inclusion, protein, starch, moisture, body, leaven-dry.
Test any change at [[Template:Recipe/testcases]] through [[Template:Recipe/sandbox]] before deploying it.
[[Category:Recipedius templates]]
</noinclude><includeonly>{{#invoke:Recipedius|recipe}}</includeonly>

Template:Ingredient/sandbox

2026-09-23T19:28:24Z

Recipedius deploy: Protected "Template:Ingredient/sandbox": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
== Ingredient sandbox ==

Development copy of [[Template:Ingredient]]. Test changes at
[[Template:Ingredient/testcases]] before copying an approved revision to the
production template.

This copy deliberately omits the <code>#cargo_declare</code> declaration and
the <code>#cargo_store</code> call that [[Template:Ingredient]] carries. Two
templates must not declare the same Cargo table, a testcases page must not
write rows into the Ingredients table, and it must not file itself under
[[:Category:Ingredients]] as though it were a real ingredient.
[[Category:Recipedius templates]]
</noinclude><includeonly>{| class="wikitable rp-infobox"
|+ {{PAGENAME}}
|-
! Form
| {{{form|}}}
|-
! Role
| {{{role|}}}
|-
! Storage
| {{{storage|}}}
|-
! Season
| {{{season|}}}
|-
! Allergens
| {{#if:{{{allergens|}}}|{{{allergens}}}|''none flagged''}}
|-
! Pantry staple
| {{#ifeq:{{{pantry|no}}}|yes|yes (left off shopping lists)|no}}
|-
! Price
| {{#if:{{{price|}}}|${{{price}}} / {{{price_per|}}}|—}}
|-
! colspan="2" | Nutrition
{{#if:{{{g_tsp|}}}|
{{!}}-
! Per teaspoon
{{!}} {{#expr:{{{g_tsp}}}*{{{kcal100|0}}}/100 round 0}} kcal}}
{{#if:{{{g_tbsp|}}}|
{{!}}-
! Per tablespoon
{{!}} {{#expr:{{{g_tbsp}}}*{{{kcal100|0}}}/100 round 0}} kcal}}
{{#if:{{{g_cup|}}}|
{{!}}-
! Per cup
{{!}} {{#expr:{{{g_cup}}}*{{{kcal100|0}}}/100 round 0}} kcal · {{{g_cup}}} g}}
{{#if:{{{g_each|}}}|
{{!}}-
! Each
{{!}} {{#expr:{{{g_each}}}*{{{kcal100|0}}}/100 round 0}} kcal · {{{g_each}}} g}}
|-
! Per 100 g
| {{{kcal100|}}} kcal
|-
| colspan="2" | <small>Approximate; enter values from a source you trust.</small>
|}

== Description ==
{{#if:{{{description|}}}|{{{description}}}|{{#if:{{{summary|}}}|{{{summary}}}|''No description yet.''}}}}

== Find out more ==
* [https://en.wikipedia.org/w/index.php?search={{urlencode:{{PAGENAME}}}} Search Wikipedia for {{PAGENAME}}]
* [https://fdc.nal.usda.gov/food-search?query={{urlencode:{{PAGENAME}}}} Search USDA FoodData Central for {{PAGENAME}}]

== Used in ==
{{#cargo_query:tables=RecipeIngredients
|fields=recipe=Recipe,qty=Qty,unit=Unit,role=Job in the recipe
|where=ingredient='{{PAGENAME}}'
|order by=recipe
|format=table
|default=''No recipes use this yet.''
}}

== Can stand in for ==
{{#cargo_query:tables=Substitutions
|fields=sub_from=Ingredient
|where=sub_to='{{PAGENAME}}' AND (role IS NULL OR role='')
|format=list
|delimiter=,
|default=''Nothing yet.''
}}
</includeonly>

Template:Ingredient

2026-09-23T19:28:24Z

Recipedius deploy: Protected "Template:Ingredient": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
{{#cargo_declare:_table=Ingredients
|form=String
|role=String
|storage=String
|season=String
|kcal100=Float
|g_tsp=Float
|g_tbsp=Float
|g_cup=Float
|g_each=Float
|allergens=List (,) of String
|pantry=String
|price=Float
|price_per=String
|summary=Text
}}
== Ingredient record ==
One page per ingredient. Its page title is its Name. The infobox is the record;
recipes link to it and the [[Module:Recipedius|computed layer]] reads it for
calories, allergens and substitutions.

<pre>
{{Ingredient
|form=Unsalted, solid
|role=Fat · structure, flavor, creaming
|storage=Fridge, 1–3 months
|season=Year-round
|kcal100=717
|g_tsp=4.7 |g_tbsp=14.2 |g_cup=227 |g_each=
|allergens=dairy
|pantry=no
|price=4.49 |price_per=1 lb
|description=A paragraph or two about what this ingredient does in a kitchen and what can stand in for it.
}}
</pre>
<code>description</code> is the preferred name for the visible description.
The existing <code>summary</code> name remains supported for existing pages and
forms. When both are supplied, <code>description</code> wins.
Then add substitution rules in a table using [[Template:Substitution]]. Grams per unit and kcal per 100 g drive every calculation; enter them from a source you trust and cite it in the summary.
Test any change at [[Template:Ingredient/testcases]] through [[Template:Ingredient/sandbox]] before deploying it.
[[Category:Recipedius templates]]
</noinclude><includeonly>{{#cargo_store:_table=Ingredients
|form={{{form|}}}
|role={{{role|}}}
|storage={{{storage|}}}
|season={{{season|}}}
|kcal100={{{kcal100|}}}
|g_tsp={{{g_tsp|}}}
|g_tbsp={{{g_tbsp|}}}
|g_cup={{{g_cup|}}}
|g_each={{{g_each|}}}
|allergens={{{allergens|}}}
|pantry={{{pantry|no}}}
|price={{{price|}}}
|price_per={{{price_per|}}}
|summary={{#if:{{{description|}}}|{{{description}}}|{{{summary|}}}}}
}}{| class="wikitable rp-infobox"
|+ {{PAGENAME}}
|-
! Form
| {{{form|}}}
|-
! Role
| {{{role|}}}
|-
! Storage
| {{{storage|}}}
|-
! Season
| {{{season|}}}
|-
! Allergens
| {{#if:{{{allergens|}}}|{{{allergens}}}|''none flagged''}}
|-
! Pantry staple
| {{#ifeq:{{{pantry|no}}}|yes|yes (left off shopping lists)|no}}
|-
! Price
| {{#if:{{{price|}}}|${{{price}}} / {{{price_per|}}}|—}}
|-
! colspan="2" | Nutrition
{{#if:{{{g_tsp|}}}|
{{!}}-
! Per teaspoon
{{!}} {{#expr:{{{g_tsp}}}*{{{kcal100|0}}}/100 round 0}} kcal}}
{{#if:{{{g_tbsp|}}}|
{{!}}-
! Per tablespoon
{{!}} {{#expr:{{{g_tbsp}}}*{{{kcal100|0}}}/100 round 0}} kcal}}
{{#if:{{{g_cup|}}}|
{{!}}-
! Per cup
{{!}} {{#expr:{{{g_cup}}}*{{{kcal100|0}}}/100 round 0}} kcal · {{{g_cup}}} g}}
{{#if:{{{g_each|}}}|
{{!}}-
! Each
{{!}} {{#expr:{{{g_each}}}*{{{kcal100|0}}}/100 round 0}} kcal · {{{g_each}}} g}}
|-
! Per 100 g
| {{{kcal100|}}} kcal
|-
| colspan="2" | <small>Approximate; enter values from a source you trust.</small>
|}

== Description ==
{{#if:{{{description|}}}|{{{description}}}|{{#if:{{{summary|}}}|{{{summary}}}|''No description yet.''}}}}

== Find out more ==
* [https://en.wikipedia.org/w/index.php?search={{urlencode:{{PAGENAME}}}} Search Wikipedia for {{PAGENAME}}]
* [https://fdc.nal.usda.gov/food-search?query={{urlencode:{{PAGENAME}}}} Search USDA FoodData Central for {{PAGENAME}}]

== Used in ==
{{#cargo_query:tables=RecipeIngredients
|fields=recipe=Recipe,qty=Qty,unit=Unit,role=Job in the recipe
|where=ingredient='{{PAGENAME}}'
|order by=recipe
|format=table
|default=''No recipes use this yet.''
}}

== Can stand in for ==
{{#cargo_query:tables=Substitutions
|fields=sub_from=Ingredient
|where=sub_to='{{PAGENAME}}' AND (role IS NULL OR role='')
|format=list
|delimiter=,
|default=''Nothing yet.''
}}
[[Category:Ingredients]]</includeonly>

Template:Cookbook

2026-09-23T19:28:24Z

Recipedius deploy: Protected "Template:Cookbook": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>
== Cookbook ==
Assemble any recipes on the wiki into a printable book. Create a page called <code>Cookbook/Your name</code> and put this on it:
<pre>
{{Cookbook
|title=Our kitchen
|dedication=For Mom, who never measured anything.
|recipes=Lemon bars, Classic shortbread, Banana bread
}}
</pre>
The book is rendered from the recipe database, so it always reflects the current version of each recipe. Use your browser's print function for a PDF; the print stylesheet lays each recipe out as a page. A print-on-demand step (the Collection extension, or an export to a printer) is the next thing to add here.
[[Category:Recipedius templates]]
</noinclude><includeonly>{{#invoke:Recipedius|cookbook}}[[Category:Cookbooks]]</includeonly>

Module:Recipedius/sandbox

2026-09-23T19:28:23Z

Recipedius deploy: Protected "Module:Recipedius/sandbox": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

-- Development copy of [[Module:Recipedius]]. Exercise changes at
-- [[Template:Recipe/testcases]] through [[Template:Recipe/sandbox]], then copy
-- an approved revision into the production module.
--
-- Keep this a faithful copy. It is the only place a module change can be seen
-- rendered before it reaches every recipe on the wiki.
--[[
Module:Recipedius
The computed layer of Recipedius. Reads ingredient records and substitution rules
from Cargo tables and renders recipe pages, the weekly sale ranking, and cookbooks.

Entry points (all via {{#invoke:Recipedius|fn}} from templates):
recipe - renders a recipe from Template:Recipe args and stores its rows
sale - ranks recipes by how many of their shopping items are on sale
cookbook - renders a printable book from a list of recipe pages
]]

local p = {}
local cargo = mw.ext.cargo

-- ---------------------------------------------------------------- helpers

local FRACTIONS = {
{ 0.125, '⅛' }, { 0.25, '¼' }, { 1/3, '⅓' }, { 0.375, '⅜' }, { 0.5, '½' },
{ 0.625, '⅝' }, { 2/3, '⅔' }, { 0.75, '¾' }, { 0.875, '⅞' },
}
local FRACTION_CHARS = { ['⅛']=0.125, ['¼']=0.25, ['⅓']=1/3, ['⅜']=0.375, ['½']=0.5, ['⅝']=0.625, ['⅔']=2/3, ['¾']=0.75, ['⅞']=0.875 }

local function trim(s) return mw.text.trim(s or '') end

-- "1 1/2", "3/4", "0.5", "1 ½" and "¾" all parse.
local function parseQty(s)
s = trim(s)
local total, found = 0, false
for tok in s:gmatch('%S+') do
if FRACTION_CHARS[tok] then total = total + FRACTION_CHARS[tok]; found = true
else
local a, b = tok:match('^(%d+)/(%d+)$')
if a then total = total + tonumber(a) / tonumber(b); found = true
elseif tonumber(tok) then total = total + tonumber(tok); found = true end
end
end
if found then return total end
return nil
end

local function fmtQty(q)
if not q then return '' end
local w = math.floor(q + 1e-6)
local f = q - w
if f > 0.94 then w = w + 1; f = 0 end
local fs = ''
if f > 0.06 then
local best, bd = nil, 1
for _, pair in ipairs(FRACTIONS) do
local d = math.abs(pair[1] - f)
if d < bd then bd = d; best = pair[2] end
end
if bd < 0.06 then fs = best else fs = string.format('%.2f', f):gsub('^0', '') end
end
if w == 0 then return fs ~= '' and fs or '0' end
if fs ~= '' then return w .. ' ' .. fs end
return tostring(w)
end

local PLURALS = { ['Garlic'] = 'Garlic cloves', ['Whole chicken'] = 'Whole chickens', ['Russet potato'] = 'Russet potatoes' }
-- Display name for a count-based ingredient: "2 eggs", "3 bananas", "6 garlic cloves".
local function countLabel(name, q, u)
if u ~= 'each' or not q or q <= 1 then return name end
if PLURALS[name] then return PLURALS[name] end
if name:sub(-1) == 's' then return name end
return name .. 's'
end

local function unitLabel(q, u)
if u == 'each' or u == '' then return '' end
if u == 'cup' and q and q > 1 then return 'cups' end
return u
end

local function sqlEsc(s) return (tostring(s):gsub("'", "\\'")) end

local function splitList(s)
local out = {}
for item in (s or ''):gmatch('[^,]+') do
item = trim(item)
if item ~= '' then table.insert(out, item) end
end
return out
end

local function round(x) return math.floor(x + 0.5) end

-- ---------------------------------------------------------------- data access

local ingredientCache = {}
local function getIngredient(name)
if ingredientCache[name] ~= nil then return ingredientCache[name] or nil end
local rows = cargo.query('Ingredients',
'_pageName=name,kcal100,g_tsp,g_tbsp,g_cup,g_each,allergens,pantry,price,price_per',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
ingredientCache[name] = rows[1] or false
return rows[1]
end

local recipeCache = {}
local function getRecipe(name)
if recipeCache[name] ~= nil then return recipeCache[name] or nil end
local rows = cargo.query('Recipes', '_pageName=name',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
recipeCache[name] = rows[1] or false
return rows[1]
end

local function gramsPer(ing, unit)
if not ing then return nil end
local key = ({ tsp = 'g_tsp', tbsp = 'g_tbsp', cup = 'g_cup', each = 'g_each' })[unit]
if not key then return nil end
return tonumber(ing[key])
end

local function kcalOf(ing, q, unit)
local g = gramsPer(ing, unit)
local k = ing and tonumber(ing.kcal100)
if not (g and k and q) then return 0 end
return q * g * k / 100
end

-- Substitution rules for an ingredient, resolved for the role it plays in this recipe.
-- A base row (role blank) applies everywhere; a row with a role overrides the base for that role.
-- An override with applicable=no removes the option for that role.
local subsCache = {}
local function rulesFor(name, role)
if not subsCache[name] then
subsCache[name] = cargo.query('Substitutions',
'sub_to,alt,role,ratio,conv,confidence,effect,warning,applicable',
{ where = "sub_from='" .. sqlEsc(name) .. "'", orderBy = 'sub_to', limit = 200 })
end
local groups, order = {}, {}
for _, r in ipairs(subsCache[name]) do
local key = (r.sub_to or '') .. '|' .. (r.alt or '')
if not groups[key] then groups[key] = {}; table.insert(order, key) end
if trim(r.role) == '' then groups[key].base = r
elseif trim(r.role) == role then groups[key].override = r end
end
local out = {}
for _, key in ipairs(order) do
local b, o = groups[key].base, groups[key].override
local blocked = o and trim(o.applicable):lower() == 'no'
if (b or o) and not blocked then
local m = {}
for _, k in ipairs({ 'sub_to', 'alt', 'ratio', 'conv', 'confidence', 'effect', 'warning' }) do
local ov = o and trim(o[k]) or ''
if ov ~= '' then m[k] = ov elseif b then m[k] = trim(b[k]) else m[k] = '' end
end
if m.warning == 'none' then m.warning = '' end
m.roleSpecific = o ~= nil
table.insert(out, m)
end
end
return out
end

-- ---------------------------------------------------------------- recipe

-- Ingredient lines are written one per line as: Ingredient; quantity; unit; role; preparation
local function parseLines(text)
local lines = {}
for raw in (text or ''):gmatch('[^\r\n]+') do
raw = trim(raw)
if raw ~= '' and not raw:match('^<!%-%-') then
local parts = mw.text.split(raw, ';', true)
local name = trim(parts[1] or '')
if name ~= '' then
table.insert(lines, {
name = name,
qty = parseQty(parts[2] or ''),
unit = trim(parts[3] or ''),
role = trim(parts[4] or ''),
prep = trim(parts[5] or ''),
})
end
end
end
return lines
end

local function resolvedArg(args, preferred, legacy)
local value = trim(args[preferred])
if value ~= '' then return value end
return trim(args[legacy])
end

local CONF_DOTS = { high = '●●●', medium = '●●○', low = '●○○' }
local function confBadge(c)
c = trim(c):lower()
return '<span class="rp-conf rp-conf-' .. c .. '" title="confidence: ' .. c .. '">' .. (CONF_DOTS[c] or '○○○') .. ' ' .. c .. '</span>'
end

function p.recipe(frame)
local args = frame:getParent().args
local title = mw.title.getCurrentTitle()
local page = title.prefixedText
local serves = tonumber(args.serves) or 1
local description = resolvedArg(args, 'description', 'lede')
local instructions = resolvedArg(args, 'instructions', 'method')
local lines = parseLines(args.ingredients)

-- totals from the ingredient records
local kcalTotal, allergens, seen, missing = 0, {}, {}, {}
for _, l in ipairs(lines) do
local ing = getIngredient(l.name)
if ing then
kcalTotal = kcalTotal + kcalOf(ing, l.qty, l.unit)
for _, a in ipairs(splitList(ing.allergens)) do
if not seen[a] then seen[a] = true; table.insert(allergens, a) end
end
elseif not getRecipe(l.name) then
table.insert(missing, l.name)
end
end

local out = {}
local function add(s) table.insert(out, s) end

-- infobox
add('{| class="wikitable rp-infobox"\n|+ ' .. page)
add('|-\n! Serves\n| ' .. serves)
if trim(args.time) ~= '' then add('|-\n! Time\n| ' .. trim(args.time)) end
add('|-\n! Per serving\n| <b>' .. round(kcalTotal / serves) .. ' kcal</b> <small>(' .. round(kcalTotal) .. ' for the batch)</small>')
add('|-\n! Contains\n| ' .. (#allergens > 0 and table.concat(allergens, ', ') or "''nothing flagged''"))
if trim(args.contributor) ~= '' then add('|-\n! Contributed by\n| ' .. trim(args.contributor)) end
if trim(args.tags) ~= '' then
local tagLinks = {}
for _, t in ipairs(splitList(args.tags)) do table.insert(tagLinks, '[[:Category:' .. t .. '|' .. t .. ']]') end
add('|-\n! Tags\n| ' .. table.concat(tagLinks, ' · '))
end
add('|-\n| colspan="2" | <small>Calories are computed from the [[:Category:Ingredients|ingredient records]]. Approximate.</small>')
add('|}')

add('== Description ==')
if description ~= '' then add("<div class=\"rp-lede\">''" .. description .. "''</div>")
else add("''No description yet.''") end

if #missing > 0 then
add('<div class="rp-missing">These ingredients have no record yet, so they are left out of the nutrition and substitution tables: ' ..
table.concat(missing, ', ') .. '. [[Special:FormEdit/Ingredient|Create one]].</div>')
end

-- ingredients table
add('== Ingredients ==')
add('{| class="wikitable rp-ingredients"\n! Quantity !! Ingredient !! Its job here !! Swaps')
local swapSections = {}
for i, l in ipairs(lines) do
local ing = getIngredient(l.name)
local shown = countLabel(l.name, l.qty, l.unit)
local isRecipe = not ing and getRecipe(l.name)
local link = (ing or isRecipe) and ('[[' .. l.name .. '|' .. shown .. ']]') or ('[[' .. l.name .. '|' .. shown .. ']]<sup class="rp-missing-mark">?</sup>')
local qty = fmtQty(l.qty) .. ' ' .. unitLabel(l.qty, l.unit)
local prep = l.prep ~= '' and (', <span class="rp-prep">' .. l.prep .. '</span>') or ''
local rules = ing and rulesFor(l.name, l.role) or {}
local swapCell = "''none''"
if #rules > 0 then
swapCell = '[[#Substitutions for this recipe|' .. #rules .. (#rules == 1 and ' option' or ' options') .. ']]'
table.insert(swapSections, { line = l, rules = rules })
end
add('|-\n| class="rp-qty" | ' .. trim(qty) .. '\n| ' .. link .. prep .. '\n| class="rp-role" | ' .. l.role .. '\n| ' .. swapCell)
end
add('|}')

add('== Instructions ==')
if instructions ~= '' then add(instructions)
else add("''No instructions yet.''") end

-- substitutions resolved for this recipe
if #swapSections > 0 then
add('== Substitutions for this recipe ==')
add('<p class="rp-note">Rules come from each ingredient\'s record and are resolved for the job the ingredient does in this recipe. Confidence is the community\'s, not a guarantee.</p>')
add('{| class="wikitable rp-subs"\n! Instead of !! Use !! How much !! What changes !! Confidence')
for _, s in ipairs(swapSections) do
for _, r in ipairs(s.rules) do
local useName = r.alt ~= '' and (r.alt .. ' ([[' .. r.sub_to .. ']])') or ('[[' .. r.sub_to .. ']]')
local howMuch
if r.conv ~= '' then howMuch = r.conv
else
local ratio = tonumber(r.ratio) or 1
local nq = s.line.qty and (s.line.qty * ratio) or nil
howMuch = nq and (fmtQty(nq) .. ' ' .. unitLabel(nq, s.line.unit) .. ' <small>(× ' .. ratio .. ')</small>') or ('× ' .. ratio)
end
local what = r.effect
if r.warning ~= '' then what = what .. '<br /><span class="rp-warn">⚠ ' .. r.warning .. '</span>' end
if r.roleSpecific then what = what .. ' <small class="rp-role-tag">rule for: ' .. s.line.role .. '</small>' end
add('|-\n| [[' .. s.line.name .. ']]\n| ' .. useName .. '\n| class="rp-qty" | ' .. howMuch .. '\n| ' .. what .. '\n| ' .. confBadge(r.confidence))
end
end
add('|}')
end

-- store rows (skipped when the page is being previewed inside another page)
if title.namespace == 0 then
for i, l in ipairs(lines) do
frame:callParserFunction('#cargo_store', {
'_table=RecipeIngredients', recipe = page, ingredient = l.name,
qty = l.qty and tostring(l.qty) or '', unit = l.unit, role = l.role, prep = l.prep, pos = tostring(i),
})
end
frame:callParserFunction('#cargo_store', {
'_table=Recipes', serves = tostring(serves), time = trim(args.time), tags = trim(args.tags),
contributor = trim(args.contributor), lede = description, method = instructions,
kcal_total = tostring(round(kcalTotal)), allergens = table.concat(allergens, ','), ingredient_count = tostring(#lines),
})
end

-- Categories belong to real recipe pages. Without this guard a /testcases
-- page that exercises the template would file itself under Category:Recipes
-- and every tag category it demonstrates.
if title.namespace == 0 then
local cats = { '[[Category:Recipes]]' }
for _, t in ipairs(splitList(args.tags)) do table.insert(cats, '[[Category:' .. t .. ']]') end
add(table.concat(cats, ''))
end
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- sale

function p.sale(frame)
local args = frame.args
local store = trim(args.store)
local where = store ~= '' and ("store='" .. sqlEsc(store) .. "'") or nil
local sale = cargo.query('SaleItems', 'ingredient,price,was,per,store', { where = where, limit = 200 })
if #sale == 0 then return "''No sale items have been entered yet. Add them with [[Template:SaleItem]].''" end
local onSale = {}
for _, s in ipairs(sale) do onSale[s.ingredient] = s end

local rows = cargo.query('RecipeIngredients=RI,Ingredients=I', 'RI.recipe=recipe,RI.ingredient=ingredient,I.pantry=pantry',
{ join = 'RI.ingredient=I._pageName', limit = 2000 })
local recipes, order = {}, {}
for _, r in ipairs(rows) do
if not recipes[r.recipe] then recipes[r.recipe] = { hits = {}, toBuy = 0, save = 0 }; table.insert(order, r.recipe) end
local rec = recipes[r.recipe]
local pantry = trim(r.pantry):lower() == 'yes'
if not pantry then
rec.toBuy = rec.toBuy + 1
local s = onSale[r.ingredient]
if s then
table.insert(rec.hits, r.ingredient)
rec.save = rec.save + ((tonumber(s.was) or 0) - (tonumber(s.price) or 0))
end
end
end
local ranked = {}
for _, name in ipairs(order) do
local rec = recipes[name]
if #rec.hits > 0 then rec.name = name; table.insert(ranked, rec) end
end
table.sort(ranked, function(a, b)
if #a.hits ~= #b.hits then return #a.hits > #b.hits end
return (#a.hits / math.max(1, a.toBuy)) > (#b.hits / math.max(1, b.toBuy))
end)

local out = { '{| class="wikitable rp-sale"\n! Recipe !! On sale !! Shopping list !! You save' }
for _, rec in ipairs(ranked) do
local links = {}
for _, h in ipairs(rec.hits) do table.insert(links, '[[' .. h .. ']]') end
table.insert(out, '|-\n| [[' .. rec.name .. ']]\n| ' .. table.concat(links, ', ') .. '\n| ' .. #rec.hits .. ' of ' .. rec.toBuy ..
' items <small>(pantry staples excluded)</small>\n| class="rp-qty" | $' .. string.format('%.2f', rec.save))
end
table.insert(out, '|}')
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- cookbook

local function chapterFor(tags)
local t = {}
for _, x in ipairs(splitList(tags)) do t[x:lower()] = true end
if t['breakfast'] then return 'Mornings' end
if t['dessert'] then return 'Sweets' end
if t['dinner'] or t['side'] or t['soup'] then return 'Suppers and sides' end
return 'Pantry and dressings'
end

function p.cookbook(frame)
local args = frame:getParent().args
local names = splitList(args.recipes)
local title = trim(args.title) ~= '' and trim(args.title) or 'Our kitchen'
local out = {}
local function add(s) table.insert(out, s) end

add('<div class="rp-book">')
add('<div class="rp-page rp-cover"><div class="rp-orn">✦</div><div class="rp-cover-title">' .. title .. '</div><div class="rp-cover-sub">' ..
#names .. (#names == 1 and ' recipe' or ' recipes') .. ' · assembled on Recipedius</div></div>')
if trim(args.dedication) ~= '' then
add('<div class="rp-page rp-dedication">' .. trim(args.dedication) .. '</div>')
end

-- gather
local recs, chapters, chapterOrder = {}, {}, {}
for _, n in ipairs(names) do
local r = cargo.query('Recipes', '_pageName=name,serves,time,tags,contributor,lede,method',
{ where = "_pageName='" .. sqlEsc(n) .. "'", limit = 1 })[1]
if r then
r.lines = cargo.query('RecipeIngredients', 'ingredient,qty,unit,prep,pos',
{ where = "recipe='" .. sqlEsc(n) .. "'", orderBy = 'pos', limit = 100 })
local ch = chapterFor(r.tags)
if not chapters[ch] then chapters[ch] = {}; table.insert(chapterOrder, ch) end
table.insert(chapters[ch], r)
else
add('<div class="rp-missing">No recipe page called "' .. n .. '" was found.</div>')
end
end

-- contents
add('<div class="rp-page rp-toc"><div class="rp-chap-label">Contents</div>')
for _, ch in ipairs(chapterOrder) do
add('<div class="rp-toc-chapter">' .. ch .. '</div>')
for _, r in ipairs(chapters[ch]) do add('<div class="rp-toc-row"><span>' .. r.name .. '</span><span>' .. r.time .. '</span></div>') end
end
add('</div>')

for _, ch in ipairs(chapterOrder) do
add('<div class="rp-page rp-chapter"><div class="rp-chap-label">Chapter</div><div class="rp-chapter-title">' .. ch .. '</div></div>')
for _, r in ipairs(chapters[ch]) do
add('<div class="rp-page rp-recipe-page"><div class="rp-chap-label">' .. ch .. '</div><div class="rp-recipe-title">' .. r.name .. '</div>')
if trim(r.lede) ~= '' then add("<div class=\"rp-lede\">''" .. r.lede .. "''</div>") end
add('<div class="rp-book-cols"><div class="rp-book-ings">')
for _, l in ipairs(r.lines) do
local q = tonumber(l.qty)
add('<div class="rp-book-ing"><span class="rp-qty">' .. fmtQty(q) .. ' ' .. unitLabel(q, l.unit) .. '</span><span>' .. countLabel(l.ingredient, q, l.unit) ..
(trim(l.prep) ~= '' and (', ' .. l.prep) or '') .. '</span></div>')
end
add('</div><div class="rp-book-method">\n' .. (r.method or '') .. '\n</div></div>')
add('<div class="rp-book-foot">Serves ' .. r.serves .. ' · ' .. r.time .. (trim(r.contributor) ~= '' and (' · contributed by ' .. r.contributor) or '') .. '</div></div>')
end
end
add('</div>')
return table.concat(out, '\n')
end

return p

Module:Recipedius

2026-09-23T19:28:23Z

Recipedius deploy: Protected "Module:Recipedius": 0.010 T017: configuration page, deployed from version control ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

--[[
Module:Recipedius
The computed layer of Recipedius. Reads ingredient records and substitution rules
from Cargo tables and renders recipe pages, the weekly sale ranking, and cookbooks.

Entry points (all via {{#invoke:Recipedius|fn}} from templates):
recipe - renders a recipe from Template:Recipe args and stores its rows
sale - ranks recipes by how many of their shopping items are on sale
cookbook - renders a printable book from a list of recipe pages
]]

local p = {}
local cargo = mw.ext.cargo

-- ---------------------------------------------------------------- helpers

local FRACTIONS = {
{ 0.125, '⅛' }, { 0.25, '¼' }, { 1/3, '⅓' }, { 0.375, '⅜' }, { 0.5, '½' },
{ 0.625, '⅝' }, { 2/3, '⅔' }, { 0.75, '¾' }, { 0.875, '⅞' },
}
local FRACTION_CHARS = { ['⅛']=0.125, ['¼']=0.25, ['⅓']=1/3, ['⅜']=0.375, ['½']=0.5, ['⅝']=0.625, ['⅔']=2/3, ['¾']=0.75, ['⅞']=0.875 }

local function trim(s) return mw.text.trim(s or '') end

-- "1 1/2", "3/4", "0.5", "1 ½" and "¾" all parse.
local function parseQty(s)
s = trim(s)
local total, found = 0, false
for tok in s:gmatch('%S+') do
if FRACTION_CHARS[tok] then total = total + FRACTION_CHARS[tok]; found = true
else
local a, b = tok:match('^(%d+)/(%d+)$')
if a then total = total + tonumber(a) / tonumber(b); found = true
elseif tonumber(tok) then total = total + tonumber(tok); found = true end
end
end
if found then return total end
return nil
end

local function fmtQty(q)
if not q then return '' end
local w = math.floor(q + 1e-6)
local f = q - w
if f > 0.94 then w = w + 1; f = 0 end
local fs = ''
if f > 0.06 then
local best, bd = nil, 1
for _, pair in ipairs(FRACTIONS) do
local d = math.abs(pair[1] - f)
if d < bd then bd = d; best = pair[2] end
end
if bd < 0.06 then fs = best else fs = string.format('%.2f', f):gsub('^0', '') end
end
if w == 0 then return fs ~= '' and fs or '0' end
if fs ~= '' then return w .. ' ' .. fs end
return tostring(w)
end

local PLURALS = { ['Garlic'] = 'Garlic cloves', ['Whole chicken'] = 'Whole chickens', ['Russet potato'] = 'Russet potatoes' }
-- Display name for a count-based ingredient: "2 eggs", "3 bananas", "6 garlic cloves".
local function countLabel(name, q, u)
if u ~= 'each' or not q or q <= 1 then return name end
if PLURALS[name] then return PLURALS[name] end
if name:sub(-1) == 's' then return name end
return name .. 's'
end

local function unitLabel(q, u)
if u == 'each' or u == '' then return '' end
if u == 'cup' and q and q > 1 then return 'cups' end
return u
end

local function sqlEsc(s) return (tostring(s):gsub("'", "\\'")) end

local function splitList(s)
local out = {}
for item in (s or ''):gmatch('[^,]+') do
item = trim(item)
if item ~= '' then table.insert(out, item) end
end
return out
end

local function round(x) return math.floor(x + 0.5) end

-- ---------------------------------------------------------------- data access

local ingredientCache = {}
local function getIngredient(name)
if ingredientCache[name] ~= nil then return ingredientCache[name] or nil end
local rows = cargo.query('Ingredients',
'_pageName=name,kcal100,g_tsp,g_tbsp,g_cup,g_each,allergens,pantry,price,price_per',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
ingredientCache[name] = rows[1] or false
return rows[1]
end

local recipeCache = {}
local function getRecipe(name)
if recipeCache[name] ~= nil then return recipeCache[name] or nil end
local rows = cargo.query('Recipes', '_pageName=name',
{ where = "_pageName='" .. sqlEsc(name) .. "'", limit = 1 })
recipeCache[name] = rows[1] or false
return rows[1]
end

local function gramsPer(ing, unit)
if not ing then return nil end
local key = ({ tsp = 'g_tsp', tbsp = 'g_tbsp', cup = 'g_cup', each = 'g_each' })[unit]
if not key then return nil end
return tonumber(ing[key])
end

local function kcalOf(ing, q, unit)
local g = gramsPer(ing, unit)
local k = ing and tonumber(ing.kcal100)
if not (g and k and q) then return 0 end
return q * g * k / 100
end

-- Substitution rules for an ingredient, resolved for the role it plays in this recipe.
-- A base row (role blank) applies everywhere; a row with a role overrides the base for that role.
-- An override with applicable=no removes the option for that role.
local subsCache = {}
local function rulesFor(name, role)
if not subsCache[name] then
subsCache[name] = cargo.query('Substitutions',
'sub_to,alt,role,ratio,conv,confidence,effect,warning,applicable',
{ where = "sub_from='" .. sqlEsc(name) .. "'", orderBy = 'sub_to', limit = 200 })
end
local groups, order = {}, {}
for _, r in ipairs(subsCache[name]) do
local key = (r.sub_to or '') .. '|' .. (r.alt or '')
if not groups[key] then groups[key] = {}; table.insert(order, key) end
if trim(r.role) == '' then groups[key].base = r
elseif trim(r.role) == role then groups[key].override = r end
end
local out = {}
for _, key in ipairs(order) do
local b, o = groups[key].base, groups[key].override
local blocked = o and trim(o.applicable):lower() == 'no'
if (b or o) and not blocked then
local m = {}
for _, k in ipairs({ 'sub_to', 'alt', 'ratio', 'conv', 'confidence', 'effect', 'warning' }) do
local ov = o and trim(o[k]) or ''
if ov ~= '' then m[k] = ov elseif b then m[k] = trim(b[k]) else m[k] = '' end
end
if m.warning == 'none' then m.warning = '' end
m.roleSpecific = o ~= nil
table.insert(out, m)
end
end
return out
end

-- ---------------------------------------------------------------- recipe

-- Ingredient lines are written one per line as: Ingredient; quantity; unit; role; preparation
local function parseLines(text)
local lines = {}
for raw in (text or ''):gmatch('[^\r\n]+') do
raw = trim(raw)
if raw ~= '' and not raw:match('^<!%-%-') then
local parts = mw.text.split(raw, ';', true)
local name = trim(parts[1] or '')
if name ~= '' then
table.insert(lines, {
name = name,
qty = parseQty(parts[2] or ''),
unit = trim(parts[3] or ''),
role = trim(parts[4] or ''),
prep = trim(parts[5] or ''),
})
end
end
end
return lines
end

local function resolvedArg(args, preferred, legacy)
local value = trim(args[preferred])
if value ~= '' then return value end
return trim(args[legacy])
end

local CONF_DOTS = { high = '●●●', medium = '●●○', low = '●○○' }
local function confBadge(c)
c = trim(c):lower()
return '<span class="rp-conf rp-conf-' .. c .. '" title="confidence: ' .. c .. '">' .. (CONF_DOTS[c] or '○○○') .. ' ' .. c .. '</span>'
end

function p.recipe(frame)
local args = frame:getParent().args
local title = mw.title.getCurrentTitle()
local page = title.prefixedText
local serves = tonumber(args.serves) or 1
local description = resolvedArg(args, 'description', 'lede')
local instructions = resolvedArg(args, 'instructions', 'method')
local lines = parseLines(args.ingredients)

-- totals from the ingredient records
local kcalTotal, allergens, seen, missing = 0, {}, {}, {}
for _, l in ipairs(lines) do
local ing = getIngredient(l.name)
if ing then
kcalTotal = kcalTotal + kcalOf(ing, l.qty, l.unit)
for _, a in ipairs(splitList(ing.allergens)) do
if not seen[a] then seen[a] = true; table.insert(allergens, a) end
end
elseif not getRecipe(l.name) then
table.insert(missing, l.name)
end
end

local out = {}
local function add(s) table.insert(out, s) end

-- infobox
add('{| class="wikitable rp-infobox"\n|+ ' .. page)
add('|-\n! Serves\n| ' .. serves)
if trim(args.time) ~= '' then add('|-\n! Time\n| ' .. trim(args.time)) end
add('|-\n! Per serving\n| <b>' .. round(kcalTotal / serves) .. ' kcal</b> <small>(' .. round(kcalTotal) .. ' for the batch)</small>')
add('|-\n! Contains\n| ' .. (#allergens > 0 and table.concat(allergens, ', ') or "''nothing flagged''"))
if trim(args.contributor) ~= '' then add('|-\n! Contributed by\n| ' .. trim(args.contributor)) end
if trim(args.tags) ~= '' then
local tagLinks = {}
for _, t in ipairs(splitList(args.tags)) do table.insert(tagLinks, '[[:Category:' .. t .. '|' .. t .. ']]') end
add('|-\n! Tags\n| ' .. table.concat(tagLinks, ' · '))
end
add('|-\n| colspan="2" | <small>Calories are computed from the [[:Category:Ingredients|ingredient records]]. Approximate.</small>')
add('|}')

add('== Description ==')
if description ~= '' then add("<div class=\"rp-lede\">''" .. description .. "''</div>")
else add("''No description yet.''") end

if #missing > 0 then
add('<div class="rp-missing">These ingredients have no record yet, so they are left out of the nutrition and substitution tables: ' ..
table.concat(missing, ', ') .. '. [[Special:FormEdit/Ingredient|Create one]].</div>')
end

-- ingredients table
add('== Ingredients ==')
add('{| class="wikitable rp-ingredients"\n! Quantity !! Ingredient !! Its job here !! Swaps')
local swapSections = {}
for i, l in ipairs(lines) do
local ing = getIngredient(l.name)
local shown = countLabel(l.name, l.qty, l.unit)
local isRecipe = not ing and getRecipe(l.name)
local link = (ing or isRecipe) and ('[[' .. l.name .. '|' .. shown .. ']]') or ('[[' .. l.name .. '|' .. shown .. ']]<sup class="rp-missing-mark">?</sup>')
local qty = fmtQty(l.qty) .. ' ' .. unitLabel(l.qty, l.unit)
local prep = l.prep ~= '' and (', <span class="rp-prep">' .. l.prep .. '</span>') or ''
local rules = ing and rulesFor(l.name, l.role) or {}
local swapCell = "''none''"
if #rules > 0 then
swapCell = '[[#Substitutions for this recipe|' .. #rules .. (#rules == 1 and ' option' or ' options') .. ']]'
table.insert(swapSections, { line = l, rules = rules })
end
add('|-\n| class="rp-qty" | ' .. trim(qty) .. '\n| ' .. link .. prep .. '\n| class="rp-role" | ' .. l.role .. '\n| ' .. swapCell)
end
add('|}')

add('== Instructions ==')
if instructions ~= '' then add(instructions)
else add("''No instructions yet.''") end

-- substitutions resolved for this recipe
if #swapSections > 0 then
add('== Substitutions for this recipe ==')
add('<p class="rp-note">Rules come from each ingredient\'s record and are resolved for the job the ingredient does in this recipe. Confidence is the community\'s, not a guarantee.</p>')
add('{| class="wikitable rp-subs"\n! Instead of !! Use !! How much !! What changes !! Confidence')
for _, s in ipairs(swapSections) do
for _, r in ipairs(s.rules) do
local useName = r.alt ~= '' and (r.alt .. ' ([[' .. r.sub_to .. ']])') or ('[[' .. r.sub_to .. ']]')
local howMuch
if r.conv ~= '' then howMuch = r.conv
else
local ratio = tonumber(r.ratio) or 1
local nq = s.line.qty and (s.line.qty * ratio) or nil
howMuch = nq and (fmtQty(nq) .. ' ' .. unitLabel(nq, s.line.unit) .. ' <small>(× ' .. ratio .. ')</small>') or ('× ' .. ratio)
end
local what = r.effect
if r.warning ~= '' then what = what .. '<br /><span class="rp-warn">⚠ ' .. r.warning .. '</span>' end
if r.roleSpecific then what = what .. ' <small class="rp-role-tag">rule for: ' .. s.line.role .. '</small>' end
add('|-\n| [[' .. s.line.name .. ']]\n| ' .. useName .. '\n| class="rp-qty" | ' .. howMuch .. '\n| ' .. what .. '\n| ' .. confBadge(r.confidence))
end
end
add('|}')
end

-- store rows (skipped when the page is being previewed inside another page)
if title.namespace == 0 then
for i, l in ipairs(lines) do
frame:callParserFunction('#cargo_store', {
'_table=RecipeIngredients', recipe = page, ingredient = l.name,
qty = l.qty and tostring(l.qty) or '', unit = l.unit, role = l.role, prep = l.prep, pos = tostring(i),
})
end
frame:callParserFunction('#cargo_store', {
'_table=Recipes', serves = tostring(serves), time = trim(args.time), tags = trim(args.tags),
contributor = trim(args.contributor), lede = description, method = instructions,
kcal_total = tostring(round(kcalTotal)), allergens = table.concat(allergens, ','), ingredient_count = tostring(#lines),
})
end

-- Categories belong to real recipe pages. Without this guard a /testcases
-- page that exercises the template would file itself under Category:Recipes
-- and every tag category it demonstrates.
if title.namespace == 0 then
local cats = { '[[Category:Recipes]]' }
for _, t in ipairs(splitList(args.tags)) do table.insert(cats, '[[Category:' .. t .. ']]') end
add(table.concat(cats, ''))
end
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- sale

function p.sale(frame)
local args = frame.args
local store = trim(args.store)
local where = store ~= '' and ("store='" .. sqlEsc(store) .. "'") or nil
local sale = cargo.query('SaleItems', 'ingredient,price,was,per,store', { where = where, limit = 200 })
if #sale == 0 then return "''No sale items have been entered yet. Add them with [[Template:SaleItem]].''" end
local onSale = {}
for _, s in ipairs(sale) do onSale[s.ingredient] = s end

local rows = cargo.query('RecipeIngredients=RI,Ingredients=I', 'RI.recipe=recipe,RI.ingredient=ingredient,I.pantry=pantry',
{ join = 'RI.ingredient=I._pageName', limit = 2000 })
local recipes, order = {}, {}
for _, r in ipairs(rows) do
if not recipes[r.recipe] then recipes[r.recipe] = { hits = {}, toBuy = 0, save = 0 }; table.insert(order, r.recipe) end
local rec = recipes[r.recipe]
local pantry = trim(r.pantry):lower() == 'yes'
if not pantry then
rec.toBuy = rec.toBuy + 1
local s = onSale[r.ingredient]
if s then
table.insert(rec.hits, r.ingredient)
rec.save = rec.save + ((tonumber(s.was) or 0) - (tonumber(s.price) or 0))
end
end
end
local ranked = {}
for _, name in ipairs(order) do
local rec = recipes[name]
if #rec.hits > 0 then rec.name = name; table.insert(ranked, rec) end
end
table.sort(ranked, function(a, b)
if #a.hits ~= #b.hits then return #a.hits > #b.hits end
return (#a.hits / math.max(1, a.toBuy)) > (#b.hits / math.max(1, b.toBuy))
end)

local out = { '{| class="wikitable rp-sale"\n! Recipe !! On sale !! Shopping list !! You save' }
for _, rec in ipairs(ranked) do
local links = {}
for _, h in ipairs(rec.hits) do table.insert(links, '[[' .. h .. ']]') end
table.insert(out, '|-\n| [[' .. rec.name .. ']]\n| ' .. table.concat(links, ', ') .. '\n| ' .. #rec.hits .. ' of ' .. rec.toBuy ..
' items <small>(pantry staples excluded)</small>\n| class="rp-qty" | $' .. string.format('%.2f', rec.save))
end
table.insert(out, '|}')
return table.concat(out, '\n')
end

-- ---------------------------------------------------------------- cookbook

local function chapterFor(tags)
local t = {}
for _, x in ipairs(splitList(tags)) do t[x:lower()] = true end
if t['breakfast'] then return 'Mornings' end
if t['dessert'] then return 'Sweets' end
if t['dinner'] or t['side'] or t['soup'] then return 'Suppers and sides' end
return 'Pantry and dressings'
end

function p.cookbook(frame)
local args = frame:getParent().args
local names = splitList(args.recipes)
local title = trim(args.title) ~= '' and trim(args.title) or 'Our kitchen'
local out = {}
local function add(s) table.insert(out, s) end

add('<div class="rp-book">')
add('<div class="rp-page rp-cover"><div class="rp-orn">✦</div><div class="rp-cover-title">' .. title .. '</div><div class="rp-cover-sub">' ..
#names .. (#names == 1 and ' recipe' or ' recipes') .. ' · assembled on Recipedius</div></div>')
if trim(args.dedication) ~= '' then
add('<div class="rp-page rp-dedication">' .. trim(args.dedication) .. '</div>')
end

-- gather
local recs, chapters, chapterOrder = {}, {}, {}
for _, n in ipairs(names) do
local r = cargo.query('Recipes', '_pageName=name,serves,time,tags,contributor,lede,method',
{ where = "_pageName='" .. sqlEsc(n) .. "'", limit = 1 })[1]
if r then
r.lines = cargo.query('RecipeIngredients', 'ingredient,qty,unit,prep,pos',
{ where = "recipe='" .. sqlEsc(n) .. "'", orderBy = 'pos', limit = 100 })
local ch = chapterFor(r.tags)
if not chapters[ch] then chapters[ch] = {}; table.insert(chapterOrder, ch) end
table.insert(chapters[ch], r)
else
add('<div class="rp-missing">No recipe page called "' .. n .. '" was found.</div>')
end
end

-- contents
add('<div class="rp-page rp-toc"><div class="rp-chap-label">Contents</div>')
for _, ch in ipairs(chapterOrder) do
add('<div class="rp-toc-chapter">' .. ch .. '</div>')
for _, r in ipairs(chapters[ch]) do add('<div class="rp-toc-row"><span>' .. r.name .. '</span><span>' .. r.time .. '</span></div>') end
end
add('</div>')

for _, ch in ipairs(chapterOrder) do
add('<div class="rp-page rp-chapter"><div class="rp-chap-label">Chapter</div><div class="rp-chapter-title">' .. ch .. '</div></div>')
for _, r in ipairs(chapters[ch]) do
add('<div class="rp-page rp-recipe-page"><div class="rp-chap-label">' .. ch .. '</div><div class="rp-recipe-title">' .. r.name .. '</div>')
if trim(r.lede) ~= '' then add("<div class=\"rp-lede\">''" .. r.lede .. "''</div>") end
add('<div class="rp-book-cols"><div class="rp-book-ings">')
for _, l in ipairs(r.lines) do
local q = tonumber(l.qty)
add('<div class="rp-book-ing"><span class="rp-qty">' .. fmtQty(q) .. ' ' .. unitLabel(q, l.unit) .. '</span><span>' .. countLabel(l.ingredient, q, l.unit) ..
(trim(l.prep) ~= '' and (', ' .. l.prep) or '') .. '</span></div>')
end
add('</div><div class="rp-book-method">\n' .. (r.method or '') .. '\n</div></div>')
add('<div class="rp-book-foot">Serves ' .. r.serves .. ' · ' .. r.time .. (trim(r.contributor) ~= '' and (' · contributed by ' .. r.contributor) or '') .. '</div></div>')
end
end
add('</div>')
return table.concat(out, '\n')
end

return p

Main Page

2026-09-23T19:26:06Z