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

一款优雅的古典诗词学习与欣赏微信小程序

扫码体验小程序

✨ 项目简介

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

🎯 核心功能

📚 诗词库

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

👨‍🎨 作者专区

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

🎲 飞花令

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

🔍 智能搜索

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

⭐ 个人收藏

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

🎨 精美设计

• 古典配色: 深褐色 (#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. 克隆项目

   git clone https://github.com/tianyaxiang/poetry-app.git
   cd poetry-app

2. 配置 API

   • 修改 config/api.js 中的 BASE_URL 为你的后端服务地址
   • 确保后端 poetry-api 服务正常运行

3. 导入项目

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

4. 预览运行

   • 在开发者工具中预览
   • 或生成预览二维码在手机上测试

📱 功能截图

首页 - 优雅的古典诗词展示

🤝 贡献指南

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

贡献方式

• 🐛 报告 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 开源协议。

🙏 致谢

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

📞 联系我们

• 项目地址: GitHub Repository
• 问题反馈: Issues
• 邮箱: tianyaxiang@qq.com

---

让古典诗词在数字时代绽放新的光彩 ✨

Made with ❤️ for Chinese Classical Poetry