Files
marqdo/examples/web-site-zh/db/articles.mq.md

1.8 KiB

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"))*.