feat(markup): prefer [key](collection) for map and list access
Add GFM link-shaped index as the primary get surface, keep footnote index as transitional compatibility, and align the coffee example. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
5e74ff39f2
commit
4a1c9c48a2
12 files changed
+235
-23
No files matched your search
@@ -12,10 +12,11 @@ marqdo run examples/code-as-docs/index.mq.md
|
||||
|------|------|
|
||||
| 数据给人读 | GFM 表当菜单 / 订单 |
|
||||
| 步骤嵌在句子里 | `**总额 = 价 * 杯数**`、返回 `*总额*` |
|
||||
| 装饰性强调 | `**说明**` 不执行(见设计 G2) |
|
||||
| 段落分隔 | 顶层或体内的 `---` 只是分割线 |
|
||||
| 装饰性强调 | `**说明**` 不执行 |
|
||||
| 段落分隔 | `---` 只是分割线 |
|
||||
| 浮点 | `折扣`=0.85 |
|
||||
| 动态键 | `` 菜单[^`名`] `` |
|
||||
| 调用 | 粗体赋值右侧 **可省略 `>`**:`**摘要 = 结账摘要 …**`;输出可用 `**打印 内容=…**` |
|
||||
| 取元 | `[拿铁](菜单)` / `` [`名`](菜单) ``(与循环同形;脚注 `[^…]` 仅过渡) |
|
||||
| 循环 | `- [行](今日订单)` |
|
||||
| 调用 | `**摘要 = 结账摘要 …**`(粗体 RHS 可省略 `>`) |
|
||||
|
||||
相关设计:[code-as-docs-gaps.md](../../doc/design/code-as-docs-gaps.md)、[markdown-mapping-v0.3.md](../../doc/design/markdown-mapping-v0.3.md) §6。
|
||||
设计:[collection-access-link.md](../../doc/design/collection-access-link.md)、[code-as-docs-gaps.md](../../doc/design/code-as-docs-gaps.md)。
|
||||
@@ -2,7 +2,7 @@
|
||||
title: 代码即文档 · 周末咖啡手账
|
||||
description: >-
|
||||
一份可读可跑的周末手账:菜单是表,计价写在段落里,主流程像日记。
|
||||
展示叙述统一写法、装饰性强调、分隔线、浮点折扣、动态脚注键,以及粗体内免 `>` 的调用。
|
||||
展示叙述统一写法、链接形取元 [键](集合)、浮点折扣,以及粗体内免 `>` 的调用。
|
||||
---
|
||||
|
||||
本文件既是**说明**也是**程序**。人读得到段落与表格;机器执行嵌在叙述里的粗体步骤,并把斜体当作返回值。
|
||||
@@ -53,20 +53,21 @@ description: >-
|
||||
|
||||
---
|
||||
|
||||
第一单:会员双杯拿铁。品名先记在变量里,再用动态键取价;粗体赋值右侧是调用时不必再写 `>`:
|
||||
第一单:会员双杯拿铁。品名记在变量里,用链接形取元 `` [`名`](菜单) ``(与循环 `[项](集合)` 同形):
|
||||
|
||||
**名 = "拿铁"**
|
||||
**摘要 = 结账摘要 品名=`名` 价=菜单[^`名`] 杯数=2 会员=True**
|
||||
**价 = [`名`](菜单)**
|
||||
**摘要 = 结账摘要 品名=`名` 价=`价` 杯数=2 会员=True**
|
||||
**打印 内容=`摘要`**
|
||||
|
||||
对照一单非会员美式——品名已知,静态键即可:
|
||||
对照一单非会员美式——静态键:
|
||||
|
||||
**对照 = 结账摘要 品名="美式" 价=菜单[^美式]**
|
||||
**对照 = 结账摘要 品名="美式" 价=[美式](菜单)**
|
||||
**打印 内容=`对照`**
|
||||
|
||||
---
|
||||
|
||||
也可以把今日订单写成行表。循环里把行字段直接传给结账,少一层临时变量:
|
||||
也可以把今日订单写成行表;循环头与取元同一套链接外形:
|
||||
|
||||
`今日订单` =
|
||||
|
||||
@@ -75,8 +76,8 @@ description: >-
|
||||
| 1 | 燕麦拿铁 | 32 | 1 | True |
|
||||
| 2 | 美式 | 18 | 2 | False |
|
||||
|
||||
- [`行`](`今日订单`)
|
||||
**一行 = 结账摘要 品名=行[^品名] 价=行[^单价] 杯数=行[^杯数] 会员=行[^会员]**
|
||||
- [行](今日订单)
|
||||
**一行 = 结账摘要 品名=[品名](行) 价=[单价](行) 杯数=[杯数](行) 会员=[会员](行)**
|
||||
**打印 内容=`一行`**
|
||||
|
||||
最后用加一收个尾,确认叙述里的位置调用也通:
|
||||
|
||||
Reference in new issue
Block a user