目录

1. 系统概述

2. 系统要求

3. 安装部署

4. 登录系统

5. 前台使用说明

6. 后台管理说明

7. 文章管理

8. 页面管理

9. 分类管理

10. 标签管理

11. 评论管理

12. 系统设置

13. 个人资料设置

14. 常见问题解答

15. 更新日志

系统概述

婳阳博客系统是一个功能完整的单页面博客系统，采用现代化渐变色设计和响应式布局。系统基于PHP+SQLite轻量级架构，无需配置复杂数据库，开箱即用。

主要特性

• 🎨 五种渐变主题：蓝色、紫色、绿色、橙色、粉色渐变色系

• 📱 响应式设计：完美适配桌面、平板和手机

• 🛡️ 安全可靠：验证码登录和多重安全防护

• ⚡ 快速高效：基于PHP+SQLite的轻量级架构

• 📝 富文本编辑器：支持图文混排和格式编辑

• 🔍 SEO优化：完整的SEO设置和优化

• 🏷️ 分类标签：多彩分类标签和文章分类

• 💬 评论系统：完善的评论和审核机制

• 📊 统计分析：后台数据统计和图表展示

系统要求

服务器环境

• PHP版本：PHP 7.0 或更高版本

• 扩展支持：PDO、SQLite3、GD库（用于验证码）

• 文件权限：需要写入权限（用于创建数据库和上传文件）

客户端要求

• 现代浏览器（Chrome、Firefox、Safari、Edge等）

• 启用JavaScript

• 屏幕分辨率建议1024×768以上

安装部署

步骤1：上传文件

将 index.php 文件上传到您的网站根目录（或任意子目录）。

步骤2：设置权限

确保以下目录具有写入权限（755或777）：

• 根目录（用于创建 blog.db 数据库文件）

• uploads/ 目录（用于存储上传的头像和图片）

步骤3：访问网站

在浏览器中访问您的网站地址，系统会自动创建数据库和默认数据。

步骤4：默认登录信息

• 用户名：huayang

• 密码：huayang

登录系统

前台登录入口

1. 在网站首页侧边栏找到"管理员登录"按钮

2. 点击进入登录页面

3. 或直接访问 ?action=login

登录步骤

1. 输入用户名（默认：huayang）

2. 输入密码（默认：huayang）

3. 输入验证码（不区分大小写）

4. 点击"登录"按钮

提示：验证码可以点击刷新，如果看不清可点击验证码区域更换。

前台使用说明

导航栏

• 首页：显示最新文章列表

• 分类名称：点击查看该分类下的所有文章

• 页面名称：点击查看独立页面（如关于我们、联系我们）

文章列表页

• 每篇文章显示标题、作者、发布时间、阅读量、摘要

• 点击"阅读全文"按钮查看完整文章

• 支持分页浏览

文章详情页

• 显示完整文章内容

• 显示文章分类和标签

• 显示评论列表

• 支持发表评论（需开启评论功能）

侧边栏功能

• 搜索框：输入关键词搜索文章

• 文章分类：显示所有分类，点击可筛选

• 页面导航：显示所有独立页面链接

• 热门标签：显示所有标签，点击可搜索相关文章

• 网站统计：显示文章总数和分类数量

• 管理员登录：快速进入后台

移动端适配

• 在小屏幕设备上，导航栏会自动折叠为汉堡菜单

• 点击右上角"☰"按钮展开菜单

后台管理说明

进入后台

登录成功后，自动跳转到后台管理界面。

后台布局

• 左侧菜单栏：包含所有管理功能入口

• 顶部工具栏：显示当前页面标题和时间，快速跳转到主题设置

• 主内容区：显示当前功能的详细内容

文章管理

查看文章列表

1. 点击左侧菜单"📝 文章管理"

2. 显示所有文章的列表，包含ID、标题、作者、状态、发布时间

3. 支持查看、编辑、删除操作

新建文章

1. 点击"新建文章"按钮

2. 填写以下信息：

   • 标题（必填）：文章标题

   • 别名/URL（必填）：用于生成链接地址，如：my-first-article

   • 摘要：文章简介，用于列表显示

   • 内容（必填）：文章正文，支持富文本编辑

   • 分类：勾选所属分类

   • 标签：勾选相关标签

   • 状态：选择"已发布"或"草稿"

3. SEO设置（可选）：

   • SEO标题：搜索引擎显示标题

   • SEO描述：搜索引擎显示描述

   • SEO关键词：多个关键词用逗号分隔

4. 点击"保存文章"

富文本编辑器使用

编辑器工具栏包含以下功能：

• 粗体：将选中文字加粗

• 斜体：将选中文字斜体

• 下划线：添加下划线

• 标题1/2/3：设置标题级别

• 列表：创建无序列表

• 编号：创建有序列表

• 引用：创建引用块

• 代码：插入代码片段

• 链接：插入超链接

编辑文章

1. 在文章列表中找到要编辑的文章

2. 点击"编辑"按钮

3. 修改内容后点击"保存文章"

删除文章

1. 在文章列表中找到要删除的文章

2. 点击"删除"按钮

3. 确认删除操作

页面管理

查看页面列表

1. 点击左侧菜单"📄 页面管理"

2. 显示所有页面的列表

新建页面

1. 点击"新建页面"按钮

2. 填写以下信息：

   • 标题（必填）：页面标题

   • 别名/URL（必填）：用于生成链接地址，如：about-us

   • 内容（必填）：页面正文，支持富文本编辑

   • 状态：选择"已发布"或"草稿"

3. SEO设置（可选）

4. 点击"保存页面"

编辑/删除页面

操作方式与文章管理相同。

分类管理

查看分类列表

1. 点击左侧菜单"🏷️ 分类管理"

2. 显示所有分类，包含名称、别名、描述、颜色

新建分类

1. 点击"新建分类"按钮

2. 填写以下信息：

   • 名称（必填）：分类显示名称

   • 别名/URL（必填）：用于生成链接地址

   • 描述：分类说明

   • 颜色：分类主题颜色，可从色板选择

3. 点击"保存分类"

编辑分类

1. 在分类列表中找到要编辑的分类

2. 点击"编辑"按钮

3. 修改后保存

删除分类

• 注意：如果分类下已有文章，无法删除，需先移除或重新分配文章分类

标签管理

查看标签列表

1. 点击左侧菜单"🏷️ 标签管理"

2. 显示所有标签

新建标签

1. 点击"新建标签"按钮

2. 填写以下信息：

   • 名称（必填）：标签名称

   • 别名/URL（必填）：用于生成链接地址

   • 颜色：标签颜色

3. 点击"保存标签"

编辑/删除标签

操作方式与分类管理相同。

评论管理

查看评论列表

1. 点击左侧菜单"💬 评论管理"

2. 显示所有评论，包含评论者、邮箱、关联文章、内容、状态

评论状态说明

• 待审：新发表的评论，需要管理员审核

• 通过：已审核通过的评论，在前台显示

• 驳回：已驳回的评论，在前台不显示

审核评论

1. 在待审评论后点击"通过"按钮，评论状态变为"通过"

2. 或点击"驳回"按钮，评论状态变为"驳回"

删除评论

点击"删除"按钮，确认后永久删除评论

系统设置

基本设置

1. 点击左侧菜单"⚙️ 系统设置"

2. 设置以下信息：

   • 网站标题：浏览器标题栏显示

   • 网站描述：SEO描述信息

   • 网站关键词：SEO关键词

   • 页脚信息：底部版权文字

主题颜色

五种渐变主题可选：

• 蓝色渐变：默认主题

• 紫色渐变：浪漫紫色系

• 绿色渐变：清新绿色系

• 橙色渐变：活力橙色系

• 粉色渐变：温柔粉色系

文章设置

• 每页显示文章数：首页和分类页每页显示的文章数量（1-50篇）

• 评论设置：允许评论/关闭评论

功能设置

• 启用SEO优化：生成结构化数据

• 启用动画效果：页面加载动画和滚动动画

• 显示特色图片：文章缩略图显示

• 启用评论系统：控制评论功能开关

• 启用搜索功能：控制搜索框显示

• 启用网站统计：侧边栏显示统计数据

网站统计代码

支持粘贴第三方统计代码，如Google Analytics、百度统计等，会自动添加到页面底部。

个人资料设置

修改密码

1. 点击左侧菜单"👤 个人资料"

2. 在"修改密码"区域：

   • 输入当前密码

   • 输入新密码（至少6位）

   • 确认新密码

3. 点击"修改密码"

上传头像

1. 在"头像设置"区域：

   • 点击"选择文件"选择图片

   • 支持jpg、jpeg、png、gif、webp格式

   • 文件大小不超过2MB

2. 点击"上传头像"

账户信息

显示用户名、邮箱、注册时间、最后登录时间等账户信息（邮箱为只读，暂不支持修改）

常见问题解答

Q1：忘记管理员密码怎么办？

解决方法：可以通过SQLite数据库管理工具（如DB Browser for SQLite）打开 blog.db 文件，在 users 表中修改密码字段。密码使用 password_hash() 函数加密，可以用以下PHP代码生成新密码：

<?php
echo password_hash('新密码', PASSWORD_DEFAULT);
?>

Q2：无法上传头像或图片？

检查项：

1. 确认 uploads/ 目录存在且具有写入权限（755或777）

2. 检查文件大小是否超过2MB

3. 确认文件格式是否为支持的类型（jpg、jpeg、png、gif、webp）

Q3：文章别名（slug）重复怎么办？

系统会自动检测并添加时间戳后缀，确保别名唯一性。

Q4：评论无法提交？

检查项：

1. 系统设置中"启用评论系统"是否开启

2. "评论设置"是否设置为"允许评论"

3. 是否填写了姓名和评论内容

Q5：搜索结果为空？

• 确保关键词输入正确

• 系统会搜索文章标题、内容和摘要

• 中文关键词支持正常搜索

Q6：如何备份数据？

直接备份 blog.db 数据库文件和 uploads/ 目录即可。

Q7：如何迁移到其他服务器？

1. 复制 index.php 文件

2. 复制 blog.db 数据库文件

3. 复制 uploads/ 目录及所有文件

4. 在新服务器上设置正确的文件权限

更新日志

v2.3 (2024-01-15)

• 修复后台管理菜单跳转逻辑

• 修复分类页面数据获取问题

• 修复搜索功能变量作用域

• 优化渐变主题色彩系统

• 改进卡片悬停效果和阴影

• 增强响应式设计适配

v2.2 (2024-01-10)

• 新增五种渐变主题

• 新增富文本编辑器

• 新增SEO优化功能

• 新增分类标签多彩显示

• 新增评论审核机制

• 新增后台统计图表

v2.1 (2024-01-05)

• 修复数据库初始化问题

• 优化验证码生成逻辑

• 改进移动端菜单显示

v2.0 (2024-01-01)

• 初始版本发布

• 完整的博客系统功能

技术支持

如有任何问题或建议，请联系：

• 邮箱：6115511@qq.com

• 电话：+86 131 6112 6555

祝您使用愉快！ 🎉