Django 搭建完整的网站

将要实现的功能

• 首页能够实现动态轮播图
• 多级评论
• 能够插入图片、视频、音乐
• 动态背景
• 用户注册、登录、退出、点赞
• 二级菜单，鼠标移入时弹出菜单
• 能够有小游戏窗口
• 重写后台管理界面
• 支持Markdown语法
• 可以选择富文本或者是Markdown语法
• 左侧菜单隐藏，移入时弹出
• 回到顶部区域
• 最后能够实现前后端分离
• 数据库使用MySQL

博客系统的安装配置

一、配置Python环境

• virtualenv 虚拟环境配置 Python安装virtualenv，并生成虚拟环境

pip install virtualenv
python -m venv env

启动虚拟环境

.\env\Scripts\activate

二、恢复pip安装过的库

在该项目中使用过的库的文件放在Other/requirement.txt

备份命令

pip freeze > requirement.txt

安装使用的库

pip install -r requirement.txt

三、环境中更改过的地方

在使用mysql数据库的过程中，因为数据库版本的问题，mysql的一些代码需要修改：

1. 在lib\site-packages\django\db\backends\mysql\base.py中，将以下代码注释

   if version < (1, 3, 3):
     raise ImproperlyConfigured("mysqlclient 1.3.3 or newer is required; you have %s" % Database.__version__) 

2. 在env\lib\site-packages\django\db\backends\mysql\operations.py中将146行中

   query = query.decode(errors='replace')

   改为

   query = query.encode(errors='replace')

四、数据库配置

在根目录中存在一个config-template.json文件，这是一个配置数据库的模板，你需要复制一份命名为config.json

cp config-template.json config.json

并且修改config.json中的内容，将其设置为你的数据库的选项

{
    "dbconfig":{
        "default": {
            "ENGINE": "django.db.backends.mysql",
            "NAME": "databsse name",
            "HOST": "ip addr",
            "USER": "usrname",
            "PASSWORD": "password",
            "PORT": "3306"
        }
    }
}

其中各个选项的含义为：

• "ENGINE": 数据库引擎，具体的内容请参考Django官方数据库说明
• "NAME": "数据库名称
• "HOST": 数据库ip地址，一般为'localhost'
• "USER": 数据库的用户名
• "PASSWORD": 数据库的密码
• "PORT": 数据库的端口

将数据库换成sqlite以外的数据库需要手动创建数据库CREATE DATABASE database_name,

CREATE DATABASE mysite CHARACTER SET utf8;

需要通过模型生成数据表

python manage.py makemigrations
python manage.py migrate

五、运行工程

1. 本地环境

   如果是在本地环境下运行该服务。在根目录下，运行该工程的命令为：

python manage.py runserver

2. 在服务器上运行

   如果想要在服务器上运行，需要使用uwsgi，具体的部署过程请参考这篇文章：

   Django线上部署教程：腾讯云+Ubuntu+Django+Uwsgi

六、记录我在使用Django时候遇到的坑（遇到的问题，为什么会出现这些问题， 如何解决）

1. 问题：在使用nginx时，已经申请了https链接，结果使用的时候依旧显示nginx的欢迎界面 解决办法：

   将server 80的下的内容复制一份到server 443中即可。
   已经将成功的配置和方法复制到了nginx.conf 和 uwsgi/myblog.ini中

2. 出现错误

   RuntimeError: cryptography is required for sha256_password or caching_sha2_password
   

   解决方法：

   pip install cryptography
   

3. 在网页中的Markdown的列表无法正常显示，不能正常的缩进，在显示css文件中的div ul下加入

   padding-inline-start: 1em;

   出现这个问题的原因是因为使用Bootstrap样式库中，该库中ul的默认样式被更改，所以一些样式无法正常的显示。

4. Django的后台管理样式出现无法加载css样式的问题， 解决方法：
   首先在seetings.py中添加STATIC_ROOT选项

   STATIC_ROOT = os.path.join(BASE_DIR, 'static_new')

   然后再将nginx服务器的配置更改vi /etc/nginx/sites-available/mysite.conf 将下面的内容

   location /static {
        alias /home/www/seco/static; # your Django project's static files - amend as required
    	index index.html index.htm;
    }
   

   更改为

   location /static {
        alias /home/www/seco/static_new; # your Django project's static files - amend as required
    	index index.html index.htm;
    }
   

   在服务器上安装完Django后，需要将静态文件进行收集到static_new文件夹中

    python manage.py collectstatic

解决跨域问题

首先安装插件

pip install django-cors-headers

在settings.py中配置选项：

INSTALLED_APPS = [
    ...
    'corsheaders'，
    ...
 ] 

MIDDLEWARE_CLASSES = (
    ...
    'corsheaders.middleware.CorsMiddleware',
    'django.middleware.common.CommonMiddleware', # 注意顺序
    ...
)
#跨域增加忽略
CORS_ALLOW_CREDENTIALS = True
CORS_ORIGIN_ALLOW_ALL = True
CORS_ORIGIN_WHITELIST = ()

CORS_ALLOW_METHODS = (
    'DELETE',
    'GET',
    'OPTIONS',
    'PATCH',
    'POST',
    'PUT',
    'VIEW',
)

CORS_ALLOW_HEADERS = (
    'XMLHttpRequest',
    'X_FILENAME',
    'accept-encoding',
    'authorization',
    'content-type',
    'dnt',
    'origin',
    'user-agent',
    'x-csrftoken',
    'x-requested-with',
    'Pragma',
)

新建Django一个项目

安装完成后，使用django进行生成项目, seco为将要生成的项目名称

django-admin startproject seco

运行django，并且在127.0.0.1:8000中可以看到启动成功的界面

python manage.py runserver 

新建项目APParticle

python manage.py startapp article

将App在seco/setting.py中INSTALLED_APPS中加入

INSTALLED_APPS =[
    ....
    'article',
]

将seetings.py中的语言和时区改为中文和shanghai

LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/shanghai'

将templates加入到TEMPLATES中

'DIRS': [os.path.join(BASE_DIR, 'templates'),],

设置静态文件和媒体文件的目录

# 设置静态文件的根目录
    STATIC_ROOT = [
        os.path.join(BASE_DIR, 'static'),
    ]

    # 设置媒体文件的位置
    MEDIA_URL = '/media/',
    MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

将更改数据库，将Django自带的sqlite数据库换成MySQL数据库

    import pymysql         # 一定要添加这两行！通过pip install pymysql！
    pymysql.install_as_MySQLdb()

    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.mysql',
            'NAME': 'mysite',
            'HOST': '192.168.1.1',
            'USER': 'root',
            'PASSWORD': 'pwd',
            'PORT': '3306',
        }
    }

将数据库换成sqlite以外的数据库需要手动创建数据库CREATE DATABASE database_name,

CREATE DATABASE mysite CHARACTER SET utf8;

使用Markdown编辑器

安装Markdown插件

首先需要安装Markdown

pip install markdown 

将Markdown显示，可以使用

import markdown

eassy.body = markdown.markdown(article.body, extensions=[
                                    'markdown.extensions.extra',
                                # 语法高亮扩展
                                    'markdown.extensions.codehilite',
                                    'markdown.extensions.toc',])

实现代码高亮

pip install Pygments

进入到static/css/然后运行

pygmentize -S monokai -f html -a .codehilite > monokai.css

然后在网页中引入生成的css文件

安装富文本编辑器

pip install django-mdeditor

然后在settings.py中进行注册

'mdeditor',

将下面代码放入到urls.py的底部，用于指定图片传送的地方

from django.conf.urls.static import static
from django.conf import settings

if settings.DEBUG:
    # static files (images, css, javascript, etc.)
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

在Model中使用mdeditor

from mdeditor.fields import MDTextField

context = MDTextField("文章内容")

在Markdown中提取目录

首先现将之前的eassy.body改为：

md = markdown.Markdown( extensions=[
                                    'markdown.extensions.extra',
                                # 语法高亮扩展
                                    'markdown.extensions.codehilite',
                                    'markdown.extensions.toc',])
eassy.context = md.convert(eassy.context)
eassy.toc = md.toc

注意markdown.markdown 和 markdown.Markdown的区别