# DBlog

**Repository Path**: sunjie0216/DBlog

## Basic Information

- **Project Name**: DBlog
- **Description**: DBlog：djangoblog system，是基于python3 + django3 + mysql8 + redis + uwsgi + nginx  的一个便于入门学习的多主题博客系统
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://www.xwboy.top/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 29
- **Created**: 2022-09-18
- **Last Updated**: 2022-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

###### 📢❗❗❗ 2022.2.22 ❗❗❗

```text
📢 小幅升级维护
``` 

###### 👨‍💻👩‍💻旧版本更新到最新 master 请先点这里 [升级事宜](https://www.xwboy.top/blog/detail/10/)

###### 👀 如果你未正在使用旧版本的话，直接按照安装使用说明部署即可

# Django博客系统

项目基本完成，处于试运行阶段，示例网站为当前分支最新代码，
如果您想查看旧版本，可以到标签中选择对应的版本进行下载

ps: 个人博客在一些逻辑和限制上面考虑还欠周全，存在bug，不影响正常使用，
后续开发已暂缓，欢迎 pull request，我将在审阅并测试后第一时间通知您

[![python3](https://img.shields.io/badge/Python-3.8-red.svg)](https://www.python.org/downloads)
[![Django3.2](https://img.shields.io/badge/Django-3.2-green.svg)](https://docs.djangoproject.com/zh-hans/3.2)
[![simpleui](https://img.shields.io/badge/developing%20with-Simpleui-2077ff.svg)](https://github.com/newpanjing/simpleui)

🙈🙈🙈 使用Django快速搭建博客系统，采用Django框架最基础结构（仅一个app）

优点：减少逻辑性，便于入门学习...

缺点：内容沉余，不够灵活...

### 基本要求

* Python: 3.8
* Django: 3.2
* Mysql: 8
* Redis

### 示例博客：http://www.xwboy.top/

### 功能点

* 用户注册，登录，登出，注销，密码邮箱验证重置
* markdown文章渲染，代码高亮，支持后台markdown编写文章等
* 文章分类，归档，快捷搜索，标签集
* 4 种皮肤（清新，清爽，简约，暗黑）切换
* 文章排行榜 / 最新评论 / 阅读量排行榜
* 博文评论系统（基本功能）
* 多目标源博文分享（支持https）
* echarts 博文发布，标签统计图（折线图，饼图，梯形图）
* 文章分类 雷达统计图（雷达图）
* 网站配置数据 redis 缓存
* windows: django-gzip压缩主站，linux: nginx-gzip压缩全站
* Rss / Atom 订阅
* 支持图床，后台上传图片并展示，可直链访问及调用
* simpleui后台管理

###### ps: 如果访问网站期间，你使用了某些墙代理网络，会失去一些网页功能 ！！！

## ⬇ 源码下载

```
wget https://gitee.com/wu_cl/DBlog.git/master.zip
or
git clone https://gitee.com/wu_cl/DBlog.git
```

敏感词文件内容 static/sensitive_words/sensitive_words_lines.txt,
请前往 [sensitive_words](https://github.com/wjhgg/sensitive_words) 进行替换

## 使用

> ⚠️: 此过程请格外注意端口占用情况, 特别是 8000, 3306, 6379...

### 1. 传统

1. 安装所有依赖
    ```shell
    pip install -r requirements.txt
    ```

2. 创建数据库 blog，选择 UTF8MB4 编码
3. 检查并修改 djangoProject/settings.py mysql 数据库配置
4. 数据库迁移
   ```shell
   #  生成迁移文件
   python manage.py makemigrations
   
   # 执行迁移
   python manage.py migrate
   ```
5. 百度安装redis客户端, 安装完启动服务
6. 检查并修改 djangoProject/settings.py redis 数据库配置

### 2. docker

1. 在 docker-compose.yml 文件所在目录下执行一键启动命令

   ```shell
   docker-compose up -d --build
   ```

## 访问

创建管理员用户： `python manage.py createsuperuser`


后台：http://127.0.0.1:8000/admin

主页：http://127.0.0.1:8000

## 🙏 搭建Linux服务端

### 1. 传统

请移步 [wikis](https://gitee.com/wu_cl/DBlog/wikis/pages) 查看

### 2. docker

与使用方式相同

## ❓ 问题相关

欢迎提交问题到 [Issues](https://gitee.com/wu_cl/DBlog/issues) 或直接在下方评论, 我将在看到问题后第一时间回复