- 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。
1.9 KiB
Executable File
markup, title, description
| markup | title | description |
|---|---|---|
| occlusion | lib/html | HTML escape / unescape (Mid2 M8). XSS floor for string assembly. |
HTML escape helpers. Use before stitching untrusted text into markup.
Escape or unescape HTML text.
Behavior and limits: Escaping text does not sanitize an arbitrary HTML document. Build web content as Markdown leaves and structured View nodes.
This single source file is the usage and development manual. Import it directly, or use marqdo call with a function heading below. Parameter tables give types and defaults; required parameters must be supplied. Return tables are progressive contracts; prose describes failure and limits.
Implementation: src/host/html_ops.rs
For development, keep EN/ZH behavior aligned and compose public libraries first. Add host primitives only at OS or algorithm boundaries and declare their effects. Run marqdo check --narrative-ratio on this file and the real workflows in tests/stdlib_tasks.rs after edits.
escape
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| text | text | required | Text supplied by the caller |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | Escape text for HTML |
Use text as the inputs for this operation.
Effects: pure.
Call this function directly:
marqdo call lib/html.mq.md escape 'text="<strong>&"' --effects none --json
Escape text for HTML.
Caller: [html.escape] text=s
Return [Escape text for HTML](> host_html_escape text=text).
unescape
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| text | text | required | Text supplied by the caller |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | Unescape HTML entities in text |
Use text as the inputs for this operation.
Effects: pure.
Unescape HTML entities in text.
Return [Unescape HTML entities in text](> host_html_unescape text=text).