搭建博客笔记：py_kouga (二) 建立博客应用

2018-10-15  本文已影响0人  智勇双全的小六

参考教程

  1. Django博客教程
  2. 自强学堂

建立博客应用

python manage.py startapp blog

这个 blog 目录下就是就是此 app 常用的文件。
py_kouga 下面是一些全局设置。

注册应用

把 blog 添加到 setting.py 文件。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog'
]

上面的app都是框架自带的，比如第一个就是admin，是一个后台管理应用。

设计博客的数据库表结构

3个表: 正文表、标签表、分类表。
涉及的代码可参考，https://www.zmrenwu.com/post/5/
我觉得值得关注的点有：

  1. 一般按照我的习惯，是直接写sql 去 mysql 里面创建这三个表的，但是如果不是 django 自动生成的表的化，字段名和字段属性有时和 orm 对不上，用起来就比较麻烦了。所以，一个完全空白的系统，还是按照 django 的 orm 来比较方便。
  2. mysql 与 django orm 的映射关系
mysql django orm
character(100) models.CharField(max_length=100)
text models.TextField()
timestamp models.DateTimeField()
允许字段为空 models.CharField(blank=True)
外键 models.ForeginKey(Category)
多个外键 models.ManyToManyField(Tag)
  1. 文章表的 author 字段直接使用的是django.contrib.auth.models.User, 这样的关联使得文章表与后台管理联系起来了。
  2. models.py 每个方法都要有 __str__ 描述符，便于人阅读。

orm 查改增删

使用 django shell

python manage.py shell

创建超级管理员

python manage.py createsuperuser
  1. 查改增删
    增加就是初始化 models 的子类，然后调用 save 函数进行保存。
from blog.models import Category, Tag, Post
c = Category(name="test category")
c.save()

查调用 models子类的 objects 的方法

Category.objects.all()

删改，是在查的基础上进行操作的

# 改完数据需要保存
c = Category.objects.get(name='category test')
>>> c.name = 'category test new'
>>> c.save()
# 删除数据肯定就直接执行了 delete 操作
>>> p = Post.objects.get(title='title test')
>>> p
<Post: title test>
>>> p.delete()

迁移数据库

python manage.py makemigrations, 创建改动文件。
python manage.py migrate, 把这些改动同步到数据库。
python manage.py sqlmigrate blog 0001,blog 是 app 名，0001 是 makemigrations 创建出来的0001_initial.py的简写，表示第一次改动 。

从文件目录中可以看到一个 db.sqlite3 的文件，这是因为settings.py 里面的默认配置是 sqlite3 数据库。我们可以修改此配置，改成mysql。

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

然后运行，python manage.py migrate, 发现报错了：

no module name "MySQLdb"

这个错误是正常的，因为 python3 已经把MySQLdb 这个模块改名叫“pymysql” 了。
所以，只需要pip install pymysql, 然后再修改一行django 的代码就好了。

# django 需要修改的文件：py_kouga/venv/lib/python3.5/site-packages/django/db/backends/mysql/__init__.py
# 添加内容
import pymysql
pymysql.install_as_MySQLdb()

视图函数

django 接受到请求后，会到路由那匹配地址，然后把请求下发给具体的函数。所以，写视图函数，第一步要让 url 和 视图函数进行映射。

这个地方的注意点是，每个 app 下面都新建一个 urls.py , 然后再把此文件注册到项目中的 urls.py 中去，这个办法好，能够方便管理不同 app 的urls。

  1. app py_kouga 下新建 urls.py
from django.conf.urls import url
from . import views

urlpatterns = [
    url(r'^$', views.index, name="index"),
]
  1. 把 app py_kouga 下新建 urls.py 注册到 project 里的 urls.py
from django.conf.urls import url, include
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'', include('blog.urls')),
]
  1. 在 views.py 中写具体的视图函数，注意视图函数必须要有一个 request 作为参数。

模板系统

模板系统（一）：勾连模板和视图函数

模板系统对于这个前后端分离的年代来说，似乎是非常鸡肋了，但是首页等比较固定的页面仍然使用模板，有利于提高页面渲染速度，这在实际的工程中也是这么干的。

  1. 建立目录 py_kouga/templates/blog
  2. 在 py_kouga/templates/blog 里面建立 index.html 文件。
  3. 将 py_kouga/templates 目录注册到project 的 settings.py 文件中。
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',
            ],
        },
    },
]
  1. index.html 中写内容
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ title }}</title>
</head>
<body>
<h1>
    {{ welcome }}
</h1>
</body>
</html>
  1. 修改 index 函数
from django.shortcuts import render
from django.http import HttpResponse

# Create your views here.


def index(request):
    return render(request, 'blog/index.html', context={
        "title": "hello",
        "welcome": "welcome to 我的博客"
    })

模板系统（二） ：模板继承与引入

模板的继承与引入，参考自强学堂的教程。
有如下几个关键点：

  1. 先建立一个 base.html ，这是一个基础模板。一个页面，大致上都是由头、导航栏、body、尾部栏这四部分组成的，一般而言只有 body 是不同的，所以这些相同的部分可以构成一个基础模板。
 <!-- 这个 load staticfiles 是为了引入静态资源 -->
{% load staticfiles %}
<!DOCTYPE html>
<html>
<head>
    <title>Kouga</title>

    <!-- meta -->
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">

    <!-- css -->
    <link rel="stylesheet" href="{% static 'css/bootstrap.min.css' %}">
    <link rel="stylesheet" href="http://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">
    <link rel="stylesheet" href="{% static 'blog/css/pace.css' %}">
    <link rel="stylesheet" href="{% static 'css/custom.css' %}">

    <!-- js -->
    <script src="{% static 'js/jquery-2.1.3.min.js' %}"></script>
    <script src="{% static 'js/bootstrap.min.js' %}"></script>
    <script src="{% static 'js/pace.min.js' %}"></script>
    <script src="{% static 'js/modernizr.custom.js' %}"></script>
</head>
<body>
{% include 'blog/lib/nav.html' %}
{% block content %}
<div>这里是默认内容，所有继承自这个模板的，如果不覆盖就显示这里的默认内容。</div>
{% endblock %}
{% include 'blog/lib/footer.html' %}
</body>
</html>
  1. 引入其他模板，直接使用 {% include 'blog/lib/nav.html' %}。看一个被引入的其他模板的例子,footer.html。
<footer id="site-footer">
    <div class="container">
        <div class="row">
            <div class="col-md-12">
                <p class="copyright">&copy 2017 - 采集自<a href="http://www.cssmoban.com/"
                                                        target="_blank" title="模板之家">模板之家</a>
                    - 由<a href="http://zmrenwu.com/" title="网页模板" target="_blank">Kouga</a>修改
                </p>
            </div>
        </div>
    </div>
</footer>
  1. 继承其他模板，使用{% block content %} ... {% endblock %}, 注意必须是一个闭区间，注意第一行必须声明要继承的模板。不然会解释失败。看 index.html 页面:
{% extends 'blog/lib/base.html' %}
{% block content %}
.... 用 body的 替换掉这
{% endblock %}

模板系统（三） ：模板语法

模板内嵌入一些简单的逻辑，参考自强学堂的教程。

  1. 首先修改视图函数，让它返回数据库中的文章。
from django.shortcuts import render
from .models import Post
from django.http import HttpResponse

# Create your views here.


def index(request):
    post_list = Post.objects.all().order_by('-created_time')
    return render(request, 'blog/index.html', context={'post_list': post_list})
  1. 修改 index.html 中的代码。
{% for post in post_list %}
  <article class="post post-{{ post.pk }}">
    ...
  </article>
{% empty %}
  <div class="no-post">暂时还没有发布的文章！</div>
{% endfor %}

这种 for, endfor 形式标签语法，第一次看挺怪，但是shell，C# 等语言就是这么搞的，所以看习惯了就好了。注意：

具体修改如下：

                {% for post in post_list %}
                <article class="post post-{{ post.pk }}">
                    <header class="entry-header">
                        <h1 class="entry-title">
                            <a href="single.html">{{ post.title }}</a>
                        </h1>
                        <div class="entry-meta">
                            <span class="post-category"><a href="#">{{ post.category.name }}</a></span>
                            <span class="post-date"><a href="#"><time class="entry-date"
                                                                      datetime="{{ post.created_time }}">{{ post.created_time }}</time></a></span>
                            <span class="post-author"><a href="#">{{ post.author }}<</a></span>
                            <span class="comments-link"><a href="#">4 评论</a></span>
                            <span class="views-count"><a href="#">588 阅读</a></span>
                        </div>
                    </header>
                    <div class="entry-content clearfix">
                        <p>{{ post.excerpt }}</p>
                        <div class="read-more cl-effect-14">
                            <a href="#" class="more-link">继续阅读 <span class="meta-nav">→</span></a>
                        </div>
                    </div>
                </article>
                {% empty %}
                <div class="no-post">暂时还没有发布的文章！</div>
                {% endfor %}

Django 后台

以前我在学习 Django 的时候不注意去搞这个后台，现在想想真是买椟还珠！Django 的强大之一就是这个很牛的后台，所以在框架的基础上快速进行二次开发也是非常重要的能力。也是基于这个原因，虽然现在 mvc 的模式已经过时了应该搞前后端分离，但是还是要把 模板系统这些东西给掌握掉，因为快！

Django 后台(一) 在 Admin 后台注册模型

在后台注册我们自己创建的几个模型，这样 Django Admin 才能知道它们的存在，注册非常简单，只需要在 blog\admin.py 中加入下面的代码：

blog/admin.py

from django.contrib import admin
from .models import *

admin.site.register(Post)
admin.site.register(Category)
admin.site.register(Tag)

激活虚拟环境，运行开发服务器，访问 http://127.0.0.1:8000/admin/ ，就进入了到了Django Admin 后台登录页面，输入刚才创建的管理员账户密码就可以登录到后台了。

每次都输入网址比较麻烦，我比较喜欢简书的设计同时觉得导航栏中博客的按钮比较多余，所以把导航栏中博客的按钮给改了。

<li class="cl-effect-11"><a href='/admin' data-hover="写文章">写文章</a></li>

然后，点击写文章准备输入账号密码登录后台，发现蛋疼的事情，我忘了账号密码了，麻蛋....
如果你也遇到这种情况，可以到数据库里去看看, 账户信息保存在auth_user 表中，用户名知道了，但是密码是加密过的。百度了一下，可以使用如下方法：

python manage.py changepassword username

登录进去之后，你会感叹，这后台非常适合编辑文章。是的，因为 Django 本身就是用来开发新闻后台的。

上一篇下一篇

猜你喜欢

热点阅读