参考教程
建立博客应用
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/
我觉得值得关注的点有：
- 一般按照我的习惯，是直接写sql 去 mysql 里面创建这三个表的，但是如果不是 django 自动生成的表的化，字段名和字段属性有时和 orm 对不上，用起来就比较麻烦了。所以，一个完全空白的系统，还是按照 django 的 orm 来比较方便。
- 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) |
- 文章表的
author字段直接使用的是django.contrib.auth.models.User, 这样的关联使得文章表与后台管理联系起来了。 - models.py 每个方法都要有
__str__描述符，便于人阅读。
orm 查改增删
使用 django shell
python manage.py shell
创建超级管理员
python manage.py createsuperuser
- 查改增删
增加就是初始化 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。
- app py_kouga 下新建 urls.py
from django.conf.urls import url
from . import views
urlpatterns = [
url(r'^$', views.index, name="index"),
]
- 把 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')),
]
- 在 views.py 中写具体的视图函数，注意视图函数必须要有一个 request 作为参数。
模板系统
模板系统（一）：勾连模板和视图函数
模板系统对于这个前后端分离的年代来说，似乎是非常鸡肋了，但是首页等比较固定的页面仍然使用模板，有利于提高页面渲染速度，这在实际的工程中也是这么干的。
- 建立目录 py_kouga/templates/blog
- 在 py_kouga/templates/blog 里面建立 index.html 文件。
- 将 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',
],
},
},
]
- index.html 中写内容
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>{{ title }}</title>
</head>
<body>
<h1>
{{ welcome }}
</h1>
</body>
</html>
- 修改 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 我的博客"
})
模板系统（二） ：模板继承与引入
模板的继承与引入，参考自强学堂的教程。
有如下几个关键点：
- 先建立一个 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>
- 引入其他模板，直接使用
{% 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">© 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>
- 继承其他模板，使用
{% block content %} ... {% endblock %}, 注意必须是一个闭区间，注意第一行必须声明要继承的模板。不然会解释失败。看 index.html 页面:
{% extends 'blog/lib/base.html' %}
{% block content %}
.... 用 body的 替换掉这
{% endblock %}
模板系统（三） ：模板语法
模板内嵌入一些简单的逻辑，参考自强学堂的教程。
- 首先修改视图函数，让它返回数据库中的文章。
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})
- 修改 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 本身就是用来开发新闻后台的。
