静态博客系统说明

本系统是一个基于 Markdown 的轻量级静态博客解决方案，使用JSON 数据和 PHP 脚本生成的静态博客系统，使用 HTML、CSS 和 JavaScript 前端渲染内容，无需传统数据库。所有文章内容均以 Markdown 格式存储，适合追求简洁高效的个人博客使用。

[Markdown] -> [PHP 生成 JSON] -> [前端html和js渲染] -> [浏览器展示]

• 核心组件：
  • marked.js：Markdown 解析器
  • highlight.js：代码语法高亮
  • MathJax：数学公式渲染
  • DOMPurify：内容安全过滤

.
├── admin/            # 管理后台
├── md/               # Markdown 文档库
│   └── 分类名称/     
│       └── 文档.md  
├── libs/             # 第三方依赖库
├── blog.css          # 主样式表
├── blog.js           # 前端逻辑
├── json.php          # 数据生成入口
├── s.js             # 搜索插件（隐藏展开按钮）可自定义功能
└── ...

• Web 服务器：需要一个支持 PHP 的 Web 服务器（如 Apache 或 Nginx）。
• 浏览器：使用现代浏览器访问博客页面。部署步骤
  1. 将整个项目文件夹上传到 Web 服务器的根目录。
  2. 确保 md 文件夹有写入权限，以便后台管理脚本可以创建和修改文件。
  3. 访问 域名 查看博客内容。
  4. 访问 /admin 进入后台管理界面。

1. 方式一：通过管理后台

   • 访问 /admin 登录（默认账号：admin/admin）
   • 使用可视化编辑器编写内容
   • 选择分类并发布

2. 方式二：手动创建

   # 在 md 目录创建分类文件夹
   mkdir md/技术文章
   
   # 新建 Markdown 文件（推荐格式）
   touch md/技术文章/服务器部署指南.md

• 文件命名：标题.md（示例：静态博客指南.md）

1. 内容管理：

   • 实时预览编辑
   • 分类管理
   • 草稿系统

2. 系统维护：

   • 数据备份恢复 (backup.php)
   • 静态资源打包
   • 访问统计（需自行集成）

// 修改默认凭证（auth.php）
$valid_username = 'your_username';  // 修改管理员账号
$valid_password = 'strong_password'; // 设置强密码

1. 定期执行 /admin/backup.php 进行数据备份
2. Markdown 文件尽量使用 UTF-8 编码
3. 分类目录需先在 md 文件夹中创建
4. 修改凭证后需清除浏览器缓存

系统持续更新中，建议定期关注 GitHub 仓库获取最新版本