# 《关于「甲子」的虚构故事》公众号推送 Demo

一个 28 列 × 44 行的汉字文字画单页。黑底、每格一个汉字，空白处由淡色「天」铺满；画面包含晚霞云、落日、飞鸟、天线与城市楼群，上方以整格扣出的黑色标题框居中呈现「关于「甲子」的虚构故事」。

## 效果概述

- 28 列 × 44 行，严格按字符网格排布，全页文字统一字号。
- 空白格自动填充淡色「天」，形成低对比背景纹理。
- 元素按层绘制：云 → 落日 → 飞鸟 → 天线 → 楼群。楼群最后绘制，保证太阳在无楼处仍保留完整圆弧。
- 标题区域按整格对齐扣空，并叠放黑色面板，居中显示白色标题。
- 使用 Zpix 像素字体；正文行通过负字距补偿，把单字步进压回 1em。

## 目录结构

```
.
├─ index.html              # 页面骨架
├─ pyproject.toml          # uv 环境与导出依赖
├─ uv.lock                 # 依赖锁定
├─ scripts/export_pdf.py   # PDF 导出脚本
├─ assets/
│  ├─ css/style.css        # 布局、字号与各元素配色
│  ├─ js/scene.js          # 场景数据与网格渲染
│  └─ fonts/zpix.ttf       # Zpix 像素字体
└─ references/a.html       # 原始参考页
```

## 运行

直接打开 `index.html` 即可。若需通过本地服务器预览：

```bash
python -m http.server 8000
# 浏览器访问 http://localhost:8000
```

## 导出 PDF

使用 Playwright（由 uv 管理）导出，页面尺寸为 30em × 46em：28 × 44 格的画面，四周各留恰好 1em。

```bash
uv sync
uv run python scripts/export_pdf.py              # 默认 1em = 24px，输出 dist/luori.pdf
uv run python scripts/export_pdf.py --em 16 -o dist/luori-16.pdf
```

脚本优先调用本机 Edge / Chrome；若都未安装，可先下载 Playwright Chromium：

```bash
uv run playwright install chromium
```

导出页为黑底满幅，画面距上、下、左、右边界各 1em；脚本会在导出前校验该边距。默认 `--em 24` 时输出 720 × 1104px（约 190 × 292 mm）。

## 调整指南

### 构图（assets/js/scene.js）

| 数据 | 含义 |
| --- | --- |
| `clouds` | 云：三行 3/5/3 的云形，x/y 为最宽一行的左上角 |
| `sun` | 落日：逐行圆形切片，数组顺序对应顶部的红到底部的黄 |
| `birds` | 飞鸟：每只占 2 格（麻雀 / 喜鹊 / 乌鸦） |
| `antennas` | 天线：单列「线」，从 y 向下叠 h 格 |
| `buildings` | 楼群：x/y/w/h，n 对应 `.bld-n` |
| `TITLE` | 标题文案、起始行、行高、左右留格数 |

坐标为 0–27 列、0–43 行；越界会直接抛错提示。

### 样式（assets/css/style.css）

- 整体字号：`.scene` 的 `font-size`，所有元素统一继承。
- 背景「天」：`.sky`。
- 云：`.cloud` 的明度与 `.cloud-*` 的色相。
- 落日：`.sun` 的整体明度（当前为原色 90%），`.sun-t1` 至 `.sun-t17` 为逐行色阶。
- 飞鸟：`.bird-sparrow`、`.bird-magpie`、`.bird-crow`。
- 天线：`.ant`（深色款为 `.ant-dark`）。
- 楼群：`.bld` 与 `.bld-1` 至 `.bld-8`。
- 标题：`.title-panel`（黑色矩形）与 `.title-panel .title`（白色文字及字号）。

## 实现说明

- `scene.js` 先建立 28×44 网格并全部填「天」，再按数组覆盖元素；同 class 的连续字符合并为单个 `span` 输出。
- 标题区把对应格子清空，并在同一位置叠放绝对定位的黑色面板；边缘与字符整格对齐，不会出现半个字。
- Zpix 单字步进为 13/12 em，因此 `.line` 使用 `letter-spacing: -0.083333em` 补偿，保证 28 列恰好落在 28em 宽内。

## 字体许可

`assets/fonts/zpix.ttf` 为第三方 Zpix 像素字体，版权归原作者所有；使用或分发前请遵循其原始许可说明。