# format conversion

**Repository Path**: Aa520042/format-conversion

## Basic Information

- **Project Name**: format conversion
- **Description**: 文件格式转换
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-07
- **Last Updated**: 2025-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件格式转换工具

基于PyQt6开发的多格式文件转换应用程序，支持多种文档、电子书、图像等格式之间的转换。

## 功能特性

### 支持的转换格式

#### 📄 文档与文本类
- **DOC/DOCX** ⇄ PDF
- **DOC/DOCX** ⇄ ODT
- **XLS/XLSX** ⇄ PDF
- **XLS/XLSX** ⇄ ODS
- **PPT/PPTX** ⇄ PDF
- **PPT/PPTX** ⇄ ODP
- **PDF** ⇄ TXT
- **RTF** ⇄ DOCX/TXT
- **HTML** ⇄ PDF
- **Markdown (.md)** ⇄ HTML
- **Markdown (.md)** ⇄ DOCX
- **Markdown (.md)** ⇄ PDF

#### 📚 电子书类
- **EPUB** ⇄ MOBI
- **EPUB** ⇄ PDF
- **MOBI** ⇄ EPUB
- **MOBI** ⇄ PDF
- **AZW3** ⇄ EPUB

## 界面预览

- 🎨 现代化的PyQt6界面
- 📁 直观的文件选择器
- 📊 实时转换进度显示
- 📝 详细的转换日志
- ⚙️ 多种转换类型选择

## 快速开始

### 1. 运行应用程序

```bash
# 方法1: 使用启动脚本（推荐）
python run.py

# 方法2: 直接运行主程序
python main.py
```

### 2. 检查依赖

如果程序无法正常运行，请先检查依赖：

```bash
python dependency_checker.py
```

## 安装说明

### 系统要求

- Python 3.8 或更高版本
- Windows 10/11, macOS 10.14+, 或 Linux

### Python依赖安装

```bash
# 安装所有Python依赖
pip install -r requirements.txt

# 或者单独安装核心依赖
pip install PyQt6 python-docx pandas python-pptx PyPDF2 markdown
```

### 外部工具安装

#### LibreOffice (必需)
- **用途**: Office文档转换
- **下载**: [LibreOffice官网](https://www.libreoffice.org/download/download/)
- **支持格式**: DOC/DOCX/XLS/XLSX/PPT/PPTX ↔ PDF/ODT/ODS/ODP

#### Calibre (可选)
- **用途**: 电子书格式转换
- **下载**: [Calibre官网](https://calibre-ebook.com/download)
- **支持格式**: EPUB/MOBI/AZW3互转

#### wkhtmltopdf (可选)
- **用途**: HTML转PDF
- **下载**: [wkhtmltopdf官网](https://wkhtmltopdf.org/downloads.html)
- **支持格式**: HTML → PDF

## 使用方法

### 基本操作流程

1. **启动程序**: 运行 `python run.py`
2. **选择输入文件**: 点击"选择输入文件"按钮
3. **设置输出路径**: 点击"设置输出路径"按钮
4. **选择转换类型**: 从下拉菜单中选择需要的转换格式
5. **开始转换**: 点击"开始转换"按钮
6. **查看结果**: 转换完成后会显示成功消息

### 转换示例

#### 将Word文档转换为PDF
1. 选择 `.docx` 文件作为输入
2. 设置输出文件为 `.pdf` 格式
3. 选择转换类型："DOC/DOCX → PDF"
4. 点击开始转换

#### 将Markdown转换为HTML
1. 选择 `.md` 文件作为输入
2. 设置输出文件为 `.html` 格式
3. 选择转换类型："Markdown → HTML"
4. 点击开始转换

## 项目结构

```
formatConversion/
├── main.py                 # 主程序文件
├── converter.py            # 转换核心模块
├── dependency_checker.py   # 依赖检查工具
├── run.py                  # 启动脚本
├── requirements.txt        # Python依赖列表
├── README.md              # 项目说明
└── INSTALL_GUIDE.md       # 详细安装指南
```

## 技术架构

### 核心组件

- **PyQt6**: GUI框架，提供现代化用户界面
- **FileConverter**: 核心转换引擎，支持多种格式转换
- **ConversionThread**: 多线程转换，避免界面冻结
- **DependencyChecker**: 依赖检查和管理工具

### 转换引擎

- **LibreOffice**: Office文档转换的主要引擎
- **Calibre**: 电子书格式转换
- **Python库**: 各种专用转换库
  - `python-docx`: Word文档处理
  - `pandas`: Excel数据处理
  - `PyPDF2`: PDF文件处理
  - `markdown`: Markdown转换

## 故障排除

### 常见问题

#### 1. "未找到LibreOffice"错误
**解决方案**:
- 确保已安装LibreOffice
- 检查系统PATH环境变量
- Windows用户可能需要重启命令行

#### 2. Python包导入失败
**解决方案**:
```bash
# 升级pip
pip install --upgrade pip

# 重新安装依赖
pip install -r requirements.txt

# 使用国内镜像（如果网络慢）
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
```

#### 3. 转换失败
**可能原因**:
- 输入文件损坏或格式不正确
- 输出路径没有写入权限
- 缺少相应的转换工具

**解决方案**:
- 检查输入文件是否正常
- 确保输出目录存在且有写入权限
- 运行依赖检查工具确认所需工具已安装

### 获取帮助

1. 运行依赖检查: `python dependency_checker.py`
2. 查看详细安装指南: `INSTALL_GUIDE.md`
3. 检查转换日志中的错误信息

## 开发说明

### 添加新的转换格式

1. 在 `converter.py` 中添加新的转换方法
2. 在 `supported_conversions` 字典中注册新方法
3. 在 `main.py` 的 `setup_conversion_types()` 中添加UI选项

### 代码结构

- `main.py`: GUI界面和用户交互
- `converter.py`: 核心转换逻辑
- `dependency_checker.py`: 依赖管理
- `run.py`: 启动和初始化

## 许可证

本项目采用MIT许可证，详见LICENSE文件。

## 贡献

欢迎提交Issue和Pull Request来改进这个项目！

---

**注意**: 某些转换功能需要安装相应的外部工具。请根据需要安装LibreOffice、Calibre等工具以获得完整功能。