Files
marqdo/examples/marqdo-blog/db/schema.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

2.4 KiB
Executable File

markup, title, import
markup title import
occlusion 博客表结构调用手册
document
lib/document.mq.md

本文件负责可调用的说明与编排,schema.tables.md负责可独立阅读的 Markdown 常量。调用时把 --fs-root 指向 examples/marqdo-blog,读取需要 fs.read;连接数据库或编译样式时还需要 plugin。

posts

返回 类型 说明
result any 与原字面表一致的数据类型和记录/列式形态

文章结构保留 id、标题、slug、摘要、Markdown 正文、主标签和时间字段。slug 对应文章详情路由;可空声明控制存储约束,路由授权仍由端点或门禁负责。

从站点根目录授予 fs.read 后调用。实际常量位于 schema.tables.md;读取过程保留数值、布尔、空值和表格形态,并检查标题与行列结构。数据文件中的说明不会作为程序运行。

完成后返回*[读取posts的实际 Markdown 常量](document.read_table(path="db/schema.tables.md", title="posts"))*.

tags

返回 类型 说明
result any 与原字面表一致的数据类型和记录/列式形态

标签结构保留显示名称与稳定 slug。显示文字可以改动,路由和文章主标签应继续引用稳定标识;唯一索引需要在正式迁移中明确声明。

从站点根目录授予 fs.read 后调用。实际常量位于 schema.tables.md;读取过程保留数值、布尔、空值和表格形态,并检查标题与行列结构。数据文件中的说明不会作为程序运行。

完成后返回*[读取tags的实际 Markdown 常量](document.read_table(path="db/schema.tables.md", title="tags"))*.

post_tags

返回 类型 说明
result any 与原字面表一致的数据类型和记录/列式形态

关联结构保留文章与标签标识。种子关系依赖空数据库中预期的插入顺序;向已有用户库导入时应先映射真实 id,不能直接复用演示序号。

从站点根目录授予 fs.read 后调用。实际常量位于 schema.tables.md;读取过程保留数值、布尔、空值和表格形态,并检查标题与行列结构。数据文件中的说明不会作为程序运行。

完成后返回*[读取post_tags的实际 Markdown 常量](document.read_table(path="db/schema.tables.md", title="post_tags"))*.