博客首页
博客首页除了显示数据之外，还有登陆跳转、分页显示、搜索等
登陆
django 内置的后台管理应用就是处理注册登陆、管理文章等的应用。在fbckf/urls.py 中规定了匹配后台应用的 url规则 ，在浏览器中输入127.0.0.1：8000/admin可进入登陆界面。
点击首页中的 Sign in 按钮将跳转到登陆界面
模板
<!-- templates/blog/index.html -->
...
<!-- nav -->
<div class="container">
<nav class="navbar navbar-light border-bottom" style="background-color: white">
<span class="navbar-brand font-italic">
Fbckf
</span>
<div class="my-2 my-lg-0">
<!-- 将 button 标签修改为以下内容 -->
{% if username %}
<a href="/admin" class="btn btn-light text-dark" role="button">{{ username }}</a>
{% else %}
<a href="/admin" class="btn btn-light" role="button">Sign in</a>
{% endif %}
</div>
</nav>
</div>
...
url 规则
# fbckf/urls.py
...
urlpatterns = [
path('admin/', admin.site.urls),
# 修改首页 url 规则
path('', include('blog.urls')),
]
...
修改完成之后刷新页面，点击 Sign in 按钮时成功跳转到登陆页面，在后台点击查看站点返回首页。成功登陆之，如果没有注销登陆，浏览器会有缓存，之后访问后台都不用再次输入账户密码。
视图函数
# blog/views.py
...
def index(request):
...
# 判断用户是否登陆，若用户已登陆在线则将用户名存放到字典 context 中传递到模板
if request.user.is_authenticated:
context['username']= request.user.username
return render(request, 'blog/index.html', context=context)
...
刷新博客首页，Sign in 按钮已经改为 fbckf，在将用户注销登陆，刷新博客首页，按钮有恢复为 Sign in
文章排序
首页的文章是按照发布时间来排序的，从最新到最旧的顺序。而之前文章从数据库中取出的顺序是相反的，文章排序需要修改有一下视图函数
# blog/views.py
...
def index(request):
# 通过 order_by() 方法来给文章排序
# order_by() 的参数是 指定排序的字段，字段前的'-'好表示逆序
article_list = Article.objects.all().order_by('-create_time')
...
刷新是首页，文章已正确排序。
分页
当文章增加到一定数量的时候，就必须要用到分页功能，将文章按一定数量分页显示。
测试数据
现在的数据库中，仅有两篇文章，这是远远不够的。分页功能需较多的测试数据，而一个一个的手动输入文章及其麻烦，所以只能通过脚本来输入，而且使用脚本的话，也可以保证在团队中
测试数据的一致性
# populate.py
"""
数据脚本
"""
import os
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'fbckf.settings')
import django
django.setup()
from blog.models import Category, Article
from django.contrib.auth.models import User
from django.utils import timezone
def run_script():
author = User.objects.get(username='fbckf')
category = Category.objects.get(name='古诗')
article = add_article(
title="望江南 超然台作",
author=author,
category=category,
body="春未老，风细柳斜斜。试上超然台上看，半壕春水一城花。烟雨暗千家。寒食后，酒醒却咨嗟。休对故人思故国，且将新火试新茶。诗酒趁年华。",
)
article = add_article(
title="寄黄几复",
author=author,
category=category,
body="我居北海君南海，寄雁传书谢不能。桃李春风一杯酒，江湖夜雨十年灯。持家但有四立壁，治病不蕲三折肱。想见读书头已白，隔溪猿哭瘴溪藤。",
)
article = add_article(
title="侠客行",
author=author,
category=category,
body="赵客缦胡缨，吴钩霜雪明。银鞍照白马，飒沓如流星。十步杀一人，千里不留行。事了拂衣去，深藏身与名。闲过信陵饮，脱剑膝前横。将炙啖朱亥，持觞劝侯嬴。三杯吐然诺，五岳倒为轻。眼花耳热后，意气素霓生。救赵挥金槌，邯郸先震惊。千秋二壮士，烜赫大梁城。纵死侠骨香，不惭世上英。谁能书阁下，白首太玄经。",
)
article = add_article(
title="画堂春 一生一代一双人",
author=author,
category=category,
body="一生一代一双人，争教两处销魂。相思相望不相亲，天为谁春。浆向蓝桥易乞，药成碧海难奔。若容相访饮牛津，相对忘贫。",
)
article = add_article(
title="丑奴儿 书博山道中壁",
author=author,
category=category,
body="少年不识愁滋味，爱上层楼。爱上层楼。为赋新词强说愁。 而今识尽愁滋味，欲说还休。欲说还休。却道天凉好个秋。",
)
article = add_article(
title="折桂令 春情",
author=author,
category=category,
body="平生不会相思，才会相思，便害相思。身似浮云，心如飞絮，气若游丝。空一缕余香在此，盼千金游子何之。证候来时，正是何时？灯半昏时，月半明时。",
)
article = add_article(
title="凤求凰",
author=author,
category=category,
body="其一：【琴曲出自王实甫《西厢记》】有美一人兮，见之不忘。（有美人兮，见之不忘。）一日不见兮，思之如狂。凤飞翱翔兮，四海求凰。无奈佳人兮，不在东墙。将琴代语兮，聊写衷肠。何时见许兮，慰我彷徨。愿言配德兮，携手相将。不得於飞兮，使我沦亡。",
)
article = add_article(
title="子衿",
author=author,
category=category,
body="青青子衿，悠悠我心。纵我不往，子宁不嗣音？青青子佩，悠悠我思。纵我不往，子宁不来？挑兮达兮，在城阙兮。一日不见，如三月兮。",
)
article = add_article(
title="贺新郎 甚矣吾衰矣",
author=author,
category=category,
body="邑中园亭，仆皆为赋此词。一日，独坐停云，水声山色，竞来相娱。意溪山欲援例者，遂作数语，庶几仿佛渊明思亲友之意云。甚矣吾衰矣。怅平生、交游零落，只今馀几！白发空垂三千丈，一笑人间万事。问何物、能令公喜？我见青山多妩媚，料青山见我应如是。情与貌，略相似。一尊搔首东窗里。想渊明《停云》诗就，此时风味。江左沉酣求名者，岂识浊醪妙理。回首叫、云飞风起。不恨古人吾不见，恨古人不见吾狂耳。知我者，二三子。",
)
def add_category(name, instructions):
"""
get_or_create() 获取或创建一个对象 并返回一个元组
"""
c = Category.objects.get_or_create(name=name)[0]
c.instructions = instructions
c.save()
return c
def add_article(title, author, category, body):
a = Article.objects.get_or_create(title=title)[0]
a.author = author
a.category = category
a.body = body
a.abstract = body[:17]
a.create_time = timezone.now()
a.likes = 0
a.save()
return a
if __name__ == "__main__":
print("Blog populate script running ...")
run_script()
# 运行脚本插入数据
$ python populate.py
查看后台文章列表
image
视图函数
django 提供了管理分页的类 Paginator，可以快速的完成分页功能呢改，在官方文档中也有简单的例子,在视图函数中导入Paginator
# blog/views.py
from django.shortcuts import render
# 导入 Paginator 类
from django.core.paginator import Paginator
from django.contrib.auth.models import User
from .models import Category, Article
# 修改 index 函数
def index(request):
# 创建字典 context
context = {}
article_list = Article.objects.all().order_by('-create_time')
# 判断文章数量是否需要分页
if article_list.count > 10:
# 实例化一个 Paginator 类
# 第一个参数是要进行分页的文章列表，第二个参数表示每页文章数量
paginator = Paginator(article_list, 3)
# 从 request 中获取目标页面数
page = request.GET.get('page')
# 首次访问页面 page 为 None
if page == None:
page=1
# 调用 page 方法获取目标页面的文章列表
page_list = paginator.page(page)
context['article_list'] = page_list
# 通过该变量判断是否分页
context['is_page'] = True
else:
context['article_list'] = article_list
category_list = Category.objects.all()
context['category_list'] = category_list
for category in category_list:
count = Article.objects.all().filter(category=category).count()
category.article_count = count
category.save()
if request.user.is_authenticated:
context['username']= request.user.username
return render(request, 'blog/index.html', context=context)
每次用户点击页面导航栏中的页码后，通过 request.GET.get() 获取页码 page，再获取页码对应的文章列表并传递给模板。
模板文件
<!-- templates/blog/index.html -->
...
{% if is_page %}
<!-- Pagination -->
<div class="justify-content-center">
<nav aria-label="Page navigation">
<ul class="pagination justify-content-center">
<!-- 跳转到第一页 -->
<li class="page-item">
<a href="?page=1" class="page-link bg-light text-dark" aria-label="Previous">
<span aria-hidden="true">«</span>
<span class="sr-only">Previous</span>
</a>
</li>
{% ifequal article_list.number article_list.paginator.num_pages %}
<li class="page-item"><a href="?page={{ article_list.number|add:-2 }}" class="page-link bg-light text-dark">{{ article_list.number|add:-2 }}</a></li>
{% endifequal %}
{% ifnotequal article_list.number|add:-1 0 %}
<li class="page-item"><a href="?page={{ article_list.number|add:-1 }}" class="page-link bg-light text-dark">{{ article_list.number|add:-1 }}</a></li>
{% endifnotequal %}
<!-- 当前页 -->
<li class="page-item disabled"><a href="?page={{ article_list.number }}" class="page-link bg-dark text-light">{{ article_list.number}}</a></li>
{% ifnotequal article_list.number article_list.paginator.num_pages %}
<li class="page-item"><a href="?page={{ article_list.number|add:1 }}" class="page-link bg-light text-dark">{{ article_list.number|add:1 }}</a></li>
{% endifnotequal %}
{% ifequal article_list.number|add:-1 0 %}
<li class="page-item"><a href="?page={{ article_list.number|add:2 }}" class="page-link bg-light text-dark">{{ article_list.number|add:2 }}</a></li>
{% endifequal %}
<!-- 跳转到最后一页 -->
<li class="page-item">
<a href="?page={{ article_list.paginator.num_pages}}" class="page-link bg-light text-dark" aria-label="Next">
<span aria-hidden="true">»</span>
<span class="sr-only">Next</span>
</a>
</li>
</ul>
</nav>
</div>
{% endif %}
...
找到模板中的分页导航部分，即 `` 后面部分。
首先修改
href属性，?page=1表示通过GET方法向后台提交数据page=1，通过这个方式向后台传递目标页码{% ifnotequal %}与{% ifequal %}标签分别判断两个值是否相等，当变量a不等于 变量b时{% ifnotequal a b %}会执行包含在标签内的代码，而{% ifequal a b %}标签则相反{{ article_list.number|add:1 }}返回的结果是变量article_list.number加上 1 的值
再次刷新页面，分页功能已经完成。
搜索
用户可以根据关键字所搜文章，关键字在文章内容和标题中匹配
模板文件
需要修首页中的搜索表单以及错误信息显示
<!-- templates/blog/index.html -->
...
<div class="sidebar-module">
<div class="input-group mb-3 content">
<div class="input-group-prepend">
<span class="input-group-text" id="basic-addon1">
<i class="fa fa-search" aria-hidden="true"></i>
</span>
</div>
<form action="{% url 'blog:search' %}" method="post">
{% csrf_token %}
<input name="query" type="text" class="form-control" placeholder="Search" aria-label="Search" aria-describedby="basic-addon1">
</form>
</div>
</div>
...
在模板文件中找到搜索表单，并按照以上代码修改。
{% url 'blog:search' %}就是127.0.0.1：8000/search的的意思，调用命名为'blog'的 urls.py 模块下名称为'search'的 url 规则。{% csrf_token %}标签会被替换成一个隐藏的<input>标签 ，该标签会在上传搜索关键字的时候，上传一个名字为csrfmiddlewaretoken的变量，这个是 django 用以保护网站不受黑客 csrf 攻击的一种机制。
<!-- templates/blog/index.html -->
...
{% for article in article_list %}
<div class="jumbotron bg-light">
<h1 class="display-4">{{ article.title }}</h1>
<p class="lead">{{ article.abstract }}</p>
<hr class="my-4">
<p class="text-muted">{{ article.create_time }} , by {{ article.author }}</p>
<a href="#" class="btn btn-dark btn-lg" role="button">Read more</a>
</div>
{% empty %}
<!-- 判断是否有错误信息 -->
{% if error_msg %}
<div class="jumbotron bg-light">
<p class="lead">{{ error_msg }}</p>
</div>
{% else %}
<div class="jumbotron bg-light">
<p class="lead">暂无文章，敬请期待！</p>
</div>
{% endif %}
{% endfor %}
...
添加视图函数
# blog/views.p
from django.db.models import Q
...
def search(request):
context = {}
# 从 request 请求中获取关键字
q = request.POST.get('query')
# 判断关键字是否存空
# 是则返回错误信息
if q is None or q=="":
error_msg = "请输入关键词！"
return render(request, 'blog/index.html', {'error_msg': error_msg})
# Q 用于包装查询表达式，提供复杂的查询逻辑
# 用 filter 过滤出含有关键字的文章
# | 表示或
article_list = Article.objects.all().filter(Q(title__icontains=q) | Q(body__icontains=q))
context['article_list'] = article_list
category_list = Category.objects.all()
context['category_list'] = category_list
if request.user.is_authenticated:
context['username']= request.user.username
return render(request, 'blog/index.html', context=context)
...
添加 url 规则
from django.urls import path
from . import views
app_name = 'blog'
urlpatterns = [
path('', views.index, name='index'),
# 将规则命名为 search 之后就可以通过 {% url 'blog:search' %} 使用
path('search/', views.search , name='search'),
]
搜索功能完成后，就可以在搜索表单中输入关键字来查询想要的文章。当然，这个搜索功能还很简单，没有关键字高亮，而且当文章一多的时候，效率就会大大下降，假如要解决这个问题，就需要建立数据库索引，这个这里不多说。
而想要通过其他字段来查询文章的话，也差不多如此，比如查询作者，先使用关键字查询并实例化相应的作者，在通过该对象查询文章并返回即可。
总结
首页的功能到这里就大致完成了，接下来就是完成文章详情页。
