poetry-app

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 15 Open GitHub ↗

诗词有典微信小程序

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 诗词有典 - 古典诗词小程序

<div align="center">
  <img src="doc/assets/logo.png" alt="诗词有典" width="120" height="120">
  
  <p>一款优雅的古典诗词学习与欣赏微信小程序</p>
  
  ![微信小程序](https://img.shields.io/badge/微信小程序-诗词有典-brightgreen)
  ![License](https://img.shields.io/badge/license-MIT-blue)
  ![Version](https://img.shields.io/badge/version-1.0.0-orange)
  
  <br>
  
  <img src="doc/assets/shici.jpg" alt="小程序码" width="200" height="200">
  
  <p><em>扫码体验小程序</em></p>
</div>

## ✨ 项目简介

诗词有典是一款专注于中华古典诗词的微信小程序，致力于为用户提供优雅的诗词阅读、学习和互动体验。项目采用古典雅致的设计风格，融合现代交互理念，让传统文化在数字时代焕发新的生机。

## 🎯 核心功能

### 📚 诗词库
- **海量诗词**: 收录唐诗、宋词等各朝代经典作品
- **分类浏览**: 按朝代、作者、主题等多维度分类
- **详细信息**: 提供作品背景、作者介绍、注释解析

### 👨‍🎨 作者专区
- **作者列表**: 展示各朝代著名诗人词人
- **作者详情**: 详细的生平介绍和文学成就
- **作品集**: 按作者查看其所有作品

### 🎲 飞花令
- **互动游戏**: 经典的诗词接龙游戏
- **关键字匹配**: 支持花、月、雪等多个主题
- **寓教于乐**: 在游戏中学习和记忆诗词

### 🔍 智能搜索
- **全文搜索**: 支持诗词内容、作者、标题搜索
- **高级筛选**: 按朝代、体裁等条件精确筛选
- **搜索历史**: 记录搜索记录，方便重复查找

### ⭐ 个人收藏
- **收藏管理**: 收藏喜爱的诗词作品
- **本地存储**: 数据本地保存，随时查看
- **快速访问**: 一键访问收藏的内容

### 🎨 精美设计
- **古典配色**: 深褐色 (#2c1810) + 棕色 (#8b4513) + 金色 (#d4af37)
- **优雅界面**: 符合古典美学的视觉设计
- **流畅交互**: 现代化的用户体验设计

## 🛠️ 技术架构

### 前端技术
- **框架**: 微信小程序原生开发
- **样式**: WXSS + 响应式设计
- **状态管理**: 全局数据管理
- **本地存储**: 微信小程序 Storage API

### 后端服务
- **API**: 基于 poetry-api 项目提供数据服务
- **数据源**: 丰富的古典诗词数据库
- **接口设计**: RESTful API 设计规范

### 项目结构
```
poetry-app/
├── app.js                 # 小程序入口文件
├── app.json              # 小程序配置文件
├── app.wxss              # 全局样式文件
├── assets/               # 静态资源
│   └── icons/           # 图标资源
├── config/              # 配置文件
│   └── api.js          # API 配置
├── pages/               # 页面文件
│   ├── index/          # 首页
│   ├── poem/           # 诗词相关页面
│   ├── author/         # 作者相关页面
│   ├── flying-flower/  # 飞花令游戏
│   ├── search/         # 搜索页面
│   ├── collection/     # 收藏页面
│   └── profile/        # 个人中心
├── services/            # 服务层
│   ├── poem.js         # 诗词服务
│   └── request.js      # 网络请求
└── store/              # 数据存储
    ├── dynasties.js    # 朝代数据
    ├── poetry.js       # 诗词数据
    └── poetryType.js   # 诗词类型
```

## 🚀 快速开始

### 环境要求
- 微信开发者工具
- Node.js (可选，用于开发工具)

### 安装步骤

1. **克隆项目**
   ```bash
   git clone https://github.com/tianyaxiang/poetry-app.git
   cd poetry-app
   ```

2. **配置 API**
   - 修改 `config/api.js` 中的 `BASE_URL` 为你的后端服务地址
   - 确保后端 poetry-api 服务正常运行

3. **导入项目**
   - 打开微信开发者工具
   - 选择"导入项目"
   - 选择项目目录并填写 AppID

4. **预览运行**
   - 在开发者工具中预览
   - 或生成预览二维码在手机上测试

## 📱 功能截图

<div align="center">
  <img src="doc/screenshot/home.jpg" alt="首页界面" width="300">
  <p><em>首页 - 优雅的古典诗词展示</em></p>
</div>

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 贡献方式
- 🐛 报告 Bug
- 💡 提出新功能建议
- 📝 改进文档
- 🔧 提交代码

### 开发流程
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📄 开源协议

本项目基于 [MIT License](LICENSE) 开源协议。

## 🙏 致谢

- 感谢所有为中华古典文化传承做出贡献的开发者
- 感谢 poetry-api 项目提供的数据支持
- 感谢微信小程序平台提供的技术支持

## 📞 联系我们

- 项目地址: [GitHub Repository](https://github.com/tianyaxiang/poetry-app)
- 问题反馈: [Issues](https://github.com/tianyaxiang/poetry-app/issues)
- 邮箱: tianyaxiang@qq.com

---

<div align="center">
  <p>让古典诗词在数字时代绽放新的光彩 ✨</p>
  <p>Made with ❤️ for Chinese Classical Poetry</p>
</div>

poetry-app

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README