docs: v1.5.0 - 更新模板分离与格式提取文档

This commit is contained in:
2026-06-06 12:52:12 +08:00
parent 22fc8b6228
commit d8d669bba1
4 changed files with 248 additions and 12 deletions

View File

@@ -204,13 +204,24 @@ PinMAP 的引脚分布在四条边上,总引脚数由网格尺寸决定:
> **提示**:如果不确定尺寸,可以先用公式反推:`行数 + 列数 = (引脚数 + 4) / 2`,然后根据需要调整行和列的比例。
### 模板文件说明
### 模板文件说明v1.5.0
PinList → PinMAP 转换时,程序会自动尝试从输入文件所在目录读取模板样式
从 v1.5.0 开始,两个方向的转换使用各自独立的模板文件
- **模板来源**:程序会尝试解析与输入文件同名的 `.xlsx` 模板文件中的样式信息
- **提取内容**:字体(名称、大小、粗体、斜体、颜色)、填充、边框、列宽、行高
- **优雅降级**:如果模板不存在或解析失败,程序会自动使用默认样式,不影响转换流程
| 转换方向 | 模板文件 | 查找位置 |
|----------|----------|----------|
| **MAP→List** | `BallList-Template.xlsx` | 项目根目录 → 当前工作目录 |
| **List→MAP** | `BallMAP-Template.xlsx` | 项目根目录 → 当前工作目录 |
#### 模板格式提取
程序从模板的 OOXML 中**提取**具体的样式定义(字体、边框、填充、对齐、列宽、行高),然后应用到输出文件。这种方式确保即使模板结构复杂也能正确提取关键样式属性。
#### 优雅降级
- 模板文件不存在 → 使用硬编码默认样式Calibri 11pt、thin 边框、居中)
- 模板解析失败(损坏/格式异常)→ 优雅回退到默认样式
- 模板中某些样式属性缺失 → 仅应用可用属性,其余保持默认
### 使用示例