Django简单博客实战（一）--- 项目创建

建立项目结构

项目地址：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
登录进去后，是比较简陋的界面，后续将对其进行美化。

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 216,001评论 6赞 498
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 92,210评论 3赞 392
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 161,874评论 0赞 351
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 58,001评论 1赞 291
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 67,022评论 6赞 388
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 51,005评论 1赞 295
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,929评论 3赞 416
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,742评论 0赞 271
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 45,193评论 1赞 309
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,427评论 2赞 331
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,583评论 1赞 346
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,305评论 5赞 342
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,911评论 3赞 325
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,564评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,731评论 1赞 268
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,581评论 2赞 368
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,478评论 2赞 352