「入行全栈 Django3.x 个人主页网站全记录」1.项目创建与环境配置

客官°小女子只卖身不卖艺 2022-09-09 15:59 119阅读 0赞

项目汇总：[「入行全栈 Django3.x 个人主页网站全记录」项目总览介绍][Django3.x]

### 文章目录 ###

*  内容介绍
 *  创建项目准备
 *  配置文件 setting.py
 *  路由文件 urls.py
 *  创建超级用户

# 内容介绍 #

基于 **Django3.x** 创建项目环境以及配置内容。

# 创建项目准备 #

**1.创建项目**

打开CMD使用命令行创建项目

django-admin.exe startproject MyHome

**2.添加Xadmin和DjangoUeditor**  
在项目目录下创建extra\_apps文件夹，将下载好的Xadmin和DjangoUeditor复制即可。最终配置好文件夹的目录应该是下图这样。  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATXLmlbDmja7mnag_size_17_color_FFFFFF_t_70_g_se_x_16]

**3.添加其他文件夹**

根据自己需要进行添加，可以先添加后面使用到了再做说明。

*  apps 网站应用使用
 *  media 配置多媒体文件使用
 *  static 配置静态文件使用
 *  templates 配置html模板使用

# 配置文件 setting.py #

**1.配置项目文件**  
在配置文件中声明自己为项目新增的文件目录。

import os
    import sys
    
    sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))
    sys.path.insert(0, os.path.join(BASE_DIR, 'extra_apps'))

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzIwMjg4MzI3_size_16_color_FFFFFF_t_70_pic_center]  
**2.配置调试参数**  
开启调试功能和网络访问限定功能。

DEBUG = True # 这里未来搭建好网站之后使用False关闭即可
    ALLOWED_HOSTS = ['*']  # 修改成任何域名都可以访问

**3.配置应用信息**

INSTALLED_APPS = [
    	...
        'xadmin',  # xadmin主体
        'crispy_forms',  # 渲染表格模块
        'reversion',  # 为模型通过版本设置提供数据回滚功能
        'captcha',  # 验证码
        'mdeditor',  # markdown 编辑器
    
        'apps.Configuration',  # 环境&数据配置
        'apps.MyHomePage',  # 我的个人主页
        'apps.User',  # 用户功能
        'apps.StatisticalData',  # 统计数据功能
        'apps.Blog',  # 博客应用
        'apps.Comment',  # 评论功能
        'mptt',
        'notifications',  # 消息通知
        'ckeditor',  # 富文本编辑器
    ]

**4.配置前端模板**  
为Django项目添加 **TEMPLATES** 模板设置，未来有时间开发自己的Admin后台，需要在这里配置，这里直接复制过来就行了，目的可以解决大部分前端无法展示的问题，保证Xadmin后台显示。

TEMPLATES = [
        { 
            'BACKEND': 'django.template.backends.django.DjangoTemplates',
            'DIRS': [os.path.join(BASE_DIR, 'templates')],
            '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',
                ],
                'libraries': {   # Adding this section should work around the issue.
                    'staticfiles': 'django.templatetags.static',
                }
            },
        },
    ]

**5.配置评论MPTT**

MPTT_COMMENTS_ALLOW_ANONYMOUS = True  # True 为允许匿名评论，否则不允许
    COMMENTS_APP = 'django_mptt_comments'
    SITE_ID = 1
    
    MIDDLEWARE = [
    	......
        'crequest.middleware.CrequestMiddleware',
    ]
    
    X_FRAME_OPTIONS = 'SAMEORIGIN'  # 设置弹窗显示

**6.配置验证码功能**

# 修改验证码功能
    CAPTCHA_OUTPUT_FORMAT = u'<div class="col-lg-8"><div class="login-input-area">%(text_field)s%(hidden_field)s %(image)s</div></div>'
    # 验证码噪点样式
    CAPTCHA_NOISE_FUNCTIONS = (
        'captcha.helpers.noise_null',  # 没有样式
        # 'captcha.helpers.noise_arcs', # 线
        # 'captcha.helpers.noise_dots', # 点
    )
    # 验证码图片大小
    CAPTCHA_IMAGE_SIZE = (120, 30)
    CAPTCHA_BACKGROUND_COLOR = '#ffffff'
    # CAPTCHA_CHALLENGE_FUNCT = 'captcha.helpers.random_char_challenge' # 随机英文字符
    CAPTCHA_CHALLENGE_FUNCT = 'captcha.helpers.math_challenge'  # 随机计算
    # 验证码输入框指定 TEMPLATE, 表单使用 CaptchaField 字段生效
    # CAPTCHA_TEXT_FIELD_TEMPLATE = BASE_DIR + "/templates/Captcha/captcha_text_field.html"
    CAPTCHA_LENGTH = 5  # 字符个数

**7.配置数据仓库**  
根据我的习惯使用的 **Mysql** 数据仓库。里面的参数信息填写你的参数信息即可。

DATABASES = { 
        'default': { 
            'ENGINE': 'django.db.backends.mysql',
            'NAME': 'tcm_manage',
            'USER': '你的用户名',
            'PASSWORD': '你的密码',
            'HOST': '你的IP地址',
            'PORT': '你的端口号',
        }
    }

**8.配置语言和时区**  
设置Django项目语言为汉语，时区为东八区上海时间。

# 设置语言、时区
    LANGUAGE_CODE = 'zh-hans'
    TIME_ZONE = 'Asia/Shanghai'
    USE_I18N = True
    USE_L10N = True
    USE_TZ = False  # 数据库存储使用时间，True时间会被存为UTC的时间

**9.配置文件目录**  
配置静态文件目录和媒体文件目录，用于API接口调用相应的资源数据信息，以及上传数据。

# 添加静态文件路径
    STATIC_URL = '/static/'
    STATICFILES_DIRS = [
        os.path.join(BASE_DIR, "static"),
    ]
    # 这个在配置nigix时候会使用，暂时不需要
    # STATIC_ROOT = os.path.join(BASE_DIR, "static")
    
    # 设置我们上传文件的路径
    MEDIA_URL = '/media/'
    MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

**10.配置缓存服务功能**

CACHES = { 
        'default': { 
            'BACKEND': 'django.core.cache.backends.filebased.FileBasedCache',  # 指定缓存使用的引擎
            'LOCATION': os.path.join(BASE_DIR, 'caches'),  # 指定缓存的路径
            'TIMEOUT': 300,  # 缓存超时时间(默认为300秒,None表示永不过期)
            'OPTIONS': { 
                'MAX_ENTRIES': 300,  # 最大缓存记录的数量（默认300）
                'CULL_FREQUENCY': 3,  # 缓存到达最大个数之后，剔除缓存个数的比例，即：1/CULL_FREQUENCY（默认3）
            }
        }
    }

**10.配置Mysql版本**  
修改以下目录的文件，否则mysql版本过高无法使用。  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATXLmlbDmja7mnag_size_20_color_FFFFFF_t_70_g_se_x_16]

直接添加下面内容即可

import pymysql
    pymysql.version_info = (1, 3, 13, "final", 0)
    pymysql.install_as_MySQLdb()

**11.配置邮箱功能**

# 发送邮件的setting设置
    EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
    EMAIL_HOST = "smtp.qq.com"
    EMAIL_PORT = 25
    EMAIL_HOST_USER = "你的邮箱"
    EMAIL_HOST_PASSWORD = "你的邮箱密码，不是密码"
    EMAIL_USE_TLS = True
    EMAIL_FROM = EMAIL_HOST_USER

**12.配置CKEDITOR**

# 配置富文本编辑器
    CKEDITOR_CONFIGS = { 
        # django-ckeditor默认使用default配置
        'default': { 
            # 编辑器宽度自适应
            'width': 'auto',
            'height': '250px',
            # tab键转换空格数
            'tabSpaces': 4,
            # 工具栏风格
            'toolbar': 'Custom',
            # 工具栏按钮
            'toolbar_Custom': [
                # 表情 代码块
                ['Smiley', 'CodeSnippet'],
                # 字体风格
                ['Bold', 'Italic', 'Underline', 'RemoveFormat', 'Blockquote'],
                # 字体颜色
                ['TextColor', 'BGColor'],
                # 链接
                ['Link', 'Unlink'],
                # 列表
                ['NumberedList', 'BulletedList'],
                # 最大化
                ['Maximize']
            ],
            # 插件
            'extraPlugins': ','.join(['codesnippet', 'prism', 'widget', 'lineutils']),
        }
    }
    
    CKEDITOR_JQUERY_URL ='https://apps.bdimg.com/libs/jquery/2.1.4/jquery.min.js'
    CKEDITOR_IMAGE_BACKEND = "pillow"
    CKEDITOR_UPLOAD_PATH = "uploads/"

# 路由文件 urls.py #

from django.urls import path, re_path, include
    import xadmin
    from xadmin.plugins import xversion
    
    xadmin.autodiscover()  # xversion模块自动注册需要版本控制的 Model
    xversion.register_models()
    from django.views.static import serve
    from MyHome.settings import MEDIA_ROOT  # 配置文件Media文件路径
    from apps.MyHomePage.views import *
    from apps.User.views import *
    from apps.Blog.views import *
    
    urlpatterns = [
        # 配置adminx后台路由
        path('xadmin/', xadmin.site.urls),
        # 主页的路由地址
        path('', include('MyHomePage.urls', namespace='MyHomePage')),
        path('', include('User.urls', namespace='User')),
        path('', include('Blog.urls', namespace='Blog')),
        path('', include('Comment.urls', namespace='comment')),
        # 配置media的url
        re_path('media/(?P<path>.*)', serve, { "document_root": MEDIA_ROOT}),
        # 配置验证码功能
        re_path(r'^captcha/', include('captcha.urls')),
        # 配置markdown编译器路由
        re_path(r'mdeditor/', include('mdeditor.urls')),
    ]

# 创建超级用户 #

要记得自己设置的用户名和密码

python manage.py createsuperuser # 创建超级用户， 根据提示输入用户名、邮箱、密码，用于django后台管理系统登陆

[Django3.x]: https://blog.csdn.net/qq_20288327/article/details/120060658
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATXLmlbDmja7mnag_size_17_color_FFFFFF_t_70_g_se_x_16]: /images/20220829/72e21d7d763d45d5a977bec020ed05a7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzIwMjg4MzI3_size_16_color_FFFFFF_t_70_pic_center]: /images/20220829/c63c3c50e07f48a5a6799a4bd515956b.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBATXLmlbDmja7mnag_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220829/6ca197449abe48db864a66ca3170d55f.png