# 信纸编辑 **Repository Path**: deardhp/letter-paper-editor ## Basic Information - **Project Name**: 信纸编辑 - **Description**: No description available - **Primary Language**: HTML - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-08-07 - **Last Updated**: 2026-09-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 信纸编辑器 (letter-paper-editor) 一个开箱即用的在线信纸编辑器:左侧写 Markdown,右侧实时渲染成红色信纸风格的 A4 页面,自动分页,支持微信表情、图片图层与一键导出 PDF。 纯前端单文件方案(无构建、无依赖),配合一个轻量 FastAPI 服务完成 PDF 导出。 ## 功能特性 - **Markdown 双栏编辑**:左侧 textarea + 工具栏(加粗 / 斜体 / 表情 / 字号 / 行数),右侧实时预览,200ms 防抖自动渲染 - **自动分页**:内容流偏移法分页,长段落可自然跨页,不丢内容;每页带装订线与页码 - **红色信纸模板**:5 层 background 叠加实现信纸横线 + 双线页眉页脚,仿宋字体 - **微信表情**:内置 109 个微信表情,点击插入,长名优先匹配 - **图片图层**:图片作为独立图层浮在页面上,支持拖拽移动、四角等比缩放、旋转、删除 - **PDF 导出**:一键导出 A4 PDF(Edge headless 渲染,`@page margin:0` 无页眉页脚) - **编辑-预览联动**: - 预览中选中文字 → 左侧 Markdown 自动定位并选中同一处(出现序号匹配,重复字词也能精确定位) - 编辑器与预览按内容进度比例双向滚动联动,带防死循环锁 - **本地存储**:文档保存在浏览器 localStorage,支持新建、重命名、删除、导入/导出 JSON 备份 - **DOCX 生成**:独立脚本用 python-docx 生成红色信纸 Word 文档 ## 快速开始 ### 方式一:直接打开(无需后端) 用浏览器直接打开 `index.html` 即可使用编辑、预览、存储等全部功能,仅 PDF 导出需要后端服务。 ### 方式二:启动 PDF 导出服务 ```bash pip install -r requirements.txt python pdf_server.py ``` 服务运行在 `http://127.0.0.1:8765`,随后在编辑器点击「导出 PDF」即可。 > PDF 导出依赖本机安装的 Microsoft Edge 浏览器(`--headless=new --print-to-pdf`)。 ### 可选:下载微信表情 ```bash python download_emoji.py # 从 jsDelivr 下载 109 张微信表情 PNG 到 emoji/ ``` ### 可选:生成信纸 DOCX ```bash python letter_template.py # 用 python-docx 生成红色信纸 Word 文档 ``` ## 技术架构 ``` ┌─────────────────────────────┐ ┌──────────────────────────┐ │ 前端(纯 HTML/CSS/JS) │ HTTP │ 后端(FastAPI :8765) │ │ │ POST │ │ │ index.html 信纸卡片列表 │ ──────► │ /api/export-pdf │ │ letter_editor.html 编辑器 │ blob │ │ │ │ - marked.js 渲染 Markdown │ ◄────── │ Edge headless │ │ - 内容流偏移法自动分页 │ │ --print-to-pdf │ │ - localStorage 持久化 │ │ │ └─────────────────────────────┘ └──────────────────────────┘ ``` ### 分页方案:内容流偏移法 不再逐块切分 HTML,而是: 1. 将完整内容渲染进临时容器,测量总高度 2. 页数 = `ceil(总高度 / 每页可用高度)` 3. 每页放一份完整内容副本,用 `margin-top` 负偏移显示对应"窗口" 4. 外层 `content-clip`(`overflow:hidden` + 固定高度)裁掉超出部分 **优势**:长段落自然跨页不裁切;行高/偏移经过整数像素同步(`_syncPageContentHeight`),文字与信纸横线精确对齐。 ### 数据模型 ```js { id: "doc_xxx", title: "文档标题", markdown: "# 正文内容...", template: "red-letter", settings: { fontSize: 14, linesPerPage: 24 }, images: [{ id, src, x, y, width, height, rotation }], // 图片图层 cardColor: "#E8EAF6", // 首页卡片颜色 createdAt: 1720000000000, updatedAt: 1720000000000 } ``` 存储于 localStorage,key 为 `letter_editor_documents`。 ## 文件结构 ``` ├── index.html # 首页:信纸卡片列表(localStorage CRUD + 双击重命名) ├── letter_editor.html # 编辑器主体(约 1900 行):双栏编辑 + 预览 + 分页 + 导出 ├── pdf_server.py # FastAPI 服务(端口 8765):Edge headless 生成 PDF ├── letter_template.py # 独立工具:python-docx 生成红色信纸 DOCX ├── download_emoji.py # 一次性脚本:下载 109 张微信表情 PNG ├── requirements.txt # fastapi / uvicorn / pydantic ├── emoji/ # 109 张表情 PNG + emoji_map.json └── overview.md # 旧版溢出检测体系设计文档(已废弃,仅供历史参考) ``` ## 主要技术点 | 技术点 | 说明 | |--------|------| | Markdown 渲染 | marked.js(CDN),表情用占位符避免方括号转义,空行用 `@@@BLANK{n}@@@` 保留 | | 信纸横线 | `.page-content` 5 层 background 叠加(双线页眉页脚 + repeating 下划线) | | 表情面板定位 | mirror div 复制 textarea 滚动,`getBoundingClientRect` 取光标可见视口坐标,右下 15px 弹出,底部自动翻转 | | Tab 缩进 | 插入 U+00A0 不换行空格,避免空行后行首 4 空格被解析为代码块(灰色背景) | | 预览选中同步 | DOM 位置计算第 N 次出现 + Markdown 中 `findNthOccurrence`,首尾锚点降级处理跨格式标记 | | 滚动联动 | 按内容进度比例双向同步,80ms 锁防死循环;选区同步时抑制滚动,视图保持稳定 | | PDF 导出 | 表情转 base64、图片清理编辑手柄、`@page { margin:0; size:A4 }` 防页眉页脚 | ## 使用说明 1. **首页**:新建信纸 / 打开已有信纸 / 双击标题重命名 / 删除 2. **编辑**:左侧输入 Markdown,右侧实时预览;工具栏可加粗、斜体、插入表情、调字号(12-32pt)、调行数(20-30 行/页) 3. **图片**:点击添加图片,自动出现在当前预览可见区域中部,直接拖拽微调 4. **PDF**:点击「导出 PDF」调起后端生成 A4 PDF 5. **备份**:首页或编辑器内可导出 / 导入 JSON 备份,导入内容直接加载到当前编辑页 ## 环境要求 - 现代浏览器(Chrome / Edge / Firefox) - Python 3.9+(仅 PDF 导出与 DOCX 生成需要) - Microsoft Edge(仅 PDF 导出需要) ## 仓库 - 托管于 Gitee:`git@gitee.com:deardhp/letter-paper-editor.git`