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

48 lines
2.5 KiB
Markdown
Executable File

# ext/web — Document / Endpoint / Resource
Official dynamic site extension (**ADR 0007**).
| Doc | Link |
|-----|------|
| Artifact model | [`doc/design/ext-web-artifact.md`](../../doc/design/ext-web-artifact.md) |
| **Layout engineering** | [`doc/design/ext-web-layout-paradigm.md`](../../doc/design/ext-web-layout-paradigm.md) |
| skill=tools paradigm | [`doc/design/ext-skill-tools-paradigm.md`](../../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
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](index.mq.md) and [Chinese handbook](网页/索引.mq.md)
now include recursive layout constructors and tested source examples. Start with
[the reference site](../../examples/web-layout-handbook/index.mq.md): 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](../../doc/design/ext-web-handbook.md).
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.