--- title: 代码即文档 · 周末咖啡手账 description: >- 一份可读可跑的周末手账:菜单是表,计价写在段落里,主流程像日记。 展示叙述统一写法、链接形取元 [键](集合)、浮点折扣,以及粗体内免 `>` 的调用。 --- 本文件既是**说明**也是**程序**。人读得到段落与表格;机器执行嵌在叙述里的粗体步骤,并把斜体当作返回值。 不必回避 Markdown 强调——不像代码的 `**说明**` 只是装饰。段落之间也可以用分隔线: --- ## 单价 一杯标价为`价`的饮品,默认`杯数`=1。先算**总额 = 价 * 杯数**,再返回*总额*。 ## 会员折 会员单需要原价`原价`;门店默认八五折,写作`折扣`=0.85。 先算**应付 = 原价 * 折扣**,再返回*应付*。 ## 结账摘要 客人点了`品名`,单价`价`,杯数`杯数`=1;是否`会员`=False。 小计交给单价:**小计 = 单价 价=`价` 杯数=`杯数`**。 1. `会员` **实付 = 会员折 原价=`小计`** **标签 = "会员价"** 2. * **实付 = 小计** **标签 = "原价"** 拼成一句给人对账的话,然后返回: **文案 = 品名 + " ×" + 杯数 + " → " + 标签 + " " + 实付** *文案* ## 加一 对于输入`n`,执行**n=n+1**接着返回*n*。 # main 周末手账从一张菜单开始。数据用表格写——人一眼能读,程序把它当成字典: `菜单` = | 美式 | 拿铁 | 燕麦拿铁 | |------|------|----------| | 18 | 28 | 32 | --- 第一单:会员双杯拿铁。品名记在变量里,用链接形取元 `` [`名`](菜单) ``(与循环 `[项](集合)` 同形): **名 = "拿铁"** **价 = [`名`](菜单)** **摘要 = 结账摘要 品名=`名` 价=`价` 杯数=2 会员=True** **打印 内容=`摘要`** 对照一单非会员美式——静态键: **对照 = 结账摘要 品名="美式" 价=[美式](菜单)** **打印 内容=`对照`** --- 也可以把今日订单写成行表;循环头与取元同一套链接外形: `今日订单` = | @ | 品名 | 单价 | 杯数 | 会员 | |---|------|------|------|------| | 1 | 燕麦拿铁 | 32 | 1 | True | | 2 | 美式 | 18 | 2 | False | - [行](今日订单) **一行 = 结账摘要 品名=[品名](行) 价=[单价](行) 杯数=[杯数](行) 会员=[会员](行)** **打印 内容=`一行`** 最后用加一收个尾,确认叙述里的位置调用也通: **试算 = 加一 41** **打印 内容=`试算`**