Django个人博客系统(1-5)

1.创建项目与注册APP

本文采用的是最简单的创建Django项目的方法,即在Pycharm中创建项目时在左侧选择Django即可,我们只需修改项目的名称、确定是否采用虚拟环境(推荐使用虚拟环境),然后点击Create即可。项目创建成功后,Django默认的一些目录和配置文件就全部准备好了。

项目是由多个子模块组成的,每一个模块在Django中就是一个app,例如我们博客项目中注册一个article的app用来管理文章:

python manage.py startapp article

千万要注意的是,app创建成功之后一定要在settings.py中注册,即在INSTALLED_APPS中添加app的名称,通过注册的方式来告诉Django存在这么一个app。app创建的默认文件不含urls.py,我们需要手动创建。

Django的路由是多级映射的,项目目录下的urls.py主要负责将请求发送到具体的哪个app,而app目录下的urls.py则负责转发到哪个具体的页面。因此,app注册成功后,我们要将app的路由文件添加到项目目录下的urls.py中:

urlpatterns = [
    path('admin/', admin.site.urls),
    path('article/', include('article.urls', namespace='article')), # 新增代码,配置app的url
]

2.创建模型与数据迁移

Django框架采用MTV模式,即模型(Model)、模板(Template)和视图(Views)。Model负责存取数据,View负责决定需要调取哪些数据,而Template则负责将调取出的数据以合理的方式展现出来。

Django不需要直接定义数据库表,只需定义好模型就能自动从模型映射到数据库,处理与数据相关的事务。每个模型都都是django.db.models.Model类的子类,从它继承了操作数据库需要的所有方法。每个字段都是Field类的实例,如字符字段被表示为CharField,日期时间字段被表示为DateTimeField

我们为article创建一个ArticlePost模型,如下:

from django.contrib.auth.models import User
from django.db import models

from django.utils import timezone

# 博客文章


class ArticlePost(models.Model):
    author = models.ForeignKey(User, on_delete=models.CASCADE)  # 文章作者,on_delete用于指定数据删除的方式
    title = models.CharField(max_length=100)  # 文章标题,models.CharField为字符串字段,用于保存较短的字符串
    body = models.TextField()  # 文章正文,TextField用于保存大量文本
    created = models.DateTimeField(default=timezone.now)  # 文章创建时间,default=timezone.now指定在创建数据时默认写入当前的时间
    updated = models.DateTimeField(auto_now=True)  # 文章更新时间,auto_now=True指定每次数据更新时自动写入当前时间

    class Meta:  # 内部类,用于定义元数据
        ordering = ('-created',)  # ordering指定模型返回的数据的排列顺序,'-created' 表明数据应该以文章创建时间倒序排列,负号标识倒序

    def __str__(self):  # 定义当调用对象的 str() 方法时的返回值内容
        return self.title

注意,每当对数据库进行了更改(添加、修改、删除等)操作,都需要进行数据迁移。通过运行makemigrations命令,Django会检测你对模型文件的修改,并且把修改的部分储存为一次迁移。但是此时你做的修改并没有反映到数据库中,它本质上只是个历史记录。只有通过migrate命令才能将所有还没有执行过的迁移应用在数据库上,也就是将模型的更改同步到数据库中。

python manage.py makemigrations
python manage.py migrate

模型创建成功后,如需添加后台管理,以ArticlePost为例,需要在articleadmin.py中添加如下代码:

from django.contrib import admin
from .models import ArticlePost

admin.site.register(ArticlePost)

对于后台管理,我们使用Django自带的管理系统,使用之前需要注册一个超级用户,执行如下命令,然后输入用户名、邮箱、密码即可。

python manage.py createsuperuser

我们在浏览器中输入网址http://127.0.0.1:8000/admin/,使用刚注册的账号登录后台管理系统,为ArticlePost添加几条数据,以方便后续视图函数的调试。

3.创建视图与编写模板

Django中视图的概念是「一类具有相同功能和模板的网页的集合」,其作用是处理网页发来的请求(request)并返回响应(HttpResponse、Http404)。Django将会根据用户请求的URL来选择使用哪个视图并返回渲染后的对象。我们为文章列表创建一个视图:

from django.http import HttpResponse
from django.shortcuts import render
from .models import ArticlePost


def article_list(request):
    articles = ArticlePost.objects.all()  # 获取所有的数据对象
    context = {'articles': articles}  # 传递给模板的上下文
    return render(request, "article/list.html", context)  # render函数的作用是结合模板和上下文,并返回渲染后的HttpResponse对象

视图编写完成后,需要添加到urls.py文件中才能被调用。

from django.urls import path
from .views import article_list


app_name = 'article'

urlpatterns = [
    path('article-list', article_list, name='article-list'),
]

接下来在根目录的templates目录下创建文件夹来存放article的模板文件,templates是Django默认的模板文件存放目录,所谓模板就是用来展示数据的前端文件。
关于静态文件,我们首先需要注意的是它存放在根目录的static目录下(需要手动创建),另外需要在settings.py文件中加入以下几行代码:

STATIC_URL = '/static/'  # 通常是系统自动创建

STATICFILES_DIRS = (
    os.path.join(BASE_DIR, "static"),
)

模板中其实有很多部分是通用的,例如头部和脚注,对于这些我们可以将它们放到基类模板中,其他模板继承自基类模板。
base.html:我们在该文件中通过{% load static %}加载静态文件,并且通过block预留一些内容填充的位置,其他模板均继承自该文件。

<!-- 加载静态文件 -->
{% load static %}
<!DOCTYPE html>
<html lang="zh-cn">
<head>
    <meta charset="UTF-8">
    <!-- 预留网页标题的位置 -->
    <title>{% block title %}{% endblock %}</title>
    <!-- 加载bootstrap的css文件和图标库 -->
    <link rel="stylesheet" href="{% static 'bootstrap/css/bootstrap.min.css' %}">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.5.0/font/bootstrap-icons.css">
</head>
<body>
    <!-- 引入导航栏 -->
    {% include 'header.html' %}
    <!-- 预留具体内容页面的位置 -->
    {% block content %}{% endblock content %}
    <!-- 引入注脚 -->
    {% include 'footer.html' %}
    <!-- 加载bootstrap的js文件 -->
    <script src="{% static 'bootstrap/js/bootstrap.min.js' %}"></script>
</body>
</html>

header.html

<nav class="navbar navbar-expand-lg navbar-dark bg-dark">
  <div class="container">
    <a class="navbar-brand" href="#">
      Marvin's blog
    </a>
  </div>
</nav>

footer.html

<footer class="py-3 bg-dark fixed-bottom">
    <div class="container">
        <p class="m-0 text-center text-white">Copyright &copy; www.marvin.com 2021</p>
    </div>
</footer>

list.html用于展示文章列表,articles是通过视图函数传递过来的所有文章对象,我们通过for循环依次展示它们。

{% extends "base.html" %}
{% block title %}首页{% endblock %}
{% block content %}
    <div class="container">
        <div class="row mt-4">
            {% for article in articles %}
                <div class="col-4">
                    <div class="card">
                        <div class="card-header">
                            <h5>{{ article.title }}</h5>
                            <small class="text-secondary"><i class="bi bi-calendar-check"></i> 发表于 {{ article.created }}</small>
                        </div>
                        <div class="card-body">
                            <p class="card-text">{{ article.body|slice:'100' }}</p>
                            <!-- slice:'100'是Django的过滤器语法,表示取出正文的前100个字符,避免摘要太长 -->
                            <a href="#" class="btn btn-primary">阅读本文</a>
                        </div>
                    </div>
                </div>
            {% endfor %}
        </div>
    </div>
{% endblock %}

效果如下图所示:

4.页面跳转与参数传递

到目前为止,我们已经知道了如何创建视图以及模板,我们按照上述方法再添加一个文章详情的功能页面。视图函数如下:

def article_detail(request, id):
    article = ArticlePost.objects.get(id=id)
    context = {'article': article}
    return render(request, "article/detail.html", context)

视图函数中的id参数是Django自动生成的用于索引数据表的主键(Primary Key),我们在写model的时候并没有写叫做id的字段。接下来我们需要将其添加到路由中:

path('article-detail/<int:id>/', article_detail, name='article-detail')

<int:id>:Django用尖括号<>定义需要传递的参数。最后是模板文件:

{% extends "base.html" %}
{% block title %}文章详情{% endblock %}
{% block content %}
    <div class="container shadow">
        <div class="pt-4">
            <h1>{{ article.title }}</h1>
            <small class="text-secondary"><i class="bi bi-calendar-check"></i> 发表于 {{ article.created }}</small>
        </div>
        <div class="mt-2 border-top pt-2">
            {{ article.body }}
        </div>
    </div>
{% endblock %}

详情页面完成后,我们在导航中添加首页的跳转链接,方便从详情页回到文章列表。添加内容如下:

<div class="collapse navbar-collapse">
    <ul class="navbar-nav">
        <li class="nav-item">
            <a class="nav-link active" aria-current="page" href="{% url 'article:article-list' %}">首页</a>
        </li>
    </ul>
</div>

5.Markdown代码高亮

Markdown是博客中使用体验非常好的语法,添加Mardown支持的方法也很简单,只需安装markdown库即可(pip install markdown)。为了将Markdown语法书写的文章渲染为HTML文本,我们需要修改article_detail()视图函数:

def article_detail(request, id):
    article = ArticlePost.objects.get(id=id)
    # 将markdown语法渲染成html样式
    article.body = markdown.markdown(article.body,
                                     extensions=[
                                         'markdown.extensions.extra',   # 包含 缩写、表格等常用扩展
                                         'markdown.extensions.codehilite',  # 语法高亮扩展
                                     ])
    context = {'article': article}
    return render(request, "article/detail.html", context)

然后,需要修改detail.html中有关文章正文的部分:

<div class="mt-2 border-top py-2">
     {{ article.body|safe }}
</div>

Django出于安全考虑,会对输出的HTML代码进行转义,这使得article.body中渲染的HTML文本无法正常显示。|safe的作用是表示这一段字符不需要进行转义了。
代码高亮是技术文章必不可少的部分,为此我们需要安装Pygments库(pip install Pygments),然后在static目录中新建一个md_css目录,接着执行如下命令:

pygmentize -S monokai -f html -a .codehilite > ./static/md_css/monokai.css

执行成功后就会在md_css目录中生成了一个monokai.css文件,然后在base.html中引用这个文件就大功告成了。

<link rel="stylesheet" href="{% static 'md_css/monokai.css' %}">

由于Pygments的表格样式比较难看,因此我们在detail.html中添加如下代码进行美化:

<script src="https://cdn.bootcss.com/jquery/3.3.1/jquery.min.js"></script>
<script>
    // 将表格样式替换为bootstrap表格
    $('.container table').addClass('table table-bordered');
    $('.container thead').addClass('thead-light');
    // 为代码块添加圆角和内外边距
    $('.codehilite').addClass('rounded-3 p-3 my-3');
</script>

最终效果如下图所示:

文章参考博文:杜塞的博客

posted @ 2021-07-04 12:38  Marvin-wen  阅读(870)  评论(0编辑  收藏  举报