# 2Html

**Repository Path**: xmgh1024_admin/2Html

## Basic Information

- **Project Name**: 2Html
- **Description**: word、excel转换html文件
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-03
- **Last Updated**: 2026-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Word转HTML转换器

一个基于Java和Spring Boot的Word文档转HTML工具，支持将.doc和.docx格式的Word文档转换为HTML格式。

## 功能特性

- ✅ 支持.doc和.docx格式的Word文档转换
- ✅ 保持原文档的布局、字体和结构
- ✅ 图片自动内嵌为base64编码，生成独立的HTML文件
- ✅ 生成的HTML文件名与原文档保持一致
- ✅ 提供Web界面，支持文件上传和下载
- ✅ 控制台输出详细的转换日志

## 技术栈

- Java 1.8
- Spring Boot 2.7.18
- Apache POI 5.2.5
- Maven 3.x
- Thymeleaf

## 项目结构

```
word2html/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/word2html/
│   │   │       ├── Word2HtmlApplication.java    # 主启动类
│   │   │       ├── controller/
│   │   │       │   └── Word2HtmlController.java # Web控制器
│   │   │       └── service/
│   │   │           └── WordToHtmlService.java   # 转换服务
│   │   └── resources/
│   │       ├── application.yml                   # 应用配置
│   │       ├── logback-spring.xml               # 日志配置
│   │       └── templates/
│   │           └── index.html                   # 前端页面
│   └── test/
├── pom.xml                                       # Maven配置
└── README.md                                     # 项目说明
```

## 构建和运行

### 前置要求

- JDK 1.8或更高版本
- Maven 3.x

### 编译项目

```bash
mvn clean compile
```

### 打包项目

```bash
mvn clean package
```

打包完成后，会在`target`目录下生成可执行的jar包：`word2html-1.0.0.jar`

### 运行项目

```bash
java -jar target/word2html-1.0.0.jar
```

或者使用Maven直接运行：

```bash
mvn spring-boot:run
```

### 访问应用

启动成功后，在浏览器中访问：

```
http://localhost:8080
```

## 使用说明

1. **上传Word文档**
   - 点击"选择Word文档"按钮
   - 选择.doc或.docx格式的文件
   - 系统会自动验证文件格式并开始转换

2. **下载HTML文档**
   - 转换成功后，点击"下载HTML文档"按钮
   - 下载的HTML文件名与原Word文档名称保持一致

## 注意事项

- 支持的最大文件大小为50MB
- 转换后的HTML文件包含所有图片（base64编码），文件可能较大
- 建议使用现代浏览器访问Web界面

## 开发说明

### 日志输出

应用会在控制台输出详细的转换日志，包括：
- 文件上传信息（文件名、大小、类型）
- 转换过程信息
- 图片处理信息
- 错误信息（如有）

### 配置说明

主要配置在`application.yml`中：
- 服务端口：8080
- 最大文件大小：50MB
- 日志级别：INFO（com.word2html包为DEBUG）

## 许可证

本项目仅供学习和研究使用。