项目简介
Stardust SSG 是一个为个人博客和项目展示定制的轻量级静态站点生成器。
核心理念：本地 Markdown 写作，自动同步发布，零干预部署。
界面展示
首页 - 暗色主题
二次元萌系风格，粒子动画背景，数据统计一目了然。
首页 - 亮色主题
一键切换亮色模式，同样精致。
博客列表
支持按分类筛选，卡片式布局，分类色彩标识。
文章详情 - TOC 目录
长文章自动生成左侧 TOC 目录，当前章节高亮，方便导航。
项目展示
开发进度条、版本历史 Timeline、状态标签，一目了然。
标签云
所有标签汇总，点击查看相关文章。
已完成功能
核心引擎
- Markdown 原生支持（markdown-it），front matter 元数据解析（gray-matter）
- 文件夹结构即分类，无需手动配置
- 同名文件夹自动关联图片和附件，构建时自动重写路径
- Prism.js 代码语法高亮（支持 JS/TS/Python/Bash/CSS/JSON/YAML/C/C++ 等）
- 一键 rsync 部署到远程服务器
- chokidar 文件监听，开发时自动重建
主题与界面
- 二次元萌系暗色/亮色双主题，一键切换
- 粒子动画背景（Canvas 绘制，自适应密度）
- 完全响应式布局，手机端友好
- 滚动淡入动画（IntersectionObserver）
- 自定义 404 页面（星尘飘落动画）
- 五角星 SVG Favicon
内容展示
- 博客列表页，支持按分类筛选
- 项目展示页：开发进度条、版本历史 Timeline、状态标签
- 标签云页面 + 单标签文章列表
- 更新记录页面（Changelog Timeline）
阅读体验
- 文章目录 TOC 侧栏（桌面端左侧固定，自动高亮当前章节）
- 阅读时间估算（中文 400 字/分钟，英文 200 词/分钟）
- 图片懒加载（loading=“lazy”）
- 回到顶部按钮（滚动 400px 后显示）
- 客户端全文搜索（Ctrl+K 快捷键，预生成 JSON 索引）
SEO 与国际化
- sitemap.xml 自动生成
- RSS Feed（feed.xml）
- robots.txt
- Open Graph + Twitter Card 元标签
- 多语言支持：中文 / English / 日本語
- UI 文本 i18n（data-i18n 属性），IP 自动检测语言
- Google Translate 集成，文章内容自动翻译
技术栈
- 运行时: Node.js + ES Modules
- Markdown: markdown-it（自定义图片重写、TOC 提取、heading anchor）
- 模板: EJS
- 代码高亮: Prism.js（服务端预渲染）
- 样式: 纯 CSS（CSS Variables 实现主题切换，无框架依赖）
- 部署: rsync over SSH
待开发
- [ ] 评论系统（Giscus）
- [ ] 阅读进度条
- [ ] 文章分享按钮
- [ ] 文章上一篇/下一篇导航
- [ ] 图片灯箱（Lightbox）