# capitalism

**Repository Path**: sessionbean/capitalism

## Basic Information

- **Project Name**: capitalism
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 书籍浏览网站

一个基于Flask的书籍浏览网站，用于浏览EPUB格式的书籍。前端使用自定义HTML/CSS/JavaScript界面，后端提供RESTful API。

## 功能特性

- 📚 浏览Books目录下的EPUB书籍
- 📖 查看书籍章节列表
- 🔍 阅读章节内容
- 🖼️ 显示书籍封面
- 🔄 响应式设计，支持移动设备
- ⚡ 快速加载和流畅的用户体验

## 项目结构

```
.
├── app.py                 # Flask主应用
├── requirements.txt       # Python依赖
├── books.py              # 书籍管理模块
├── api/                  # API路由
│   ├── __init__.py
│   └── books.py          # 书籍API
├── templates/            # HTML模板
│   └── index.html        # 主页面
├── static/               # 静态文件
│   └── default-cover.jpg # 默认封面
├── Books/                # 书籍目录
│   └── The Dutch House/  # 示例书籍（已解压的EPUB）
└── thorium-web/          # Thorium Web前端（备用）
```

## 安装和运行

### 1. 安装Python依赖

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

### 2. 添加书籍

将EPUB文件放入`Books/`目录。应用会自动扫描该目录下的书籍。

支持两种方式：
- 直接放置EPUB文件（如 `Books/book.epub`）
- 放置已解压的EPUB目录（如 `Books/book/`）

### 3. 运行应用

```bash
python app.py
```

应用将在 http://localhost:5000 启动。

## API接口

### 获取书籍列表
```
GET /api/books/
```

响应示例：
```json
{
  "books": [
    {
      "id": "The Dutch House",
      "title": "The Dutch House",
      "cover": "/static/books/The Dutch House/cover.jpeg",
      "chapters_count": 6
    }
  ]
}
```

### 获取书籍详情
```
GET /api/books/{book_id}
```

### 获取书籍章节
```
GET /api/books/{book_id}/chapters
```

### 获取章节内容
```
GET /api/books/{book_id}/chapters/{chapter_id}
```

## 使用说明

1. 访问 http://localhost:5000
2. 页面将显示所有可用的书籍
3. 点击书籍卡片查看章节列表
4. 点击章节查看内容
5. 使用返回按钮导航回上一级

## 技术栈

- **后端**: Python Flask
- **前端**: HTML5, CSS3, JavaScript (ES6)
- **数据处理**: BeautifulSoup4 (解析EPUB文件)
- **API**: RESTful JSON API
- **跨域**: Flask-CORS

## 扩展功能

### 添加更多书籍
只需将新的EPUB文件或解压目录放入`Books/`目录，应用会自动检测。

### 自定义样式
修改 `templates/index.html` 中的CSS样式。

### 集成Thorium Web
如果需要使用专业的阅读器界面，可以构建并集成Thorium Web：

```bash
cd thorium-web/thorium-web-1.1.4
npm install
npm run build
```

然后修改 `app.py` 以使用Thorium Web作为前端。

## 故障排除

### 书籍未显示
- 检查书籍是否放置在正确的 `Books/` 目录
- 确保EPUB文件已解压或应用有读取权限
- 查看控制台日志了解扫描错误

### 封面不显示
- 检查封面图片路径
- 确保 `static/` 目录存在
- 书籍目录中应有 `cover.jpeg` 或 `cover.jpg` 文件

### API返回404
- 确保应用正在运行
- 检查API端点URL是否正确
- 查看Flask控制台输出

## 许可证

MIT License

## 作者

书籍浏览网站项目