26 lines
2.8 KiB
Markdown
26 lines
2.8 KiB
Markdown
# PDF 实际主题样式修复验收
|
||
|
||
路径：G:/OSProject/NotesAgent。此前七色调色板验收仅覆盖配色，不能代表完整主题样式一致；本次替换应用 PDF 导出的渲染链路。
|
||
|
||
- 使用真实主题 CSS、编辑器容器、伪元素、字体、标题偏好、KaTeX 与 Shiki，Chromium 输出 PDF；旧客户端 ReportLab 路径仅用于兼容。
|
||
- 纸间时光保留纸张边框、缝线、左侧装订线、顶部胶带、提示块与代码块装饰。修复跨页图表右侧裁切、提示块 DOM 选择器及 KaTeX 根号 SVG 受图表规则影响的问题。
|
||
- 无旧 PDF 数量/大小配额；内嵌资源、禁用文档脚本及网络访问、保留用户主动取消行为。
|
||
- 六主题各两页，由真实前端构造快照、实际后端导出、Poppler 渲染检查。样例和浏览器参考截图位于本机 .local-plans/pdf-browser。
|
||
- 后端全量 882 项、前端全量 451 项通过；最终排版调整后相关前端19项、资源/浏览器后端15项通过；生产构建成功。1 条既有 Starlette 警告和既有大分包提示保留。
|
||
- 浏览器烟测验证 CSS 伪元素文本进入 PDF，文档脚本未执行；Vault 越界图片被拒绝，17 条函数表达式可准备。
|
||
- 用户已有的三份笔记修改未纳入提交。
|
||
|
||
|
||
## 元数据栏补充验收
|
||
|
||
PDF 快照使用与可视编辑器相同的 `splitNoteMetadata` 解析当前内容，在正文前输出笔记属性、标题和标签，保留 `.note-metadata` 结构及 Vue scoped 样式属性。标签输入框和移除按钮不进入导出。识别出的 YAML 不再作为 Markdown 正文渲染；不支持的元数据仍按编辑器规则保留原文。不额外读取磁盘，因此导出包含当前未保存的元数据。
|
||
|
||
验证：PDF 快照与导出服务 15 项测试通过，前端类型检查及生产构建通过（保留已有大分块提示）。六种主题均实际生成 PDF，并检查包含元数据栏的第一页：paper-moments、dark、light、sepia、ocean-blue、midnight-purple。纸张主题的胶带、缝线及标签配色正常，其他主题的元数据背景、边框和文字配色正常。
|
||
|
||
|
||
## 合并审阅问题修复
|
||
|
||
- 只有标题、标签而正文为空或仅有空白时，跳过资源准备请求，继续生成元数据栏，避免空 Markdown 触发 422。
|
||
- PDF 资源准备覆盖块级及行内 HTML 的 img，使用 HTMLParser 处理标签和属性实体，再复用 Vault 图片路径与格式校验。行内 HTML 在 AST 中单独标记；行内代码和代码块不会被作为 HTML 图片收集。
|
||
- 回归覆盖纯元数据、空白正文、HTML 图片实体与相对路径、越界及远程资源、代码示例排除。后端相关 114 项、前端相关 18 项通过，vue-tsc 类型检查通过。pytest 仅提示本机缓存目录不可写，测试本身通过。
|