🍞 Toast Blog 文档

零框架依赖的个人技术博客与作品集网站，使用 Vite 6 + 原生 JavaScript 构建。

本文档覆盖项目的架构设计、功能模块、开发指南与运维说明。

技术栈

快速开始

git clone https://github.com/sml-toast/toast-blog.git
cd toast-blog
npm install
npm run dev   # 启动开发服务器 → http://localhost:5174

更多脚本见 README。

脚本说明

多环境切换

支持 DEV / TEST / PROD 三套独立配置。

每个环境拥有独立的 localStorage 数据存储和配置开关（多语言启用/禁用、环境切换按钮显示等）。

多语言配置

支持中文和英文两种语言，语言包位于 data/lang/ 目录。

登录与缓存

管理后台 /admin.html 访问需密码 admin。

登录后 30 分钟内免登录，关闭浏览器仍然有效。退出时清除缓存。

数据管理

后台支持作品/教程/Wiki/学习路线的 CRUD 操作，数据存储在 localStorage，环境隔离。

备份与还原

支持导出 ZIP（含附件）和 JSON 两种格式。还原时选择备份文件恢复。

目录结构

toast-blog/
├── index.html            # 主页面
├── main.js               # 核心 JS
├── style.css             # 全局样式
├── doc.html              # 文档页（当前）
├── admin.html            # 管理后台
├── admin.js              # 后台脚本
├── data/                 # 数据层
│   ├── projects.js
│   ├── tutorials.js
│   ├── wiki.js
│   ├── path.js
│   ├── loader.js
│   └── i18n.js
├── public/               # 静态资源
├── scripts/              # 工具脚本
└── doc/                  # 设计文档

部署指南

推送 main 分支即可触发 GitHub Actions 自动构建和部署：

git push origin main
# GitHub Actions 自动运行 → GitHub Pages

更新日志