Django入门：搭建简易博客

最新推荐文章于 2023-06-21 17:27:45 发布

bingli7

最新推荐文章于 2023-06-21 17:27:45 发布

阅读量471

点赞数 2

分类专栏： Python Django 文章标签： Python Django

本文链接：https://blog.csdn.net/DeepblueSolo/article/details/90521412

版权

Python 同时被 2 个专栏收录

1 篇文章 0 订阅

订阅专栏

Django

1 篇文章 0 订阅

订阅专栏

1. 博客功能

实现以下简单功能

查看博客文章列表
查看文章内容
编辑文章
发表文章

2. 开发环境

Python环境：python 3.5

$ python --version
Python 3.5.7

Django: 1.8

$ pip show django
Name: Django
Version: 1.8.18
Summary: A high-level Python Web framework that encourages rapid development and clean, pragmatic design.
Home-page: http://www.djangoproject.com/
Author: Django Software Foundation
Author-email: foundation@djangoproject.com
License: BSD
Location: /Users/libing/.pyenv/versions/3.5.7/envs/myblog/lib/python3.5/site-packages
Requires:
Required-by:

数据库：MySql 5.7
IDE：PyCharm

3. 准备工作

3.1 建库及用户

数据库名：myblog

用户名/密码：bloguser/blogpassword

$ mysql -u root -p
Enter password:

mysql> create database myblog default charset utf8;

mysql> create user "bloguser"@"%" identified by "blogpassword";

mysql> grant all privileges on myblog.* to "bloguser"@"%";

mysql> flush privileges;

3.2 新建Django项目

3.2.1 新建项目

命令行新建项目：

$ django-admin startproject myblog

$ tree myblog/
myblog/
├── manage.py
└── myblog
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

1 directory, 5 files

3.2.2 修改配置文件

修改配置文件：myblog/myblog/settings.py

数据库配置：

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

语言及时区：

LANGUAGE_CODE = 'en-us'

TIME_ZONE = 'Asia/Shanghai'

3.3 新建APP应用

3.3.1 新建应用simpleblog

$ python manage.py startapp simpleblog

注：

若提示：No module named ‘MySQLdb’，请安装mysqlclient：

$ pip install mysqlclient

3.3.2 添加应用至project

修改myblog/myblog/settings.py，将simpleblog添加至INSTALLED_APPS：

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'simpleblog',   # 新增本行
)

3.3.3 APP目录结构

$ tree simpleblog/
simpleblog/
├── __init__.py
├── admin.py
├── migrations
│   └── __init__.py
├── models.py
├── tests.py
└── views.py

1 directory, 6 files

3.4 数据库同步

先将原有的auth, admin等迁移至数据库：

$ python manage.py makemigrations
No changes detected

$ python manage.py migrate
Operations to perform:
  Synchronize unmigrated apps: messages, staticfiles
  Apply all migrations: auth, sessions, admin, contenttypes
Synchronizing apps without migrations:
  Creating tables...
    Running deferred SQL...
  Installing custom SQL...
Running migrations:
  Rendering model states... DONE
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying sessions.0001_initial... OK

登陆数据库查看：

$ mysql -u bloguser -p
Enter password:

mysql> use myblog;

mysql> show tables;
+----------------------------+
| Tables_in_myblog           |
+----------------------------+
| auth_group                 |
| auth_group_permissions     |
| auth_permission            |
| auth_user                  |
| auth_user_groups           |
| auth_user_user_permissions |
| django_admin_log           |
| django_content_type        |
| django_migrations          |
| django_session             |
+----------------------------+
10 rows in set (0.00 sec)

各个表已成功创建。

3.5 管理员站点

新建superuser：

$ python manage.py createsuperuser
Username (leave blank to use 'libing'): admin
Email address: admin@admin.com
Password:
Password (again):
Superuser created successfully.

3.6 启动Django Server

$ python manage.py runserver
Performing system checks...

System check identified no issues (0 silenced).
May 24, 2019 - 14:54:32
Django version 1.8.18, using settings 'myblog.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

浏览器登录：http://127.0.0.1:8000/，可正常访问。

登陆管理员站点：http://127.0.0.1:8000/admin/，可正常用admin账户登陆。

4. 博客代码编写

4.1 Model定义

myblog/simpleblog/models.py:

from django.db import models

class Article(models.Model):
    title = models.CharField('标题', max_length=200)
    content = models.TextField('内容', default='blog content')
    pub_date = models.DateTimeField('发表时间', auto_now=True)

    def __str__(self):
        return self.title

4.2 数据同步

再次执行makemigrations和migrate，以同步更新的Model：

$ python manage.py makemigrations
Migrations for 'simpleblog':
  0001_initial.py:
    - Create model Article

$ python manage.py migrate
Operations to perform:
  Synchronize unmigrated apps: messages, staticfiles
  Apply all migrations: contenttypes, simpleblog, sessions, admin, auth
Synchronizing apps without migrations:
  Creating tables...
    Running deferred SQL...
  Installing custom SQL...
Running migrations:
  Rendering model states... DONE
  Applying simpleblog.0001_initial... OK

同步成功。

4.3 Model注册至admin

可将Model注册至admin页面：

myblog/simpleblog/admin.py:

from django.contrib import admin
from .models import Article

admin.site.register(Article)

启动server（python manage.py runserver）便可在admin界面看到该Model，并可在admin界面新增或编辑Article。

4.4 admin界面新增记录

在admin界面新增一个Article，如：

title：My first blog

content：This is my first blog

在这里插入图片描述

4.5 修改Model在admin界面的显示方式

myblog/simpleblog/admin.py:

from django.contrib import admin
from .models import Article

class ArticleAdmin(admin.ModelAdmin):
    # 显示列
    list_display = ('title', 'content', 'pub_date')
    # 过滤项
    list_filter = ('pub_date',)

admin.site.register(Article, ArticleAdmin)

修改完成后，在admin界面可以看到list_display中指定的列，并可通过list_filter过滤：

在这里插入图片描述

4.6 博客主页面开发

首先，在admin界面手动新增几条Article记录。

在这里插入图片描述

4.6.1 Template定义

myblog/simpleblog/templates/simpleblog/index.html:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>岳周's Blog</title>
</head>
<body>
<h1>
    {% for article in articles %}
        <a href="">{{ article.title }}</a>
        <br/>
    {% endfor %}
</h1>
<br/><br/>
<h3>
    <a href="">发表文章</a>
</h3>
</body>
</html>

注：由于还未定义每篇文章的链接，href先为空

4.6.2 view定义

myblog/simpleblog/views.py

from django.shortcuts import render
from .models import Article

def blog_index(request):
    # 获取所有Article
    articles = Article.objects.all()
    
    # render(request, template_name, context)
    # 注意：
    # context是字典dict
    # dict中key为字符串
    return render(request, template_name='simpleblog/index.html', context={"articles": articles})

4.6.3 App urls定义

myblog/simpleblog/urls.py

from django.conf.urls import url
from . import views

urlpatterns = [
    # url(regex, view, name)
    url(r'^$', views.blog_index, name="blog_index")
]

4.6.4 Project urls定义

myblog/myblog/urls.py

from django.conf.urls import include, url
from django.contrib import admin

urlpatterns = [
    # 注意单引号，并指定namespace
    url(r'^blog/', include('simpleblog.urls', namespace="simpleblog")),
    url(r'^admin/', include(admin.site.urls)),
]

启动server，访问：http://127.0.0.1:8000/blog/

index页面可正常显示所有的文章：

在这里插入图片描述

4.7 文章页面开发

4.7.1 template定义

myblog/simpleblog/templates/simpleblog/article_page.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ article.title }}</title>
</head>
<body>
    <h1>
        {{ article.title }}
    </h1>
<br/>
<h2>
    {{ article.content }}
</h2>
<br/><br/>
<h4>
    <a href="">编辑此文章</a>
</h4>
</body>
</html>

4.7.2 view定义

myblog/simpleblog/views.py 中新增：

# article_id对应urls中的参数
def article_page(request, article_id):
    article = Article.objects.get(id=article_id)
    return render(request, template_name='simpleblog/article_page.html', context={'article': article})

4.7.3 App urls定义

修改myblog/simpleblog/urls.py

urlpatterns = [
    # url(regex, view, name)
    url(r'^$', views.blog_index, name='blog_index'),
    # article/2
    url(r'^article/(?P<article_id>\d+)/$', views.article_page, name='article_page')
]

启动server，访问：http://127.0.0.1:8000/blog/article/3/

页面可正常显示文章内容

在这里插入图片描述

4.7.4 更新index页面跳转链接

myblog/simpleblog/templates/simpleblog/index.html:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>岳周's Blog</title>
</head>
<body>
<h1>
    {% for article in articles %}
        <a href="{% url 'simpleblog:article_page' article.id %}">{{ article.title }}</a>
        <br/>
    {% endfor %}
</h1>
<br/><br/>
<h3>
    <a href="">发表文章</a>
</h3>
</body>
</html>

验证可正常跳转。

4.8 文章编辑页面开发

4.8.1 template定义

myblog/simpleblog/templates/simpleblog/edit_page.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ article.title }}</title>
</head>
<body>
<form action="{% url 'simpleblog:edit_action' %}" method="post">
    <label>
        标题：
        <input type="text" name="title" value="{{ article.title }}"/>
    </label>
    <br/>
    <label>
        内容：
        <input type="text" name="content" value="{{ article.content }}"/>
    </label>
    <br/>
    <input type="submit" name="提交"/>
</form>
</body>
</html>

4.8.2 view定义

myblog/simpleblog/views.py增加：

def edit_page(request, article_id):
    article = Article.objects.get(id=article_id)
    return render(request, template_name='simpleblog/edit_page.html', context={'article': article})


def edit_action(request):
    pass

注：edit_action为下一步编辑提交所使用

4.8.3 App urls定义

修改myblog/simpleblog/urls.py

urlpatterns = [
    # url(regex, view, name)
    url(r'^$', views.blog_index, name='blog_index'),
    # article/2
    url(r'^article/(?P<article_id>\d+)/$', views.article_page, name='article_page'),
    url(r'^article/(?P<article_id>\d+)/edit/$', views.edit_page, name='edit_page'),
    url(r'^article/edit_action/$', views.edit_action, name='edit_action'),
]

注：edit_action后面实现

启动server，访问：http://127.0.0.1:8000/blog/article/2/edit/

页面可正常显示编辑页面：

在这里插入图片描述

4.9 编辑提交View实现

按照编辑界面template如下定义：

<form action="{% url 'simpleblog:edit_action' %}" method="post">

提交后将会发送POST请求至edit_action（url为article/edit_action/）。

4.9.1 template

myblog/simpleblog/templates/simpleblog/edit_page.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ article.title }}</title>
</head>
<body>
<form action="{% url 'simpleblog:edit_action' %}" method="post">
    {% csrf_token %}
    <input type="hidden" name="article_id" value="{{ article.id }}"/>
    <label>
        标题：
        <input type="text" name="title" value="{{ article.title }}"/>
    </label>
    <br/>
    <label>
        内容：
        <input type="text" name="content" value="{{ article.content }}"/>
    </label>
    <br/>
    <input type="submit" name="提交"/>
</form>
</body>
</html>

新增两行：

跨域访问相关

{% csrf_token %}

发送POST请求时，提交当前article_id

<input type="hidden" name="article_id" value="{{ article.id }}"/>

4.9.2 view定义

myblog/simpleblog/views.py

def edit_action(request):
    article_id = request.POST['article_id']
    new_title = request.POST['title']
    new_content = request.POST['content']

    article = Article.objects.get(id=article_id)
    article.title = new_title
    article.content = new_content
    article.save()
    # reverse(namespace:name, url参数列表)
    return HttpResponseRedirect(reverse('simpleblog:article_page', args=(article_id, )))

实现编辑提交view。

编辑提交成功后，重定向到新的文章界面。

4.9.3 修改文章页面template

myblog/simpleblog/templates/simpleblog/article_page.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ article.title }}</title>
</head>
<body>
<h1>
    {{ article.title }}
</h1>
<br/>
<h2>
    {{ article.content }}
</h2>
<br/><br/>
<h4>
    <a href="{% url 'simpleblog:edit_page' article.id %}">编辑此文章</a>
</h4>
</body>
</html>

在文章页面添加编辑文章链接。

4.9.4 测试

打开文章页面：http://127.0.0.1:8000/blog/article/2/
点击下方的"编辑此文章"链接，可正确跳转到编辑页面：http://127.0.0.1:8000/blog/article/2/edit/
编辑title和content后提交，提交成功
提交后跳转到该文章的页面，且正确显示修改后的内容。

4.10 发表文章页面

可重复利用"页面编辑"的view和template，定义发表新文章时的article_id为0。

4.10.1 主页面template

myblog/simpleblog/templates/simpleblog/index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>岳周's Blog</title>
</head>
<body>
<h1>
    {% for article in articles %}
        <a href="">{{ article.title }}</a>
        <br/>
    {% endfor %}
</h1>
<br/><br/>
<h3>
    <a href="{% url 'simpleblog:edit_page' 0 %}">发表博客</a>
</h3>
</body>
</html>

"发表博客"链接跳转到edit_page，其中article_id=0。

因此会跳转到：http://127.0.0.1:8000/blog/article/0/edit/

4.10.2 编辑页面template

myblog/simpleblog/templates/simpleblog/edit_page.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ article.title | default:"发表新文章"}}</title>
</head>
<body>
<form action="{% url 'simpleblog:edit_action' %}" method="post">
    {% csrf_token %}
    <input type="hidden" name="article_id" value="{{ article.id | default:0}}"/>
    <label>
        标题：
        <input type="text" name="title" value="{{ article.title }}"/>
    </label>
    <br/>
    <label>
        内容：
        <input type="text" name="content" value="{{ article.content }}"/>
    </label>
    <br/>
    <input type="submit" name="提交"/>
</form>
</body>
</html>

利用template中的默认值：

若article不存在，则相应HTML标签为空（不会报错）；

若article不存在，可以设定默认值，如：{{ article.id | default:0}}。article不存在时，提交的article_id为0，然后交由edit_action处理article_id为0时的逻辑。

4.10.3 编辑页面view定义

myblog/simpleblog/views.py

def edit_page(request, article_id):
    # article_id为0，新建博客, 注意char到int转换
    if int(article_id) == 0:
        return render(request, template_name='simpleblog/edit_page.html')
    else:
        # 编辑已有博客
        article = Article.objects.get(id=article_id)
        return render(request, template_name='simpleblog/edit_page.html', context={'article': article})

传入的article_id为0时，表示新建博客，article不存在时，HTML中相应的标签值为空，因此并不影响显示效果。

4.10.4 提交view定义

myblog/simpleblog/views.py

def edit_action(request):

    article_id = request.POST['article_id']
    new_title = request.POST['title']
    new_content = request.POST['content']
    # article_id为0，新建博客
    if int(article_id) == 0:
        new_article=Article.objects.create(title=new_title, content=new_content)
        return HttpResponseRedirect(reverse('simpleblog:article_page', args=(new_article.id, )))
    else:
        # 编辑已有博客
        article = Article.objects.get(id=article_id)
        article.title = new_title
        article.content = new_content
        article.save()
        # reverse(namespace:name, url参数列表)
        return HttpResponseRedirect(reverse('simpleblog:article_page', args=(article_id, )))

若article_id为0，则需要新建Article对象；

若article_id不为0，则需要update相应ID的Article对象。

4.10.5 测试

新建博客->提交保存->新博客正常显示

-------------------------------END--------------------------------------------

bingli7

关注

2
点赞
踩
4

收藏

觉得还不错? 一键收藏
0
评论
Django入门：搭建简易博客

1. 博客功能实现以下简单功能查看博客文章列表查看文章内容编辑文章发表文章2. 开发环境Python环境：python 3.5$ python --versionPython 3.5.7Django: 1.8$ pip show djangoName: DjangoVersion: 1.8.18Summary: A high-level Python We...
复制链接

扫一扫