美文网首页
搭建博客笔记:py_kouga (二) 建立博客应用

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

作者: 智勇双全的小六 | 来源:发表于2018-10-15 19:49 被阅读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 就要有 endfor 这些标签都是成对出现的;
    • {% empty %} 的作用是当 post_list 为空,即数据库里没有文章时显示 {% empty %} 下面的内容
    • {% empty %} 下可以放当列表为空时,想显示的内容。
    • 引用变量,需要2个花括号括起来,像这样 {{ post.pk }}。pk 是 primary key 的缩写,即 post 对应于数据库中记录的 id 值,该属性尽管我们没有显示定义,但是 Django 会自动为我们添加。models 里面的那些类我们都没有定义id这字段,但是 Django 在创建时都会默认添加。
    • 外键关联的好处,看这个{{ post.category.name }}, 直接用点就过去了,挺简单的。

    具体修改如下:

                    {% 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 本身就是用来开发新闻后台的。

    相关文章

      网友评论

          本文标题:搭建博客笔记:py_kouga (二) 建立博客应用

          本文链接:https://www.haomeiwen.com/subject/lbltzftx.html