# wordformatter

**Repository Path**: eatfashdaddy/wordformatter

## Basic Information

- **Project Name**: wordformatter
- **Description**: WordFormatter是一个基于JavaFX的Word文档(.docx)格式化工具，使用Apache POI库实现。它提供图形界面，可以自动分析文档结构并应用标准化的样式和格式。

- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-12
- **Last Updated**: 2025-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WordFormatter - 文档格式化工具

## 目录
- [项目概述](#项目概述)
- [主要功能](#主要功能)
- [使用说明](#使用说明)
- [项目结构](#项目结构)
- [配置说明](#配置说明)
- [开发指南](#开发指南)
- [依赖项](#依赖项)
- [开发环境](#开发环境)

## 项目概述
WordFormatter是一个基于JavaFX的Word文档(.docx)格式化工具，使用Apache POI库实现。它提供图形界面，可以自动分析文档结构并应用标准化的样式和格式。
![工具界面](cover.png)
## 主要功能
### 核心功能
- 自动识别文档结构：
  - 章节标题(如"第X章")
  - 子章节(如"1.1 标题")
  - 正文内容
- 自动应用标准化样式：
  - 标题1-3级样式
  - 正文文本样式
  - 表格样式
- 中文字体统一设置为"宋体"
- 自动调整段落间距和对齐

### 图形界面功能
- 文件选择对话框
- 实时处理进度显示
- 处理结果状态提示
- 简洁直观的操作流程

### DocumentStyler功能
- 文档解析与样式分析
- 样式自动修正
- 格式一致性检查
- 批量处理支持

## 使用说明
1. 构建项目：
   ```bash
   mvn clean package
   ```

2. 运行图形界面：
   ```bash
   java -jar target/WordFormatter.jar
   ```

3. 在图形界面中：
   - 点击"浏览..."按钮选择输入文档
   - 点击"浏览..."按钮选择输出路径
   - 点击"格式化文档"按钮开始处理

## 项目结构
```
WordFormatter/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── wordformatter/
│   │   │           ├── MainApp.java       # JavaFX应用入口
│   │   │           ├── MainController.java # 控制器
│   │   │           ├── DocumentStyler.java # 文档处理核心
│   │   │           └── FormatConfig.java  # 格式配置
│   │   └── resources/
│   │       ├── fxml/main.fxml             # 界面定义
│   │       └── logback.xml                # 日志配置
│   └── test/                             # 测试代码
├── target/                               # 构建输出
└── pom.xml                              # Maven配置
```

## 配置说明
### logback.xml配置
- 默认日志级别为INFO
- 日志输出到控制台和文件(logs/word-formatter.log)
- 每日滚动日志文件(logs/word-formatter.{date}.log)

如需修改日志级别，编辑logback.xml中的`<root level="INFO">`部分。

## 开发指南
### 扩展功能
1. 添加新样式规则：
   - 修改DocumentStyler.java中的`applyStyles`方法
   - 添加新的样式检测逻辑

2. 修改界面：
   - 编辑resources/fxml/main.fxml
   - 更新MainController.java中的事件处理

3. 添加新格式支持：
   - 扩展FormatConfig.java中的配置项
   - 在DocumentStyler.java中实现新格式处理

## 依赖项
- Apache POI 5.2.3 (处理Word文档)
- SLF4J/Logback (日志记录)
- JavaFX 11+ (图形界面)

## 开发环境
- Java 8+
- Maven 3.6+
- JavaFX SDK (11+)![输入图片说明](cover.png)