Files
marqdo/examples/web-site-zh/components/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

2.1 KiB
Executable File

markup, title, import
markup title import
occlusion 当前文章卡片与短链详情
组件 视图 表
ext/web/网页/组件/索引.mq.md ext/data/视图.mq.md lib/表.mq.md

两种视图随请求查询应用持有的同一 articles 表。卡片使用摘要和短链,详情使用完整 Markdown 正文。构造描述不另开数据库,也不缓存启动时的旧记录;原生卡片与文章类名供原主题继续使用。

cards

返回 类型 说明
result list 通过 /post/短链 打开详情的当前文章卡片

构造不需要副作用。监听应用拥有数据库与实际执行上下文,卡片保留原来的稳定 id 顺序,字段仍为 title、summary 与 slug。标题、摘要按文本转义,完整正文只留给详情。公共发布或后台共享表单新增文章后,下次请求即能看见,不必重启站点。

我们 资源 = [描述实际当前文章列表](视图.查询(源="articles", 排序="id", 链接前缀="/post/"))。 最后返回 [安放一个请求期间的卡片职责](组件.请求资源(值=资源, 槽="articles"))。

detail

返回 类型 说明
result list 实际路径捕获选中的首篇完整 Markdown 文章

声明的 /post/{slug} 页面在请求解析资源时提供路径参数,同名查询字符串不能替换它。原生详情即使有摘要也使用完整正文,并且每次复制条件再替换参数,不污染启动时保留的定义。缺少数据库仍是错误;没有匹配记录沿用现有查询资源的空结果约定。

条件保留为明确记录,不能把单列表误当字典。父层继续拥有文章区域的位置,本函数不自己拼接标题或渲染 Markdown,以免与卡片规则和当前请求上下文分离。

我们 条件 = [保留实际短链条件记录](表.设(map=None, key="slug", value="{slug}")) 和 资源 = [描述匹配短链的完整正文](视图.查询(源="articles", 条件=条件, 详情=True, 上限=1))。 最后返回 [安放实际请求的文章](组件.请求资源(值=资源, 槽="article"))。