docs: 更新README,添加main.png截图和项目结构说明

This commit is contained in:
2026-05-16 12:17:25 +08:00
parent af03d18470
commit f2b5be312c
2 changed files with 38 additions and 12 deletions

View File

@@ -4,21 +4,47 @@
## 截图 ## 截图
![主界面](main.png)
启动页 → 选择 ePub 文件 → Kindle 风格阅读界面。 启动页 → 选择 ePub 文件 → Kindle 风格阅读界面。
## 功能 ## 功能
- 打开 .epub 文件(原生文件对话框) - 📂 打开 .epub 文件(原生文件对话框)
- Kindle 风格阅读界面(顶部工具栏 + 中央正文 + 底部进度条) - 📖 Kindle 风格阅读界面(顶部工具栏 + 中央正文 + 底部进度条)
- 点击左右区域翻页(左 30% 上一页、右 30% 下一页) - 🖱️ 点击左右区域翻页(左 30% 上一页、右 30% 下一页)
- 键盘 ← → 翻页 - ⌨️ 键盘 ← → 翻页
- 目录侧栏(可展开/收起) - 📋 目录侧栏(可展开/收起)
- 字体大小调节A⁺ / A⁻ - 🔖 书签功能
- 日间/夜间模式切换 - 🔍 字体大小调节A⁺ / A⁻
- 底部进度条可拖动跳转 - 🌓 日间/夜间/棕褐色模式切换
- 自动保存阅读位置 - 🎨 多种背景纹理(牛皮纸/稿纸/作文纸/自定义图片)
- 最近文件列表 - 📏 响应式分页引擎(基于 egui Galley 精确测量)
- 设置持久化settings.json - 🔗 内容锚点定位(字体/窗口大小变化后自动恢复阅读位置
- 📊 底部进度条可拖动跳转
- 💾 自动保存阅读位置
- 📅 最近文件列表
- ⚙️ 设置持久化settings.json
## 项目结构
```
epub-read/
├── src/
│ ├── main.rs # 程序入口 + 字体初始化
│ ├── app.rs # App 状态管理 + 事件循环
│ ├── book.rs # ePub 解析 + 章节数据结构
│ ├── reader.rs # 响应式分页引擎 + 阅读视图渲染
│ ├── theme.rs # 主题/配色/设置/书签/阅读位置
│ ├── style.rs # 排版样式配置(对齐/行高/缩进)
│ ├── texture.rs # 背景纹理生成
│ ├── font.rs # 中文字体设置
│ └── persistence.rs # 配置文件读写
├── fonts/
│ └── NotoSansSC-Regular.ttf # 内嵌中文字体
├── Cargo.toml
└── .cargo/config.toml # 静态链接配置
```
## 系统要求 ## 系统要求
@@ -60,7 +86,7 @@ cargo build --release
## 开发 ## 开发
```bash ```bash
cargo test # 运行测试24 个) cargo test # 运行测试(32 个)
cargo check # 编译检查 cargo check # 编译检查
cargo run # 调试运行 cargo run # 调试运行
``` ```

BIN
main.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 868 KiB