feat: synchronize typography controls with editable CSS

This commit is contained in:
2026-10-29 15:48:23 +08:00
parent 9867553bfe
commit 9d4bc8c91a
9 changed files with 826 additions and 33 deletions
+14 -2
View File
@@ -2,7 +2,7 @@
MDHelper 是一个本地 Markdown / 代码文档阅读器,适合阅读项目说明、技术手册、源码旁文档和离线帮助文件。它使用 PySide6 提供桌面窗口,用 Qt WebEngine 渲染 Markdown 转换后的 HTML 页面,并在本地完成全文搜索、样式管理、导出和自动刷新。
当前版本:`0.2.1`
当前版本:`0.2.2`
## 1. 适用场景
@@ -146,6 +146,18 @@ Markdown 支持:
纸张宽度是全局阅读设置,内置样式不再写死正文宽度,会跟随纸张宽度变化。
### 图形设置与高级 CSS 双向同步
“高级 CSS”显示完整的自定义样式。修改图形设置时,只更新对应对象的核心属性;原有背景、边框、阴影、注释和其他对象的规则会保留。直接修改 CSS 后,停止输入约 0.35 秒即可回填到图形设置和预览;立即点击确定也会先同步再保存。CSS 未写完整或存在语法错误时,保留上一次有效设置并提示修正,避免把半成品保存为样式。
核心同步覆盖对象的常规选择器,例如 `p`、`.reader p`、`h1`、`.reader h1`,以及程序生成的正文、列表、引用、代码和表格选择器。可识别的属性包括 `font-family`、`font-size`、`font-weight`、`font-style`、`color`、`letter-spacing`、`text-align`、`line-height`、`text-indent`、`margin`/四个方向的间距,以及换行、分页属性。支持常见字体简写、间距简写和 `!important`;重置当前对象只清除其核心设置,保留扩展效果。
例如,将正文规则中的 `font-size: 12pt` 改成 `font-size: 14pt`,图形字号会变为 14 磅,导出 Word 也使用 14 磅。之后在图形界面调整字号,CSS 对应值会随之更新。删除某项属性后,如果没有其他常规规则提供该属性,图形设置显示“继承”。
中英文字体及 Word 特有设置使用可编辑的 CSS 自定义属性:`--mdhelper-font-chinese` / `--mdhelper-font-english` 区分字体;`--mdhelper-line-spacing-mode: at-least` 配合磅值 `line-height` 表示最小值行距;`--mdhelper-contextual-spacing: true` 表示同样式段落间不添加间距。这些属性由图形设置自动生成。
`@media`、嵌套规则、局部选择器(例如 `p:hover`、特定类名),以及图形界面无法表示的 `calc()`、动态变量、透明颜色等值会保留在 CSS 中,并在编辑器底部说明同步范围。它们不会被猜测为统一的图形设置或 Word 格式。需要统一控制文档核心排版时,建议修改程序生成的对象规则;扩展规则仍可用于阅读器及 HTML/PDF 的显示效果。
## 10. 媒体与表格
图片:
@@ -196,7 +208,7 @@ DOCX 导出可选择 `pandoc` 或 `python-docx` 相关实现。正式安装版
Pandoc、python-docx 和内置基础导出均保留图形设置中的字体、字号、颜色、字符间距、对齐、缩进、段间距、行距和分页选项。正文、各级标题、列表、引用、代码和表格分别应用对应设置;Markdown 中显式加粗、斜体的局部文本仍保留强调。Word 字号按其支持的半磅精度写入;自动颜色使用 Word 自动文字颜色。
高级 CSS 仅影响阅读器及 HTML/PDF,不能转换为 Word 样式。阅读器是连续页面,固定值/最小值行距及分页效果可能与 Word 显示不同;导出文件分别保留 Word 的固定值、最小值和分页属性。三个引擎的表格、复杂 Markdown、图片或公式支持范围仍按各自能力处理。
高级 CSS 中可识别的核心属性会同步到图形设置,并用于 Word 导出;背景、边框、条件规则等扩展 CSS 不转换为 Word 格式。阅读器是连续页面,固定值/最小值行距及分页效果可能与 Word 显示不同;导出文件分别保留 Word 的固定值、最小值和分页属性。三个引擎的表格、复杂 Markdown、图片或公式支持范围仍按各自能力处理。
## 13. 配置与迁移