# almanac

**Repository Path**: ye0927/almanac

## Basic Information

- **Project Name**: almanac
- **Description**: 黄历微信小程序
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-25
- **Last Updated**: 2026-04-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 黄历 - Alamanac

## 项目简介

黄历是一个基于微信小程序的日历应用，提供公历和农历信息查询功能。应用程序包含三个主要功能模块：今日运势、幸运日期选择和关于页面。

## 功能特性

### 📅 今日页面 (Today)
- 显示当天的公历和农历日期信息
- 展示当日的黄历相关信息

### 🍀 幸运日期 (Lucky Days)
- 提供日期选择功能
- 根据传统历法推荐吉利日期
- 方便用户查询特定日期的运势信息

### ℹ️ 关于页面 (About)
- 应用介绍和使用说明
- 提供反馈和联系方式

## 技术栈

- **框架**: 微信小程序 (WeChat Mini Program)
- **核心功能**: 农历/公历日期处理 (lunar.js)
- **页面结构**: WXML (模板), WXSS (样式), JS (逻辑), JSON (配置)

## 项目结构

```
almanac/
├── app.js              # 应用入口文件
├── app.json            # 应用配置
├── images/             # 图标资源
│   ├── about.png
│   ├── about-selected.png
│   ├── logo.png
│   ├── today.png
│   ├── today-selected.png
│   ├── lucky-days.png
│   └── lucky-days-selected.png
├── pages/
│   ├── today/          # 今日页面
│   ├── lucky-days/     # 幸运日期页面
│   └── about/          # 关于页面
└── utils/
    └── lunar.js        # 农历历法工具库
```

## 安装与运行

1. 下载并安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)

2. 克隆项目到本地：
   ```bash
   git clone https://gitee.com/jkslili/almanac.git
   ```

3. 使用微信开发者工具打开项目目录

4. 点击"编译"按钮运行项目

## 使用说明

1. 在微信开发者工具中运行项目
2. 使用微信扫码在手机端预览
3. 微信小程序版本可直接搜索"黄历"体验

## API参考

### 农历工具库 (utils/lunar.js)

提供农历日期计算功能，支持：
- 公历转农历
- 农历转公历
- 获取节假日信息
- 黄历宜忌查询

## 贡献指南

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

## 许可证

本项目遵循相关开源许可证。

## 联系方式

- 项目地址: https://gitee.com/jkslili/almanac
- 问题反馈: 请在 Gitee Issues 中提交

## 致谢

感谢所有为项目做出贡献的开发者！