feat: export editable named Word styles and release 0.5.0
This commit is contained in:
@@ -27,6 +27,12 @@
|
||||
|
||||
## 配置与迁移
|
||||
|
||||
`style_catalog.py` 定义稳定的语义标识、类型、名称、同类型继承及 Markdown 使用情况。格式声明仍以 `style_sync.py` 解析的核心 CSS 为准,名称与基准单独保存在 `rules._metadata`,通过原有配置和项目预设路径持久化。旧 `list`、`code`、`table` 作为兼容基准,细分对象未设置时继承它们。
|
||||
|
||||
`style_panel.py` 仅在用户打开时创建,按文档版本缓存语法分析,隐藏时停止刷新;`style_dialog.py` 的实际阅读预览也只在切换到该页时创建。启动路径不创建这些浏览器,不重建主窗口。
|
||||
|
||||
`docx_style.py` 负责格式字段与 OOXML 属性的转换及属性顺序;`docx_semantic.py` 识别各引擎输出的语义、生成命名段落/字符/表格样式,并移除会遮盖样式的重复直接格式。保留编号、公式、关系和书签;组合字符与加粗段落上下文采用命名变体。`tests/word_styles_smoke.ps1` 使用本机 Word 的独立隐藏实例,验证打开文件、样式修改传播及继承,关闭时不保存测试修改。
|
||||
|
||||
`preferences.py` 定义 `ReaderPreferences` 和 `ApplicationConfiguration`。本地设置与 JSON 导入共用字段、取值检查和旧版迁移规则;`ConfigurationStore` 负责持久化。页面设置保留旧版 PDF 页边距的读取方式。窗口几何状态和草稿仍由各自的界面、文档组件管理。内置文档样式集中在 `style_presets.py`。
|
||||
|
||||
## 编辑器边界
|
||||
|
||||
+15
-3
@@ -152,7 +152,9 @@ Markdown 支持:
|
||||
|
||||
图形界面可设置不同对象的字体和段落格式,例如:
|
||||
|
||||
- 正文段落、一级到六级标题、列表项、引用、代码块、表格。
|
||||
- 正文、一级到六级标题、引用、无序/有序/任务列表、代码块、表头文字和单元格文字。
|
||||
- 加粗、强调、删除线、超链接、行内代码采用字符样式;可设置下划线、删除线和背景色,未设置的字体与字号继承所在段落。
|
||||
- 表格基准可设置边框颜色、宽度和单元格内边距;列表可设置标记形式与嵌套层级缩进。
|
||||
- 中文字体和英文字体分开设置。
|
||||
- 字号支持磅(pt)、像素(px)和中文常用字号,例如五号 10.5 磅;可设置加粗、斜体、字体颜色和字符间距。
|
||||
- 对齐支持左对齐、居中、右对齐和两端对齐。
|
||||
@@ -161,7 +163,17 @@ Markdown 支持:
|
||||
- 左右缩进支持字符、磅或厘米;特殊缩进可选择无、首行或悬挂,首行与悬挂互斥。
|
||||
- 分页支持与下段同页、段中不分页、段前分页和孤行控制。
|
||||
|
||||
“继承”沿用当前文档默认值;数字 0 表示明确清零。复选框方块表示继承、勾选表示开启、空白表示关闭。设置窗口下方提供实时预览;分页效果以 Word 为准。旧样式文件会自动兼容原有的像素字号、字符间距和缩进。
|
||||
“继承”沿用基准样式或文档默认值;数字 0 表示明确清零。复选框方块表示继承、勾选表示开启、空白表示关闭。设置窗口下方提供快速预览,“实际阅读效果”页使用阅读器显示完整示例;分页效果以 Word 为准。旧样式文件会自动兼容原有的像素字号、字符间距和缩进。
|
||||
|
||||
### 样式面板与 Word 导出
|
||||
|
||||
打开“样式 → 样式面板”,可查看全部样式或当前文档已用样式。编辑 Markdown 时,面板提示光标所在段落及其中包含的字符样式。双击条目修改样式名称、同类型基准及格式;改变样式不会改写 Markdown 内容。基于内置样式修改时自动创建自定义样式集。
|
||||
|
||||
样式集是一整套格式方案,正文、标题和链接等是其中的单个样式。启用项目默认后,修改作用于当前项目;否则修改全局默认。原有样式文件、配置导入导出和项目模板继续可用。面板和实际阅读预览按需创建,不增加启动阶段的窗口或浏览器切换。
|
||||
|
||||
三个 Word 导出引擎均创建 `MDHelper 正文`、`MDHelper 标题 1`、`MDHelper 加粗` 等命名样式。导出后,在 Word 的样式面板中修改相应样式,即可统一调整引用该样式的内容;正文的字体和字号也会传递到未单独设置字体的加粗、强调和链接文字。表格边框及内边距通过 Word 表格样式修改。
|
||||
|
||||
Word 每段文字只能引用一个字符样式,因此加粗链接等组合会生成 `MDHelper 超链接+加粗` 等组合样式;组合优先以超链接为基准,其余效果保存在组合样式中。标题中加粗等情况会生成带段落名称的变体,以适配 Word 的加粗叠加规则。组合和变体都可以在 Word 样式面板统一修改,但不会同时继承多个字符样式。嵌套列表使用基于对应列表样式的层级样式,层级缩进可单独修改。
|
||||
|
||||
纸张宽度是全局阅读设置,内置样式不再写死正文宽度,会跟随纸张宽度变化。
|
||||
|
||||
@@ -169,7 +181,7 @@ Markdown 支持:
|
||||
|
||||
“高级 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`;重置当前对象只清除其核心设置,保留扩展效果。
|
||||
核心同步覆盖对象的常规选择器,例如 `p`、`.reader p`、`h1`、`.reader h1`、`strong`、`em`、`s`、`a`,以及程序生成的 `data-mdh-style` 语义选择器。可识别的属性包括字体、字号、颜色、字符间距、`text-decoration-line`、`background-color`、对齐、行距、缩进、四向间距、换行分页,以及 `border-color` / `border-width`、表格 `padding` 和 `list-style-type`。支持常见字体简写、间距简写和 `!important`;重置当前对象只清除其核心设置,保留扩展效果。
|
||||
|
||||
例如,将正文规则中的 `font-size: 12pt` 改成 `font-size: 14pt`,图形字号会变为 14 磅,导出 Word 也使用 14 磅。之后在图形界面调整字号,CSS 对应值会随之更新。删除某项属性后,如果没有其他常规规则提供该属性,图形设置显示“继承”。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user