# ebook_reader_mac

**Repository Path**: flulife/ebook_reader_mac

## Basic Information

- **Project Name**: ebook_reader_mac
- **Description**: Mac版电子书阅读器，一个简洁、功能丰富的TXT格式电子书阅读器，专为macOS平台优化
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-07
- **Last Updated**: 2025-10-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 电子书阅读器（Mac版）

一个简洁、功能丰富的TXT格式电子书阅读器，专为macOS平台优化，采用PyQt5开发，提供舒适的阅读体验和丰富的定制选项。

> **注意**：本项目已提供macOS平台的打包应用（ebook_reader.app），其他平台用户需自行打包。

## 功能特点

- 📖 **TXT格式支持**：完美支持TXT文件阅读和编码自动检测
- 📑 **智能目录生成**：支持多种正则表达式模板，自动生成章节列表
- 🔖 **书签管理**：添加、删除、跳转书签，方便记录阅读重点
- 📚 **书架功能**：保存喜爱的书籍，快速访问
- 🎨 **多主题切换**：包括默认、护眼、夜间、浅色、纸张以及多个莫奈艺术风格主题
- 📏 **字体定制**：自由选择字体和字号，适应不同阅读习惯
- 💾 **阅读进度保存**：自动保存和恢复阅读位置，无需手动记录
- 🌙 **沉浸式阅读**：专注阅读模式，隐藏不必要的界面元素
- ⌨️ **快捷键支持**：多种操作支持键盘快捷键，提高使用效率

## macOS平台快速使用指南

### 方法一：直接使用已打包应用（推荐）

https://gitee.com/flulife/ebook_reader_mac/releases/tag/1.0%EF%BC%88%E5%86%85%E9%83%A81,2%EF%BC%89
下载解压即可运行


### 方法二：从源码运行

1. 确保已安装Python 3.6或更高版本

2. 安装所需依赖：

```bash
pip install -r requirements.txt
```

3. 运行应用程序：

```bash
python ebook_reader.py
```

### 方法三：自行打包应用

如果您想从源码打包成Mac应用程序，可以使用提供的打包脚本：

```bash
# 运行基础打包脚本
./basic_package.sh
```

打包成功后，应用程序将位于 `build/ebook_reader.app` 目录下。

> 更多详细的打包说明和问题解决方法，请查看项目中的 `README_MacOS_QuickStart.md` 文件。

## 其他平台用户须知

本项目已针对macOS平台进行了优化并提供了预打包应用。其他平台（如Windows、Linux）的用户需要自行安装依赖并打包应用。

### 其他平台安装依赖

```bash
pip install -r requirements.txt
```

### 其他平台运行

```bash
python ebook_reader.py
```

### 其他平台打包建议

- Windows平台：可考虑使用PyInstaller或cx_Freeze工具进行打包
- Linux平台：可考虑使用PyInstaller或直接通过包管理器分发

## 使用方法

### 打开电子书
- 点击菜单栏的"文件" -> "打开文件"，或使用快捷键Ctrl+O
- 直接将TXT文件拖放到应用程序窗口

### 目录操作
- 打开书籍后，程序会自动尝试生成目录
- 点击左侧面板的"目录"标签查看章节列表
- 点击章节名称可快速跳转到对应内容
- 可通过"视图" -> "设置章节正则"自定义目录提取规则

### 书签管理
- 在阅读界面选中文字后右键点击"添加书签"，或使用快捷键Ctrl+B
- 点击左侧面板的"书签"标签查看所有书签
- 点击书签可跳转到对应位置
- 右键点击书签可删除

### 书架管理
- 点击"书签" -> "添加到书架"将当前书籍添加到书架
- 点击左侧面板的"书架"标签查看已添加的书籍
- 双击书籍可直接打开

### 主题和字体设置
- 通过"视图"菜单选择不同主题
- 通过"格式"菜单自定义字体和字号

### 沉浸式阅读模式
- 点击工具栏的"沉浸式阅读"按钮，或使用快捷键F11进入
- 在沉浸式模式下，点击屏幕中央或按Esc退出

## 支持的文件格式

- TXT文件（支持UTF-8和GBK编码）

## 项目结构

```
├── ebook_reader.app/  # macOS预打包应用程序（直接可用）
├── ebook_reader.py    # 主程序源码
├── basic_package.sh   # macOS基础打包脚本
├── requirements.txt   # 项目依赖
├── README.md          # 项目说明文档
└── README_MacOS_QuickStart.md # macOS平台详细指南
```

## 主题设置

程序内置多种主题，包括：
- 默认主题
- 护眼主题（柔和绿色背景）
- 夜间主题（深色背景，保护视力）
- 浅色主题（简洁白色背景）
- 纸张主题（仿真纸张效果）
- 莫奈系列艺术主题（灵感来自莫奈名画）
  - 莫奈·睡莲
  - 莫奈·干草堆
  - 莫奈·日出印象
  - 莫奈·鲁昂大教堂

## 快捷键

| 快捷键 | 功能 |
|-------|------|
| Ctrl+O | 打开文件 |
| Ctrl+B | 添加书签 |
| Ctrl+S | 保存进度 |
| Ctrl++ | 增大字体 |
| Ctrl+- | 减小字体 |
| F11 | 切换沉浸式模式 |
| Esc | 退出沉浸式模式 |
| Ctrl+Q | 退出程序 |

## 开发者信息

作者：weakboy
版本：1.2

## 注意事项

- 程序会自动保存阅读进度和设置，重启后恢复
- 对于编码复杂的TXT文件，可能需要手动选择正确的编码方式
- 书架数据保存在程序运行目录下

## 更新日志

### 版本1.2
- 新增莫奈系列艺术主题
- 优化界面响应速度
- 修复部分编码问题
- 增强书签管理功能

### 版本1.1
- 添加书架功能
- 优化主题切换机制
- 改进阅读体验

### 版本1.0
- 初始版本，实现基本阅读功能