# JSONBlog

**Repository Path**: codekpy/jsonblog

## Basic Information

- **Project Name**: JSONBlog
- **Description**: 基于JSON配置存储信息的轻量化博客
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-28
- **Last Updated**: 2025-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JSONBlog

基于JSON配置管理的轻量级静态博客系统，无需数据库，简单易用且易于迁移。

## ✨ 功能特点

- **纯JSON配置**：通过`site.json`管理网站所有信息，无需数据库
- **静态生成**：一键生成完整静态HTML文件，部署简单
- **分区展示**：支持博客内容分区分类展示
- **响应式设计**：适配各种设备屏幕尺寸
- **简洁美观**：采用苹果风格设计语言，玻璃态UI效果
- **Markdown支持**：使用Markdown编写博客内容，自动转换为HTML

## 🚀 快速开始

### 环境要求
- PHP 7.4+（用于生成静态文件）
- 任意Web服务器（Nginx/Apache等）

### 安装步骤

1. 克隆本仓库
```bash
git clone https://gitee.com/codekpy/jsonblog.git
cd jsonblog
```

2. 配置网站信息
编辑`static/config/site.json`文件，设置网站标题、作者信息、社交链接等

3. 生成静态文件

通过浏览器访问：
```
http://yourdomain.com/BlogMake.php?make=index
http://yourdomain.com/BlogMake.php?make=posts
http://yourdomain.com/BlogMake.php?make=partitions
```

4. 部署
将生成的`index.html`、`posts`和`static`目录部署到任意Web服务器


## ⚙️ 配置说明

### site.json主要配置项

| 配置项 | 说明 |
|--------|------|
| title | 网站标题 |
| description | 网站描述 |
| author | 作者名称 |
| url | 网站URL |
| about | 关于作者信息 |
| works | 项目作品列表 |
| partitions | 博客分区配置 |
| social links | 社交媒体链接 |

### 添加博客文章

1. 在`static/md/`目录下创建Markdown文件（格式：`[id].md`）
2. 在`static/config/blogList.json`中添加文章信息

## 📁 目录结构

```
JSONBlog/
├── .gitignore
├── .htaccess
├── BlogMake.php      # 静态文件生成工具
├── index.html        # 生成的静态首页
├── index.php         # 动态入口文件
├── posts/            # 生成的静态文章页面
└── static/
    ├── config/
    │   ├── blogList.json  # 博客文章列表配置
    │   └── site.json      # 网站基本配置
    ├── css/              # 样式文件
    ├── js/               # JavaScript文件
    └── md/               # Markdown文章源文件
```

## 🤝 贡献指南

欢迎提交issues和pull requests来帮助改进这个项目。

## 📄 许可证

[MIT](LICENSE)