Files
marqdo/ext/web
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
..

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.