#有问题欢迎加qq群
vmaig qq群: 458788510
我的qq: 994171686
#更新日志
2015/5/15 从django1.6 升级到 django1.8 (还保留django1.6分支)
2015/6/21 添加xadmin分支,xadmin分支中使用xadmin作为后台管理(使用 django 1.8),如果你想后台比较漂亮可以切换到xadmin分支(注意你不需要pip install django-xadmin 但是需要安装django-crispy-forms跟django-reversion详细步骤见xadmin分支中的README)
2015/7/5 对xadmin分支中的错误进行了比较大的修改
2016/3/17 添加评论回复
2016/3/22 添加Dockerfile,使用Docker部署本博客
#概述 vmaig_blog 是一个基于 Django1.8 跟 Bootstrap3 开发的 博客系统 ,实现了一个博客完整的功能。http://vmaig.com 就是基于vmaig_blog 搭建的。 #功能
- 文章,分类,专栏的添加,删除,修改。支持tinymce富文本编辑器。支持文章中代码高亮。
- 实现用户注册,登陆,修改密码,忘记重置密码。通过邮箱通知注册用户, 用户忘记密码基于邮件(需要在setting.py设置好邮箱)。
- 实现用户头像,用户可以上传头像,然后编辑头像大小,然后保存,头像可以存在本地,也可自动保存在七牛云中(需要在setting.py 中设置好七牛的相关配置)。
- 支持评论,实现了一个独立的评论系统。
- 首页支持显示轮播,显示最新评论,显示人气最高的文章。
- 首页支持显示标签云,拥有一个非常酷炫的便签云。
- 拥有一个动态加载的“全部文章”板块 可以显示所有文章分类,可以按照浏览数或者时间排序显示文章。
- 拥有一个以时间轴显示的非常酷炫的“新闻”板块,你可以每天在后台添加新闻。
- 支持手机浏览,对手机浏览进行了调整。
#Demo http://vmaig.com
#安装运行 安装virtualenv :
sudo pip install virtualenv
创建并激活虚拟环境 :
virtualenv www
cd www
source bin/active
下载代码,切换目录 :
git clone https://github.com/billvsme/vmaig_blog
cd vmaig_blog
首先安装相关Pillow 用到的c库 : (详见https://pillow.readthedocs.org/en/3.1.x/installation.html#building-on-linux)
sudo apt-get install libtiff5-dev libjpeg8-dev zlib1g-dev \
libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev python-tk
然后 :
pip install -r requirements.txt
(注意如果使用python3,还需要pip install python3-memcached)
配置setting.py :
vim vmaig_blog/setting.py
设置其中的 PAGE_NUM 每页显示文章数,EMAIL_HOST(你用的邮箱的smtp),EMAIL_PORT(smtp端口),EMAIL_HOST_USER(你的邮箱的用户名),EMAIL_HOST_PASSWORD(你的邮箱密码),如果要使用七牛设置好七牛的相关配置。
注意:如果想用使用ssl的邮箱(比如qq邮箱),请安装django-smtp-ssl,详见https://github.com/bancek/django-smtp-ssl
# 分页配置
PAGE_NUM = 3
# email配置
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = '' #SMTP地址 例如: smtp.163.com
EMAIL_PORT = 25 #SMTP端口 例如: 25
EMAIL_HOST_USER = '' #我自己的邮箱 例如: xxxxxx@163.com
EMAIL_HOST_PASSWORD = '' #我的邮箱密码 例如 xxxxxxxxx
EMAIL_SUBJECT_PREFIX = u'vmaig' #为邮件Subject-line前缀,默认是'[django]'
EMAIL_USE_TLS = True #与SMTP服务器通信时,是否启动TLS链接(安全链接)。默认是false
DEFAULT_FROM_EMAIL = EMAIL_HOST_USER
# 七牛配置
QINIU_ACCESS_KEY = ''
QINIU_SECRET_KEY = ''
QINIU_BUCKET_NAME = ''
# 网站标题等内容配置
WEBSITE_TITLE = u'Vmaig'
WEBSITE_WELCOME = u'欢迎来到Vmaig'
初始化数据库 :
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
运行 :
python manage.py runserver
使用docker部署,首先pull下来image或者自己使用项目中Dockerfile或者Dockerfile_cn build。
sudo docker pull billvsme/vmaig_blog
然后运行image
例子:
sudo docker run -d -p 80:80 --name vmaig\
-e WEBSITE_TITLE='Vmaig'\
-e SECRET_KEY='django secret key'\
-e WEBSITE_WELCOME='欢迎来到vmaig'\
-e EMAIL_BACKEND='django.core.mail.backends.smtp.EmailBackend' \
-e EMAIL_HOST='smtp.163.com'\
-e EMAIL_PORT='25'\
-e EMAIL_HOST_USER='yourname@163.com'\
-e EMAIL_SUBJECT_PREFIX='vmaig'\
-e EMAIL_HOST_PASSWORD='yourpassword'\
-e QINIU_ACCESS_KEY='your_as_key'\
-e QINIU_SECRET_KEY='your_sr_key'\
-e QINIU_URL='your_url'\
-e QINIU_BUCKET_NAME='your_bucket_name'\
billvsme/vmaig_blog
环境变量:
其中:EMAIL_HOST,EMAIL_PORT,EMAIL_HOST_USER,EMAIL_HOST_PASSWORD是必须的,如果不指定,用户注册不了
WEBSITE_TITLE 网站的title
WEBSITE_WELCOME 首页显示的欢迎消息
EMAIL_BACKEND email的引擎,默认是django.core.mail.backends.smtp.EmailBackend,如果想支持qq邮箱请使用django_smtp_ssl.SSLEmailBackend
EMAIL_HOST SMTP地址
EMAIL_PORT SMTP端口
EMAIL_HOST_USER 邮箱名称
EMAIL_HOST_PASSWORD 邮箱密码
EMAIL_SUBJECT_PREFIX 邮件Subject-line前缀
# 默认头像保存在服务器,如果想保存在七牛中要定义下面这些环境变量
QINIU_ACCESS_KEY 七牛的access key
QINIU_SECRET_KEY 七牛的secret key
QINIU_BUCKET_NAME 七牛的bucket
QINIU_URL 七牛的url
运行后,默认管理员用户名为 admin,密码为 password , 请登录 http://your-domain/admin 更改密码。
#接下来该干什么?
在浏览器中输入 http://127.0.0.1:8000/admin
输入前面初始化数据库时的用户名密码。
后台中,可以
通过“轮播”添加首页的轮播
通过“导航条”添加首页nav中的项目
通过“专栏” 添加博客专栏(可以和导航条结合起来)
通过“资讯” 添加转载的新闻
通过“分类” “文章” 添加分类跟文章
通过“用户” 对用户进行操作
特别注意 首页的便签云中的内容,在后台不能修改。 请修改 blog/templates/blog/widgets/tags_cloud.html 中的 tags数组的内容。