enjoy-binbin/Django-blog

:yum: A blog system based on python3.6 and Django2.1

blog
django
django-blog
python
python3

BinBlog

Blog演示地址, 后续基本迁移到语雀

基于 python3.6Django2.2的博客系统

license Build Status codecov Coverage Status Requirements Status

其他说明:

  1. 博客部署请参考docker-compose.yml文件说明, 原docker目录下的说明已经过时, 如需联系可以直接email我
  2. 以前第一版django-blog。基于Django1.9的pyblog,前端自己设计的/捂脸。不维护了的
  3. 对于使用Docker部署,可以看docker目录下的文件或者看Docker-djangoblog仓库。
  4. 抛弃亚马逊云部署了,使用github page纯静态页面部署,本地开发一键生成HTML文件并进行github push. (演示图看最下,站点看首页)

本地开发环境

  1. win10 64位
  2. 后端技术栈:Python3.6、Django2.2、Djangorestframework 3.9、Celery4
  3. 数据库:持久化Mysql,缓存Memcache,消息队列Redis
  4. 前端技术栈:Jquery、Bootstrap
  5. 开发工具:PyCharm 2018.1
  6. admin后台: fake_admin fake_admin
  7. 线上环境: AWS ,Ubuntu18.04,Nginx+(gunicorn or uwsgi),Mysql5.7,Python3.6(站点已停)
  8. 线上代码不同步的,一直在本地开发鼓捣

主要功能

  • 二次开发的admin后台管理系统,轻松进行站点配置
  • 文章分类,文章,文章标签,相册图片的增删改查,展示,文章搜索
  • 文章编辑支持 Markdown , 文章详情支持Markdown,支持代码高亮
  • 支持文章列表分页(写入缓存),文章评论留言
  • 用户注册登陆(可选邮箱验证),支持github oauth登陆
  • 右侧侧边栏功能,最热文章,最新文章,标签云
  • 文章根据添加时间进行归档
  • 使用Djangorestframework对博客进行API开发(在blog/api目录下)
  • 使用logging记录错误日志,使用celery+redis进行一些异步任务的调度
  • 增加伪多用户博客系统,用户注册可以拥有对自己文章的增删改查操作,可以写文章
  • 相册功能,有两种样式,不喜欢的可以在admin设置里关闭,或者选其一,在base/nav.html里修改
  • 根据文章内容分类,使用模板生成简单的HTML文件,并且推送到github page托管

使用到

  • djangorestframework和 restframework-jwt进行API学习开发
  • django通用视图,ListViewDetailView,FromView,RedirectView
  • admin的扩展,ModelAdmin扩展,SimpleListFilter自定义过滤器,二次开发
  • 自定义LoginView,RegisterView,LogoutView,部分django自带auth用法
  • context_processors自定义模板全局变量
  • 侧边栏编辑页 TextFields使用 pagedown 支持 markdown
  • 文章内容使用 mdeditor支持markdown图片上传
  • templatetags 自定义模板标签 tags,支持markdown,代码高亮
  • 使用haystack和whoosh实现的全文文章搜索功能
  • slug的用法
  • 使用django-compress压缩css/js
  • django简单中间件的编写,显示页面加载时间
  • 使用django的sitemap功能
  • python-memcached对网站的部分信息缓存
  • 自定义django.manage命令,create_fake_data,生成测试数据,clear_migrations清理迁移文件
  • django中使用logging模块、message模块
  • 使用celery+redis进行异步的邮件发送

安装

  1. 安装依赖(最好新建个虚拟环境),两种方式都可以,前者豆瓣源好记住,后者阿里源包更齐全的感觉
  2. pip install -Ur requirements -i https://pypi.douban.com/simple
  3. pip install -i https://mirrors.aliyun.com/pypi/simple -r requirements.txt
  4. 配置设置将settings.py.example改成 settings.py
  5. 自行修改 binblog/settings.py 里的数据库配置:

    DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'blog', # 数据库名称, 需要自己手动创建, 编码指定为utf8 # create database blog default character set utf8 collate utf8_general_ci; 'USER': 'root', # 数据库账号 'PASSWORD': '123456', # 数据库密码 'PORT': 3306, # 数据库端口, 默认为3306 'HOST': '127.0.0.1', # 数据库地址 'TEST': { 'NAME': 'test_db', # 测试数据库名称 'CHARSET': 'utf8', # 测试数据库编码 'COLLATION': 'utf8_general_ci' } } }

  6. 创建数据库 create database binblog;

  7. 在终端下进行数据迁移:

    ./manage.py makemigrations ./manage.py migrate

  8. 创建测试数据 ./manage.py create_fake_data

  9. 根据需要使用Navicat导入目录下的 sql文件 ./ manage.py createsuperuser

  10. 运行 ./manage.py runserver 8000

  11. 浏览器打开 127.0.0.1:8000

  12. 配置项(更多设置看settings和blog.model.Setting模型)

持续学习,源码中有大量注释,适合有Django基础的童鞋~

感谢观看和star,欢迎提issue

部分演示图,没同步到线上环境的

display

display

display

display

display

display

display

display

display

display

display

Stars
82
100.00% more than last month
Forks
19
Open Issues
5