Welcome pages put greet calls in # main so CallFrames/pickers appear; document surface skips fence body lines and Bind chips under formula/code cards. Adds view-static-interactive design and entry-vs-method regression tests. Co-authored-by: Cursor <cursoragent@cursor.com>
2.2 KiB
2.2 KiB
用户静态文档站(public / gh-pages)
| 状态 | 已定 |
| 日期 | 2026-08-04 |
| 相关 | view.md · view-static-interactive.md(静态交互 / 公式代码视觉 · Proposal) · 源目录 public/ |
1. 分工
| 路径 | 是否入库 | 职责 |
|---|---|---|
doc/ |
是 | 开发者设计 / ADR / 路线图(单数 doc,勿再造 docs/) |
public/**/*.mq.md |
是 | 用户可读、可执行、可下载的介绍(结构 / 关键字 / stdlib / 特性迭代);双语:拉丁文件名 = 英文,中文文件名 = 中文编程,同目录并列。stdlib 含 plugin;特性页覆盖对象与 ext/(llm / agent) |
public/index.html、public/pages/ |
否(ignore) | marqdo view output 生成的 HTML |
tests/{structure,keywords,errors}/ |
是 | 金样例与失败夹具(含 errors) |
远程分支 gh-pages |
发布产物 | 发布整个 public/(源文件 + 生成 HTML) |
禁止把 tests/errors/ 编进用户站。
2. 生成
cargo run --release -- view output public -o public
# 或
./scripts/build-public.sh
powershell -File ./scripts/build-public.ps1
产物写在源旁:
public/
*.mq.md / structure/ / … # 入库源
index.html # 生成(ignore)
pages/… # 生成(ignore)
3. 发布分支
将构建后的 public/ 推到 gh-pages。CI:.github/workflows/pages.yml。
仓库 Settings → Pages → Source = Deploy from branch → gh-pages / root。
4. 内容分层(用户站)
| 目录 | 内容 |
|---|---|
public/stdlib/ |
L1 模块页(含 plugin / 插件);概述注明 ext/ 非 stdlib |
public/features/ |
迭代特性:树遍历、字节码、view、对象、官方扩展 |
设计文档仍在 doc/design/(objects.md、ext-llm.md、ext-abi.md、ext-agent.md)。
5. 验收
public/下每个.mq.md(除纯工具模块外)marqdo run退出码 0。view output public -o public后首页为欢迎页,侧栏无 errors。- 主分支跟踪
public/**/*.mq.md;不提交public/index.html/public/pages/。