建立项目结构
项目地址:https://github.com/ylpxzx/lifeblog
建立Django项目
虚拟环境创建(终端环境cmd下)
- 自行找个合适的位置建立python虚拟环境,避免与其他项目环境产生冲突(前提是已安装了虚拟环境库)
# life_blog_venv为虚拟环境名 python -m venv life_blog_venv
- 进入虚拟环境
- 进入Scripts目录
- 输入activate.bat,回车
Django项目创建
- 进入虚拟环境后,回到life_blog_venv项目目录里,安装Django
pip install Django
- 创建Django项目,项目名为lifeblog
django-admin startproject lifeblog
- 进入lifeblog文件夹,创建app应用
python manage.py startapp post python manage.py startapp blogger
- 将app名添加到settings.py中的INSTALLED_APPS列表(settings.py位于与项目同名的内部文件夹中)
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'blogger', # 添加该行 'post', # 添加该行 ]
- 创建配置文件夹conf(用于存放配置文件):该文件夹与manage.py同级
- 创建static文件夹(用于存放静态文件和静态模板):该文件夹与manage.py同级
- 在static文件夹中分别创建以下三个文件夹
- media:用于存放图片
- static:用于存放静态文件(css、js文件等)
- template:用于存放静态模板(html文件)
Django项目整体结构图
图中的whoosh_index文件夹将在后续步骤中建立。而comment不需要建立。.idea文件夹为开发工具生产的文件夹,无需自行建立。
项目汉化
修改settings.py文件中的相关配置
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'
配置静态文件路径
在settings.py文件中添加相关配置
STATIC_URL = '/static/'
# 配置ImageFile字段图片上传路径
MEDIA_URL = '/media/' # # 用于指定url路径
MEDIA_ROOT = os.path.join(BASE_DIR, 'static', 'media') # 用于指定上传文件的存储路径
if DEBUG == False:
STATIC_ROOT = os.path.join(BASE_DIR,'collected_static') # 用于在(debug=False)生产环境下加载静态文件。
# 参数:自动在项目根目录创建collected_static目录用于存放移过来静态文件(在生产环境下执行python manage.py collectstatic时,会自动创建collected_static目录)
# 配置静态文件路径
STATICFILES_DIRS=(
os.path.join(BASE_DIR,'static','static'),
)
在(内部lifeblog文件下)根urls.py文件添加如下代码
from django.contrib import admin
from django.urls import path
from django.conf.urls import include,url
from django.conf import settings
from django.conf.urls.static import static
from django.contrib.staticfiles.urls import staticfiles_urlpatterns # 加入该行,如若不加,在生产环境下无法加载样式
from django.views.static import serve # 加入该行,如若不加,在生产环境下无法加载样式
urlpatterns = [
path('admin/', admin.site.urls),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) # 用于上传和显示图片
urlpatterns += staticfiles_urlpatterns() # # 加入该行,如若不加,在生产环境下可能无法加载样式
if settings.DEBUG == False:
print('当前处于生产环境下')
urlpatterns += [
url(r'^static/(?P<path>.*)$',serve,{'document_root':settings.STATIC_ROOT}), # 加入该行,如若不加,在生产环境下无法加载样式
url(r'^media/(?P<path>.*)$',serve,{'document_root':settings.MEDIA_ROOT}), # 加入该行,如若不加,在生产环境下无法显示图片
]
else:
print('当前处于开发环境下')
配置模板文件路径
修改settings.py文件中的相关配置
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [os.path.join(BASE_DIR,'static','template')], # 添加该行
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
'builtins':['django.templatetags.static'], # 添加该行,设置该行后,不需要在静态模板文件中显示使用{% load static %}
},
},
]
配置MySQL数据库
记得先在MySQL中创建用到的数据库,这里我们使用的数据库名为lifeblog_database。
这里我们采用读取配置文件的方式来设置MySQL数据库信息,比较安全。
- 在conf文件夹下建立以下两个文件
- config.ini
- config_read.py
config.ini文件内容
[MySQL]
host=localhost
user=root
password=数据库密码
db=lifeblog_database
charset=utf8
port=3306
config_read.py 文件内容
注意:需先在虚拟环境下安装第三方库configparser
pip install configparser
import configparser
import os
project_dir = os.path.dirname(os.path.abspath('conf')) # 获取当前文件的目录
config_path = os.path.join(project_dir, "conf", "config.ini")
cf = configparser.ConfigParser()
cf.read(config_path) # 读取配置文件
# secs = cf.sections() # 获取ini文件中的所有section,并以列表形式返回
# mysql_options = cf.options("MySQL") #获取某个section名所对应的键
# mysql_items = cf.items("MySQL") # 获取section对应的全部键值对
host = cf.get("MySQL", "host")
user = cf.get("MySQL", "user")
password = cf.get("MySQL", "password")
db = cf.get("MySQL", "db")
charset = cf.get("MySQL", "charset")
port = cf.get("MySQL", "port")
sql = {
'HOST' : host,
'USER' : user,
'PASSWORD' : password,
'DB' : db,
'CHARSET' : charset,
'PORT' : port
}
修改settings.py文件下的DATABASES。
# MySQL数据库配置
from conf.config_read import sql # 读取配置文件
DATABASES = {
'default':{
'ENGINE': 'django.db.backends.mysql',
'NAME': sql['DB'], # 数据库名称
'USER': sql['USER'], # 数据库用户
'PASSWORD': sql['PASSWORD'], # 数据库密码
'HOST': sql['HOST'], # 数据库ip
'PORT': sql['PORT'], # 数据库端口
}
}
app模型字段创建
在前面,我们建立了blogger和post两个应用,在应用文件夹下会生成多个py文件,模型字段的定义在models.py文件中创建,用于映射(ORM)到数据库中,创建相应的数据表。
定义数据字段
blogger和post文件夹下的models.py中写入如下代码
- blogger/models.py
from django.db import models
from ckeditor.fields import RichTextField
# Create your models here.
class Blogger(models.Model):
'''博主信息模型'''
name = models.CharField('博主名',default='狼性书生',max_length=20)
head_photo = models.ImageField('头像', upload_to='blog_img',null=True,blank=True,default='/cover_img/default.jpg')
blog_major = models.CharField('职业',default='程序猿',max_length=20)
autograph = RichTextField('个性签名',default='个性签名')
blog_email = models.EmailField('博主邮箱',default='794859685@qq.com')
def __str__(self):
return self.name
class Link(models.Model):
'''博主链接模型'''
icon_name = models.CharField("链接图标",max_length=50,default='fa fa-dribbble')
link_name = models.CharField("链接",max_length=50)
blogger = models.ForeignKey('Blogger',on_delete=models.CASCADE,related_name='blogger_link')
def __str__(self):
return self.link_name
class Layout(models.Model):
'''网站配置模型'''
# main_image = models.ImageField("首页图",upload_to='layout_img',default='/layout_img/home-banner.jpg')
logo_image = models.ImageField("Logo",upload_to='layout_img',default='/layout_img/favicon.ico')
website_name = models.CharField("网站标题名",max_length=20,default='Mr Wolf Blog')
def __str__(self):
return self.website_name
- post/models.py
在static/media文件下创建cover_img文件夹,用于存放文章封面
import os
import time
import datetime
from django.db import models
# Create your models here.
def modify_path(instance, filename):
'''
重定义封面保存路径
:param instance: self
:param filename: 文件名
:return: 新路径
'''
ext = filename.split('.').pop()
now_date = datetime.datetime.now().strftime('%Y%m%d')
now_time = int(time.time())
filename = '{0}{1}.{2}'.format(now_date, now_time, ext)
return os.path.join('cover_img', now_date, filename) # 系统路径分隔符差异,增强代码重用性
class Post(models.Model):
'''
文章模型
'''
title = models.CharField('标题',max_length=100,default='无标题名',null=True,blank=True)
cover = models.ImageField('封面', upload_to=modify_path,null=True,blank=True,default='/cover_img/default.jpg')
create_time = models.DateTimeField('创建时间',auto_now=True)
content = models.TextField('文章内容',default='文章内容')
is_publish = models.BooleanField(default=False)
is_comment = models.BooleanField(default=False)
total_views = models.PositiveIntegerField('文章浏览量',default=0)
# 文章与分类:多对一关系。在多的一方定义ForeignKey字
category = models.ForeignKey('Category',on_delete=models.CASCADE,related_name='post')
def __str__(self):
return self.title
# 完善后台数据显示过长情况
def short_detail(self):
if len(str(self.content)) > 30:
return '{}...'.format(str(self.content)[0:29])
else:
return str(self.content)
short_detail.allow_tags = True
short_detail.short_description = u'文章内容'
class Category(models.Model):
post_category = models.CharField('文章类别',max_length=20,default='杂记')
def __str__(self):
return self.post_category
将模型字段注册到admin后台
创建超级用户
虚拟环境、manage.py所在目录下执行如下指令
python manage.py createsuperuser
# 输入用户名、密码,邮箱可不填
注册字段到Admin后台
- post/admin.py
from django.contrib import admin
from .models import Post,Category
from django.utils.safestring import mark_safe
# Register your models here.
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
list_display = ['title','image_data','create_time','short_detail','is_publish','is_comment','category','id']
list_editable = ['is_publish','is_comment','category']
list_filter = ['title','create_time','is_publish','is_comment','category']
# readonly_fields = ('image_data',)
# 缩略图显示
def image_data(self,obj):
return mark_safe(u'<img src="%s" width="100px" />' % obj.cover.url)
image_data.short_description = u'封面'
@admin.register(Category)
class CategoryAdmin(admin.ModelAdmin):
list_display = ['id','post_category']
list_editable = ['post_category']
- blogger/admin.py
from django.contrib import admin
from .models import Blogger,Link,Layout
from django.utils.safestring import mark_safe
admin.site.site_title="Mr Wolf Blog"
admin.site.site_header="Mr Wolf博客管理系统"
@admin.register(Blogger)
class BloggerAdmin(admin.ModelAdmin):
list_display = ['id','name','image_data','blog_major','autograph','blog_email']
list_editable = ['name','blog_major','blog_email']
# 缩略图,后台展示页显示缩略图
def image_data(self,obj):
return mark_safe(u'<img src="%s" width="100px" />' % obj.head_photo.url)
image_data.short_description = u'头像'
@admin.register(Link)
class LinkAdmin(admin.ModelAdmin):
list_display = ['id','link_name','icon_name']
# list_editable = ['link_name']
@admin.register(Layout)
class LayoutAdmin(admin.ModelAdmin):
list_display = ['id', 'logo_img', 'website_name']
list_editable = ['website_name']
def logo_img(self,obj):
return mark_safe(u'<img src="%s" width="100px" />' % obj.logo_image.url)
logo_img.short_description = u'logo'
数据库迁移
虚拟环境、manage.py所在目录下执行如下指令
python manage.py makemigrations # 记录App下models的变更记录,生成migrations文件,可查看文件内的py文件的内容
python manage.py migrate # 同步迁移的记录
迁移过程中可能会报错,比如pillow库未找到等,这是未导入第三方库的原因,可根据报错信息,缺什么就"pip install 什么库"。
或者pip install -r requirements.txt,前提是拉取github上本项目的requirements.txt文件。
其他异常解决方法
-
ImportError: cannot import name ‘six’ from 'django.utils’异常
- 安装six
pip install six
- 将Lib/site-packages/six.py复制到Lib/site-packages/django/utils
-
ImportError: cannot import name python_2_unicode_compatible异常
- 报错地方导入的包替代为以下导入语句
from django.utils.six import python_2_unicode_compatible
启动Django
虚拟环境、manage.py所在目录下执行如下指令
python manage.py runserver
浏览器进入http://127.0.0.1:8000/admin
登录进去后,是比较简陋的界面,后续将对其进行美化。