logo
0
0
WeChat Login
HunLi-Xl<hunli@example.com>
docs: 完善 README,新增本地预览建议与主仓库链接,优化文档结构

高考倒计时(高中版)

一个纯前端的高考倒计时单页应用,开箱即用。支持自定义目标考试时间、联系方式与样式,适合部署到本地或任何静态网站托管平台。

本项目已支持:每日自动更换背景图(本地轮换,无需外部服务)。

仓库地址

如需提交 Issue/PR,请在主仓库进行。

功能特性

  • 倒计时展示:精准到秒的高考倒计时(默认 2026-06-07 09:00:00)
  • 视觉效果:玻璃球、下雪等装饰元素与全屏滚动切换
  • 每日背景:按当天日期自动从本地图片集轮换背景图
  • 联系方式区块:支持邮箱、QQ、微信等方式展示
  • 纯前端静态:无需后端服务,直接双击 time.html 即可
  • 易于自定义:日期、标题、文案、样式均可快速修改

目录结构

Gaokao_time-main/ ├─ time.html # 主页(倒计时与联系信息) ├─ css/ │ ├─ timestyle.css # 站点主要样式(包含 .bg-container 布局) │ ├─ fullpage.css # 全屏滚动样式 │ ├─ font-awesome.min.css # 字体图标样式 │ └─ BG/ # 背景图片目录(本地轮换图片) ├─ js/ │ ├─ script.js # 页面交互逻辑与初始化(内含每日背景轮换代码) │ ├─ countdown.min.js # 倒计时库 │ ├─ jquery.min.js # jQuery │ ├─ jquery.fullpage.min.js # 全屏滚动库 │ └─ three.canvas.js # 动效相关库 ├─ images/ # 其他图片资源(含装饰图) ├─ fonts/ # Font Awesome 字体资源 ├─ Other/ # 其他附加资源(可选) ├─ LICENSE # 开源协议 └─ README.md # 项目说明文档(本文件)

快速开始

  • 本地直接打开:

    1. 下载仓库或解压到任意目录
    2. 双击 time.html 用浏览器打开即可
  • 静态托管部署(任选其一):

    • GitHub Pages / Gitee Pages / Netlify / Vercel / 静态服务器(Nginx/Apache 等)
    • 将整个项目目录上传到托管服务或服务器的站点目录下即可访问

本地预览与部署建议

  • 建议使用现代浏览器直接打开 time.html 进行快速预览
  • 若需模拟线上路径或避免跨域问题,可使用本地静态服务器(任选其一):
    • VS Code 插件 Live Server 一键预览
    • Python: python -m http.server 8080(需已安装 Python)
    • Node: npx http-server . -p 8080(需已安装 Node.js)

自定义指南

  1. 修改倒计时目标日期与标题
  • 打开 time.html:
    • 修改标题:2026高考倒计时 与页面

      2026高考倒计时

    • 修改倒计时目标:
    • 时间格式:YYYY MM DD HH:MM:SS(空格分隔,时分秒用冒号)
  1. 每日背景轮换(本地)
  • 背景图片放在 css/BG 目录中,示例已内置多张图片
  • 轮换逻辑位于 js/script.js:
    • 通过 bgList 数组维护可用图片列表(相对路径,如 'css/BG/20230528.jpg')
    • 页面加载后根据当天日期计算索引,每天 00:00(本地时间)切换到对应图片
    • 样式层的 .bg-container 不再固定 background-image,实际背景由脚本动态设置
  • 使用方法:
    • 增加图片:将图片放入 css/BG,并把相对路径加入 js/script.js 的 bgList 数组
    • 删除图片:从 bgList 中移除对应条目即可
    • 立即验证:刷新浏览器即可看到当日匹配的背景;如需快速测试切换,可暂时调整 bgList 顺序或用控制台修改 dayIndex 逻辑
  1. 修改联系方式
  • 在 time.html 的“联系方式”区块内替换 QQ、微信、邮箱等文案与链接
  • 注意:源码中“源码仓库”图标的 a 标签有一处写成了 herf,应改为 href 以确保可点击; 同时建议将仓库链接替换为主仓库:https://gitee.com/HunLi-Xl/Gaokao_time
  1. 视觉与样式调整
  • 全局样式主要在 css/timestyle.css 中,可根据需要调整颜色、布局、动效
  • 顶部光效与玻璃球叠层位于 timestyle.css 中的 .top-light 与 .glass-ball 选择器

离线可用性与稳定性(外链说明)

页面引用了外部样式/脚本:

为确保离线可用与 HTTPS 环境下的稳定加载,建议:

  • 将上述文件下载到本地并改为相对路径引用;或
  • 替换为你可控且支持 HTTPS 的 CDN/静态资源地址。

浏览器支持

  • 现代浏览器(Chrome、Edge、Firefox、Safari 等最新版)
  • 项目基于原生 HTML5/CSS3/ES 标准与常用前端库实现,不依赖非标准 API

开发与规范

  • 技术栈:纯前端静态页面 + jQuery 生态部分库
  • 代码组织:HTML/CSS/JS 分离;请保持语义化与可维护性
  • 质量建议:
    • 修改脚本前先阅读 js/script.js 初始化与交互逻辑
    • 若自建工程,可接入 ESLint/Stylelint 做规范校验

常见问题(FAQ)

  1. 为什么没有显示或样式错乱?
  • 可能因外链资源加载失败;请参考“离线可用性与稳定性”章节本地化相关文件
  1. 每日背景不生效?
  • 检查 js/script.js 中 bgList 是否包含有效图片路径;确保这些文件存在于 css/BG 目录
  • 确认 timestyle.css 的 .bg-container 未被其他样式覆盖 background-image
  • 打开浏览器控制台查看是否有 404 或脚本错误
  1. 如何固定某张背景?
  • 方式一:在 js/script.js 中将 $('.bg-container').css('background-image', ...) 改为固定路径
  • 方式二:在 css/timestyle.css 的 .bg-container 中重新写入固定的 background-image(会覆盖脚本设置,不推荐与脚本并存)

如何贡献

  • Issue:欢迎就功能建议、缺陷反馈在主仓库提交 Issue
  • PR:欢迎提交 Pull Request(请尽量保持代码风格一致,避免引入未使用的依赖)
  • 讨论:如需新增功能或大改动,建议先开 Issue 讨论设计方案

维护者与联系方式

  • 页面在 time.html 中默认展示了一组联系方式(QQ/微信/邮箱),可按需替换为你的信息

许可证

  • 本项目遵循仓库中的 LICENSE 文件(以实际内容为准)

致谢

  • jQuery (jquery.min.js)
  • fullPage.js (jquery.fullpage.min.js)
  • Countdown.js (countdown.min.js)
  • Three.js canvas 相关实现 (three.canvas.js)
  • Font Awesome(字体与图标)

如果你在使用或二次开发过程中遇到问题,欢迎提交 Issue 或 PR。祝你金榜题名!