- 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。
2.5 KiB
Executable File
ext/web — Document / Endpoint / Resource
Official dynamic site extension (ADR 0007).
| Doc | Link |
|---|---|
| Artifact model | doc/design/ext-web-artifact.md |
| Layout engineering | doc/design/ext-web-layout-paradigm.md |
| skill=tools paradigm | doc/design/ext-skill-tools-paradigm.md |
| Surface | Path |
|---|---|
| EN root skill (zero-context site playbook) | ext/web/index.mq.md |
| EN author facade | import web:ext/web/web.mq.md |
| ZH root skill (zero-context playbook) | ext/web/网页/索引.mq.md |
| ZH author facade | 导入 网页:ext/web/网页.mq.md |
| Modules | page/ · route/ · component/ · dom/ · client/ · layout/ |
| ZH modules | 网页/页面/ · 网页/路由/ · 网页/组件/ · … |
| Layout tools | ext/web/layout/index.mq.md · ext/web/布局/索引.mq.md |
Facade: page · route · serve · render · inspect · use
Layout law: partition pages into files (nav / sidebar / main / footer / …) until each piece is simple; bind via |type|slot|value|attrs|style|. Do not build sites by HTML/CSS injection (dom.raw is escape hatch only).
Related modules: ext/data · ext/security · ext/net
bash scripts/build-web-plugin.sh
marqdo ext add web
marqdo call ext/web/layout/index.mq.md rules --json
marqdo call ext/web/index.mq.md preview_markdown 'body="# Hi"' 'title="Demo"' --effects plugin --json
marqdo run examples/marqdo-blog/serve.mq.md
Hard rules: no author ensure_plugin / compose_* / configure junk drawer; View schema only; declared vs system routes via inspect; no MARQDO_EXT=repo/ext self-install.
The executable handbook and Chinese handbook now include recursive layout constructors and tested source examples. Start with the reference site: parents compose one relationship, terminal content.md files stay ordinary Markdown. The footer splits into brand/links, and links splits again into docs/community. See implementation and acceptance.
Composed Documents explicitly declare view: main; main returns nested View
rows for startup assembly. Ordinary Markdown Documents keep their existing path.
Use web.inspect root=... to scan disk declarations; empty fresh app state cannot
inspect another process. call previews, while run serve.mq.md starts a server.