docs: document md-print usage
This commit is contained in:
@@ -458,6 +458,47 @@ data-config:
|
||||
|
||||
每个图层通过 `prop`(读取 CSV 字段)或 `template`(渲染带 `{{变量}}` 替换的 markdown 模板)定义,`pos` 为网格位置 `x1,y1-x2,y2`(1-based,与紧凑 layers 字符串同格式),支持 `font`、`orientation`、`align`(水平 `l`/`c`/`r`,可加垂直前缀 `t`/`b` 组成 `tl`/`tc`/`tr`/`bl`/`bc`/`br`,如 `align: tl` 表示左上对齐)。`back_layers` 用于背面图层。
|
||||
|
||||
### 🖨️ 打印版式组件 (md-print)
|
||||
|
||||
将 Markdown 文档排版为可打印的 A4 横版页面:每张 A4 放两个 A5 页面,每个 A5 页面再分成多列。
|
||||
|
||||
```markdown
|
||||
:md-print[./rules.md]
|
||||
:md-print[./rules.md]{columns="2" margin="10" gap="5" font="9"}
|
||||
```
|
||||
|
||||
**功能:**
|
||||
- 自动分页:内容按块级元素流入 A5 页面,段落、列表和表格可在分页处拆分
|
||||
- 每张 A4 横版放两个 A5 页面,每个 A5 页面默认两列
|
||||
- 预览中可直接打印或另存为 PDF
|
||||
- 支持页眉标题、页码和中缝裁切线
|
||||
|
||||
**属性:**
|
||||
|
||||
| 属性 | 类型 | 默认值 | 说明 |
|
||||
|------|------|--------|------|
|
||||
| `columns` | number | `2` | 每个 A5 页面的列数(1–4) |
|
||||
| `margin` | number | `10` | 页面边距(毫米) |
|
||||
| `gap` | number | `5` | 列间距(毫米) |
|
||||
| `font` | number | `9` | 正文字号(磅) |
|
||||
| `title` | string | - | 页眉标题 |
|
||||
| `pageNumbers` | boolean | `true` | 是否显示页码 |
|
||||
| `cutMarks` | boolean | `true` | 是否显示 A4 中缝裁切线 |
|
||||
|
||||
**YAML 写法:**
|
||||
|
||||
```yaml
|
||||
tag: md-print
|
||||
body: ./rules.md
|
||||
columns: 2
|
||||
margin: 10
|
||||
gap: 5
|
||||
font: 9
|
||||
title: 规则书
|
||||
```
|
||||
|
||||
**打印设置:** 在浏览器打印对话框中选择 A4、横向、无边距、100% 缩放。
|
||||
|
||||
### 🧶 叙事线组件 (md-yarn-spinner)
|
||||
|
||||
用于展示分支叙事结构,支持 Yarn Spinner 格式文件。
|
||||
|
||||
Reference in New Issue
Block a user