- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2.0 KiB
Executable File
2.0 KiB
Executable File
块公式元数据绑定 · 控制流叙述统一
| 状态 | Active |
| 日期 | 2026-10-15 |
| 相关 | stdlib-math.md · markdown-mapping-v0.3.md · code-as-docs-gaps.md |
1. 块公式 % marqdo: var=
在 $$…$$ 块内用 TeX 行注释声明绑定名(渲染通常不可见;运行时剥离后解析公式体):
$$
% marqdo: var=f
x^2 - 2
$$
- 指令:
% marqdo:+ 空白 +var=<ident>;未知键 → Error。 - 可无前置
`f` =;若同时写空 RHS 与var=,同名允许、异名 Error。 - 保留旧空 RHS + 后随
$$。 - 不做:行内
$% marqdo:…$;``` 代码围栏内语言注释 meta(本波)。 - 行内公式继续传统绑定:
`g` = $x+1$(单$…$→formula)或`g` = $$x+1$$。
无名叙述区 $$ 仍仅展示;可执行区裸块既无空 RHS 又无 var= → Error。
2. 臂 / 循环体叙述(与函数体同权)
parse_indented_body 与函数体相同:消费 `名` / **代码** / *返回*;纯叙述跳过。
斜体返回结束当前臂或当前循环体,不结束外层函数。
3. 循环头
| 面 | 写法 | 说明 |
|---|---|---|
| 推荐 | - [项](xs) / - [项](xs) |
支持嵌套 |
| 中文糖 | - 对xs的每一项项`` |
可选后缀「遍历」 |
| 英文糖 | - for each iteminxs`` |
大小写不敏感 for each / in |
糖与链接头语义相同,可混用嵌套。
4. 分支条件行叙述
结构行仍以 1. / 2. 开头。条件提取顺序:
- 整段可解析为表达式(现状);
- 行内粗体代码条件
**n> 0**; - 剥离「当/若/如果/when/if」与「时/则」后,将「大于/小于/等于…」映射为运算符再解析。
else:N. *(可夹「否则」等叙述,条件位仍为 *)。
禁止无标记自然语言整句当条件。