hexo-festival-popup

Hexo 插件：节日 / 公祭日 / 生日弹窗，支持公历 & 农历，浅色 / 深色模式

功能

• 公历节日、农历节日、公祭日、生日弹窗
• 不同主题区分：喜庆 / 公祭 / 生日
• 自定义显示策略：
  • day：当天只显示一次
  • page：每次刷新页面都显示
• 自定义生日
• 浅色 / 深色模式弹窗样式

安装

npm install hexo-festival-popup

目录结构：

hexo-festival-popup/          
├── index.js                  ← 插件入口：注入 CSS / JS / CDN 和配置
├── package.json              ← 插件信息（name / version / keywords 等）
├── README.md                 ← 使用说明、配置指南
└── source/                   
    ├── js/                   
    │   ├── lunar.js          ← 农历计算脚本，festival.js 依赖它
    │   └── festival.js       ← 节日弹窗逻辑：读取配置并显示弹窗
    └── css/
        └── festival.css      ← 弹窗主题样式（春节、元宵节、端午节、中秋节、生日、公祭日）

配置

在 Hexo _config.yml 添加节日配置：

festival:
  enable: true
  display_mode: day       # day | page
  birthday:
    enable: true
    month: 11
    day: 20

配置说明

| 配置项 | 说明 | | --------------- | ------------------------------------------ | | enable | 是否启用节日弹窗 | | display_mode | 显示策略：day 当天一次 / page 每次刷新 | | birthday.enable | 是否启用生日弹窗 | | birthday.month | 生日月份（数字） | | birthday.day | 生日日期（数字） |

支持的节日示例

• 公历节日：元旦、国庆、圣诞等
• 农历节日：春节、元宵、端午、中秋、重阳等
• 公祭日：九一八、卢沟桥、南京大屠杀
• 自定义生日

注意事项

• 使用前需要在 _config.yml 添加配置

开发

• 如果想修改样式，请编辑 source/css/festival.css
• 弹窗主题已区分：
  • spring：春节
  • lantern：元宵
  • dragonboat：端午
  • midautumn：中秋
  • memorial：公祭日
  • birthday：生日
  • festival：其他节日