Update CHANGELOG.md and README for v1.6.0 release (#85)

* Initial plan

* Update CHANGELOG.md and README files for v1.6.0 release

Co-authored-by: ZeroHawkeye <161401688+ZeroHawkeye@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ZeroHawkeye <161401688+ZeroHawkeye@users.noreply.github.com>
This commit is contained in:
Copilot
2025-12-26 23:29:19 +08:00
committed by GitHub
parent ba4fdb29ee
commit ced266718f
3 changed files with 122 additions and 2 deletions
+120
View File
@@ -2,11 +2,131 @@
## [Unreleased]
## [v1.6.0] - 2025-12-26
### 🐛 修复
#### 模板页眉页脚引用修复 ✨ **重要修复**
- **修复问题**: 解决了DOCX渲染时模板页眉页脚引用丢失的问题
- **技术细节**:
- 解析 `<w:sectPr>` 块,即使 Word 将其嵌套在段落属性中
- 通过新的 `setSectionProperties` 辅助方法保持读取 DOCX 文件时的关系引用
- 防止序列化时 `r:id` 引用被丢弃
- **验证**: 添加了回归测试,确认重写 DOCX 后页眉页脚变量仍能正确替换
#### OpenFromMemory bug 修复
- **修复问题**: 修复了通过 `OpenFromMemory` 方法读取 Word 模板后,生成内容再保存时导致 Microsoft Office Word 无法打开文件的问题
- **问题表现**: 使用 Office 2016 等版本打开时会提示文件错误
- **感谢**: 感谢 @xNeo404 的贡献
#### Table.GetCellText 修复
- `Table.GetCellText` 现在返回单元格内所有段落与所有 Run 的完整文本,并以 `\n` 连接段落,修复此前只能获取第一段首个 Run 文本导致多行内容丢失的问题。
- 影响:如果下游代码假设无换行符,需自行 `strings.ReplaceAll(text, "\n", "")` 或按需拆分。
- 限制:同一段落内的 `<w:br/>` 软换行尚未单独解析(未来可扩展)。
---
## [v1.5.0] - 2025-11-25
### 🚀 新增功能
#### LaTeX 数学公式支持 ✨ **新增**
- **Markdown转Word**: 支持 LaTeX 数学公式转换
- **技术细节**: 修复 LaTeX 命令替换顺序,防止部分替换问题
#### 表格单元格复杂内容 API ✨ **新增**
- **AddCellParagraph**: 向表格单元格添加段落
- **AddCellFormattedParagraph**: 添加带格式的段落
- **ClearCellParagraphs/GetCellParagraphs**: 单元格段落管理
- **AddNestedTable**: 支持在单元格中添加嵌套表格
- **AddCellList**: 支持多种列表类型
- **AddCellImage/AddCellImageFromFile/AddCellImageFromData**: 单元格图片插入
#### SnapToGrid 网格对齐支持 ✨ **新增**
- **自定义样式**: 添加 SnapToGrid 字段到段落属性
- **段落格式**: 添加 SnapToGrid 选项用于禁用网格对齐
- **用途**: 设置为 false 可使自定义 LineSpacing 在启用网格的文档中正常工作
#### 段落级文本格式化方法 ✨ **新增**
- 添加下划线、粗体、斜体等段落级文本格式化方法
#### 段落分页符 ✨ **新增**
- **Paragraph.AddPageBreak()**: 在段落内添加分页符
#### 页眉页脚格式化支持 ✨ **新增**
- 支持带 TextFormat 和对齐选项的格式化页眉页脚
#### 段落格式属性 ✨ **新增**
- **KeepNext**: 与下段同页
- **KeepLines**: 段中不分页
- **PageBreakBefore**: 段前分页
- **WidowControl**: 孤行控制
- **OutlineLevel**: 大纲级别
### 🐛 修复
#### 模板引擎修复
- 修复模板变量替换时图片丢失问题,添加 drawing 元素解析
- 修复模板变量替换时段落编号丢失问题
- 修复模板引擎支持页眉页脚变量
- 修复模板渲染保持文档结构(页眉、页脚等)
#### 表格功能修复
- **AddTable/CreateTable**: 现在返回错误而非 nil,提供更好的错误处理
- 修复模板导出时内嵌表格消失问题
#### 其他修复
- 修复浮动图片导致 Word 文档打开失败的问题
- 修复 Markdown 转换时软换行处理问题
- 修复非 ASCII 图片文件名导致文档损坏的问题
- 修复嵌套 `{{#each}}` 循环渲染问题
- 修复 `UpdateTOC` 无法定位 `GenerateTOC` 创建的目录问题
- 修复表格单元格合并后对齐问题
---
## [v1.4.0] - 2025-11-11
### 🐛 修复
感谢以下贡献者的 PR
- @litecn 修复 xml 规范问题
- @CoffeeSwt 混合格式段落字体下划线和删除线问题修复
- @xNeo404 实现从内存中打开文档的新增 `OpenFromMemory` 函数/修复 md 转 word 问题
- @Padane22-spec 修复通过 Open 打开的文档在 Save 后无法正常打开的问题
---
## [v1.3.9] - 2025-06-06
### 🐛 修复
#### 完全遵循 OOXML 规范的修复版本
- 修复添加图片 Word 无法打开问题
- 修复 md 转 word 代码块样式问题
- 模板渲染增加图片占位功能
---
## [v1.3.8] - 2025-06-05
### 🔧 改进
- 模板渲染部分代码更新,修复多处继承样式问题
- 添加缺失的样式解析
- 添加多语言文档支持
---
## [v1.3.7] - 2025-06-04
### 🚀 新增功能
- 增加 markdown 导入导出功能
- 增加 if else 模板语法支持
### 🐛 修复
- 修复模板渲染问题
---
## [v1.3.6] - 2025-06-04
+1 -1
View File
@@ -82,7 +82,7 @@ We recommend using versioned installation:
go get github.com/ZeroHawkeye/wordZero@latest
# Install specific version
go get github.com/ZeroHawkeye/wordZero@v1.3.7
go get github.com/ZeroHawkeye/wordZero@v1.6.0
```
## Quick Start
+1 -1
View File
@@ -82,7 +82,7 @@ go get github.com/ZeroHawkeye/wordZero
go get github.com/ZeroHawkeye/wordZero@latest
# 安装指定版本
go get github.com/ZeroHawkeye/wordZero@v1.3.7
go get github.com/ZeroHawkeye/wordZero@v1.6.0
```
## 快速开始