Files
marqdo/examples/web-site-zh/db/articles.mq.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- 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。
2026-11-18 10:29:26 +08:00

1.8 KiB
Executable File

markup, title, import
markup title import
occlusion 文章结构与种子调用手册
document
lib/document.mq.md

本文件解释各个调用的用途;相邻的 articles.tables.md 保存可直接阅读的字面表。把 --fs-root 指向站点目录,读取需要 fs.read。字段、样式与正文是数据,读取不会执行文件中的说明。

schema

返回 类型 说明
result any 原生字面表的原始类型与列式数据形态

声明文章的字段、原生类型与可空约束;id 的数值类型和必填字段保持不变。数据库初始化器使用此表保证结构,不负责猜测用户数据的迁移。

授予站点文件根的 fs.read 后可独立调用。章节名精确匹配且必须唯一;表头、行列不齐或动态表达式会保留原生文档诊断。需要实际样式时再调用 css;需要数据库记录时交给数据库资源。返回值不是 HTML,也不是已应用的浏览器效果。

完成后返回*[读取 schema 的实际字面表](document.read_table(path="db/articles.tables.md", title="schema"))*.

seed

返回 类型 说明
result any 原生字面表的原始类型与列式数据形态

提供起始演示文章,保留原来的 id、短链、摘要与正文。只有数据库初始化器确认空表后才应插入;读取本函数不会写入或重置现有文章。

授予站点文件根的 fs.read 后可独立调用。章节名精确匹配且必须唯一;表头、行列不齐或动态表达式会保留原生文档诊断。需要实际样式时再调用 css;需要数据库记录时交给数据库资源。返回值不是 HTML,也不是已应用的浏览器效果。

完成后返回*[读取 seed 的实际字面表](document.read_table(path="db/articles.tables.md", title="seed"))*.