# poem

**Repository Path**: HealthCare/poem

## Basic Information

- **Project Name**: poem
- **Description**: 一个精美的微信小程序，收录了中国历代诗词，支持按朝代、诗人、诗词合集等多种方式浏览和搜索。
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-27
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 历代诗词宝库

一个精美的微信小程序，收录了中国历代诗词，支持按朝代、诗人、诗词合集等多种方式浏览和搜索。

## 项目简介

历代诗词宝库是一款专注于中国古典诗词的微信小程序，收录了从先秦到清代的经典诗词作品。用户可以通过多种方式浏览诗词，包括按朝代分类、按诗人查询、按诗词合集浏览等。同时支持实时搜索功能，方便快速查找感兴趣的诗词或诗人。

## 功能特点

### 核心功能
- **朝代浏览**：按朝代分类浏览诗词，涵盖先秦、两汉、魏晋、唐宋、元明清等各个历史时期
- **诗人查询**：查看历代诗人信息，包括生平简介、创作年代等
- **诗词合集**：浏览精选诗词合集，如唐诗三百首、宋词三百首等
- **诗词搜索**：支持按诗词标题和诗人姓名实时搜索
- **诗词详情**：查看诗词完整内容、作者信息及相关背景

### 交互特性
- 现代化 UI 设计，采用卡片式布局和渐变配色
- 流畅的页面切换和动画效果
- 搜索历史记录和热门搜索推荐
- 上拉加载更多，分页展示数据
- 响应式设计，适配不同屏幕尺寸

## 项目结构

```
poem/
├── miniprogram/                 # 小程序主目录
│   ├── pages/                   # 页面目录
│   │   ├── index/              # 首页
│   │   ├── dynasty/            # 朝代列表页
│   │   ├── dynastyDetail/      # 朝代详情页
│   │   ├── authors/            # 诗人列表页
│   │   ├── authorDetail/       # 诗人详情页
│   │   ├── poemCollection/     # 诗词合集列表页
│   │   ├── poemCollectionDetail/ # 诗词合集详情页
│   │   ├── poem/               # 诗词列表页
│   │   └── poemDetail/         # 诗词详情页
│   ├── services/               # 服务层
│   │   ├── poemService.js      # 诗词服务
│   │   ├── authorService.js    # 诗人服务
│   │   ├── dynastyService.js   # 朝代服务
│   │   └── collectionService.js # 诗词合集服务
│   ├── style/                  # 全局样式
│   ├── images/                 # 图片资源
│   ├── app.js                  # 小程序入口
│   ├── app.json                # 小程序配置
│   └── app.wxss                # 全局样式
├── project.config.json         # 项目配置
└── README.md                   # 项目说明
```

## 数据统计

| 数据类型 | 数量 | 说明 |
|---------|------|------|
| 诗词 | 9,788 首 | 涵盖历代经典诗词 |
| 诗人 | 362 位 | 从先秦到清代著名诗人 |
| 朝代 | 多个 | 先秦至清代各个历史时期 |
| 诗词合集 | 多个 | 如唐诗三百首、宋词三百首等 |

## 技术栈

- **框架**：微信小程序原生框架
- **语言**：JavaScript
- **样式**：WXSS（WeiXin Style Sheets）
- **数据存储**：本地 JSON 数据文件
- **转译器**：SWC

## 页面说明

### 1. 首页 (index)
小程序启动页，提供功能导航入口。

### 2. 朝代列表 (dynasty)
展示所有朝代分类，点击可查看该朝代的诗词列表。

### 3. 朝代详情 (dynastyDetail)
展示指定朝代的所有诗词，支持分页加载。

### 4. 诗人列表 (authors)
展示所有诗人信息，支持按姓名和朝代搜索，包含搜索历史和热门搜索功能。

### 5. 诗人详情 (authorDetail)
展示诗人的详细信息，包括生平简介、创作年代、代表作品等，以及该诗人的诗词列表。

### 6. 诗词合集列表 (poemCollection)
展示所有诗词合集，如唐诗三百首、宋词三百首等。

### 7. 诗词合集详情 (poemCollectionDetail)
展示指定诗词合集的所有诗词。

### 8. 诗词列表 (poem)
展示所有诗词，支持按标题和作者实时搜索，支持分页加载。

### 9. 诗词详情 (poemDetail)
展示诗词的完整内容、作者信息、朝代等详细信息。

## 数据结构

### 诗词数据
```javascript
{
  "id": "1",
  "title": "悍吏",
  "author": "郑燮",
  "dynasty": "清"
}
```

### 诗人数据
```javascript
{
  "id": "1",
  "name": "屈原",
  "dynasty": "先秦",
  "start_year": 340,
  "end_year": 278,
  "description": "屈原（约公元前340—公元前278年）..."
}
```

## 使用方法

### 开发环境
1. 安装微信开发者工具
2. 克隆项目到本地
3. 使用微信开发者工具打开项目目录
4. 点击编译按钮即可预览

### 项目配置
- 在 `project.config.json` 中配置项目基本信息
- 在 `app.json` 中配置页面路由和窗口样式

### 数据管理
诗词和诗人数据存储在 `services` 目录下的对应服务文件中，如需更新数据，可直接编辑相应的 JSON 数据数组。

## 开发说明

### 添加新页面
1. 在 `pages` 目录下创建新的页面文件夹
2. 创建对应的 `.js`、`.json`、`.wxml`、`.wxss` 文件
3. 在 `app.json` 的 `pages` 数组中注册新页面

### 样式规范
- 使用 rpx 作为单位，适配不同屏幕
- 遵循现代化设计风格，使用卡片式布局
- 统一使用渐变配色和圆角设计

### 代码规范
- 使用 ES6+ 语法
- 服务层使用 Promise 处理异步操作
- 页面逻辑与数据分离，使用服务层管理数据

## 参考资源

- [微信小程序官方文档](https://developers.weixin.qq.com/miniprogram/dev/framework/)
- [微信开发者工具下载](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)

## 版本历史

### v1.0.0
- 初始版本发布
- 实现基础浏览和搜索功能
- 收录 9,788 首诗词和 362 位诗人
- 现代化 UI 设计

## 许可证

本项目仅供学习和交流使用。