使用django搭建博客并部署

时间：2023-03-09 09:14:41
使用django搭建博客并部署

2017/8/31 18:27:59

为了以后参考的方便，在这里总结一下django搭建博客网站的主要步骤。以下大部分的内容，参考自Django中文文档 - 看云。

需要强调的是，这里使用的django版本是1.8。这是因为，不同版本之间的django之间存在一定的差异。

1.安装django

在命令行中使用如下命令安装django

pip install django==1.8

安装结束后，在命令行中输入python，进入python命令行。然后尝试导入django

>>> import django

>>> django.get_version()

'1.8'

这说明，django安装成功了。

2.创建项目mysite

在命令行中，使用cd命令进入你想存储代码的目录，然后运行如下命令

python django-admin.py startproject mysite

于是，当前目录下建立了一个mysite目录，结构如下

mysite/

	manage.py

	mysite/

		__init__.py

		setting.py

		urls.py

		wsgi.py

从外层的mysite目录切换进去，通过如下命令，我们就能运行服务器

python manage.py runserver

在http://127.0.0.1:8000/，我们将看到如下页面

使用django搭建博客并部署

3.编辑setting.py

在mysite/settings.py中保存着django项目的配置。通过编辑它，可以修改项目的配置。

设置语言版本

LANGUAGE_CODE = 'zh-cn'

注：在1.9及以后的版本中，需要使用'zh-hans'

更改时区

TIME_ZONE = 'Asia/Shanghai'

在这里还可以修改数据库设置，这里不做修改，使用默认sqlites数据库。

修改完毕后，在命令行中运行如下命令，进行数据库的同步

python manage.py syncdb

运行此命令后，命令行会询问是否创建管理员账户。选择是，因为这将会很有用。

重新运行服务器，访问http://127.0.0.1:8000/admin/，你将看到如下页面

使用django搭建博客并部署

输入刚刚设置的用户名和密码就可以登录到网站的管理界面了。开不开心？当然，现在还没有多少功能。

4.创建应用及后台设置

使用如下命令，创建应用

python manage.py startapp blog

这将创建一个blog目录，如下

blog/

	__init__.py

	admin.py

	models.py

	tests.py

	views.py

为了激活这个应用，我们编辑mysite/setting.py文件，在INSTALLED_APPS中加入‘blog’，如下

INSTALLED_APPS = (

    'django.contrib.admin',

    'django.contrib.auth',

    'django.contrib.contenttypes',

    'django.contrib.sessions',

    'django.contrib.messages',

    'django.contrib.staticfiles',

    'blog',

)

在blog/models.py中添加如下内容

from django.db import models

from django.contrib import admin

class BlogsPost(models.Model):

    title = models.CharField(max_length = 150)

    body = models.TextField()

    timestamp = models.DateTimeField()

admin.site.register(BlogsPost)

其中，最后一行是为了在管理界面添加BlogsPsot，以便管理。

运行如下命令，进行数据库同步

python manage.py makemigrations

python manage.py migrate

启动服务器，并登录到网站的管理界面，你将看到

使用django搭建博客并部署

点击Blogs posts后面的增加按钮，创建文章。输入标题，正文和日期时间，并保存你的文章。

使用django搭建博客并部署

接下来设置管理界面中blogs post显示。在blog/models.py中添加如下内容

class BlogPostAdmin(admin.ModelAdmin):

	list_display = ('title','timestamp')

admin.site.register(BlogPostAdmin)

刷新之前的页面，你将看到

使用django搭建博客并部署

到这里，我们完成了一个简单的博客后台。

5.使用markdown显示你的博客

我们写前端部分，使得我们可以查看之前写的博客。

首先，我们在blog目录下创建templates目录，并添加模板文件index.html。现在我们的blog目录如下

blog/

	__pycache__/ ...

	migrations/  ...

	templates/

		index.html

	__init__.py

	admin.py

	models.py

	tests.py

	views.py

在index.html中添加如下内容

{% for post in blog_list %}

	<h2>{{post.title}}</h2>

	<p> {{post.timestamp}}</p>

	<p> {{post.body}}</p>

{% endfor %}

接下来，我们创建视图函数，将数据库中blogspost渲染到这个模板文件中。在blog/views.py中添加如下内容

from django.shortcuts import render_to_response

from blog.models import BlogsPost

def index(request):

	blog_list = BlogsPost.objects.all()

	return render_to_response('templates/index.html',{'blog_list':blog_list})

index函数将从数据库中的BlogsPost对象查询出来，渲染到index.html中，并返回index.html。我们现在的任务是将这个函数绑定一个URL。

修改mysite/urls.py，如下

from django.conf.urls import include, url

from django.contrib import admin

urlpatterns = [

    url(r'^admin/', include(admin.site.urls)),

    url(r'^index/$','blog.views.index'),

]

现在运行服务器，访问http://127.0.0.1:8000/index/，你将看到如下的页面

使用django搭建博客并部署

接下来，对博文添加markdown支持。在blog/views.py修改index函数

from markdown import markdown

def index(request):

	blog_list = BlogsPost.objects.all()

	for post in blog_list:

		post.body=markdown(post.body,extensions=['table'])

	return render_to_response('index.html',{'blog_list':blog_list})

修改blog/templates/index.html为

{% for post in blog_list %}

	<h2>{{post.title}}</h2>

	<p> {{post.timestamp}}</p>

	{% autoescape off %}

	    {{post.body}}

	{% endautoescape %}

{% endfor %}

参考[4]介绍了{% autoescape off %}的含义

off的意思是关闭对html的转义，而将off替换成on就表示进行html转义，默认进行html转义。

参考[7]介绍了如何在使得包markdown支持渲染表格。

重新编辑博文，访问http://127.0.0.1:8000/index，我们将看到

使用django搭建博客并部署

6.网站的部署

下载Apache2.4，下载地址

https://www.apachehaus.com/cgi-bin/download.plx#APACHE24VC09

解压之后，修改Apache24/conf/httpd.conf中的以下内容（配合ctrl+f）

Define SRVROOT "D:/Apache24"

ServerRoot "${SRVROOT}"

Listen 0.0.0.0:8000

启动Apache24/bin/httpd.exe程序，访问http://127.0.0.1:8000，会在浏览器上看到Apache的欢迎界面。

下载mod_wsgi，下载地址

http://www.lfd.uci.edu/~gohlke/pythonlibs/#mod_wsgi

使用pip安装下载的whl。安装成功后，在命令行中运行如下命令

mod_wsgi-express module-config

拷贝输出的三行结果，复制到Apache24/conf/httpd.conf的末尾。

将如下内容拷贝到Apache24/conf/httpd.conf的末尾。请将[~]替换为你项目的地址。

#指定myweb项目的wsgi.py配置文件路径

WSGIScriptAlias / [~]/wsgi.py  

#指定项目路径

WSGIPythonPath [~]  

<Directory [~]/mysite>

<Files wsgi.py>

    Require all granted

</Files>

</Directory>  

Alias /static [~]/static

<Directory [~]/static>

    AllowOverride None

    Options None

    Require all granted

</Directory>

然后在mysite/setting.py中添加或修改以下内容

DEBUG = False

TEMPLATE_DEBUG = False

ALLOWED_HOSTS = ['127.0.0.1', 'localhost']

完成这些之后，我们还必须收集关于admin的静态文件。

在mysite/setting.py中将以下内容

STATIC_URL = '/static/'

#STATIC_ROOT = os.path.join(BASE_DIR, "static")

TEMPLATE_DIRS = (

    os.path.join(BASE_DIR, "templates"),

)  

STATICFILES_DIRS = (

    os.path.join(BASE_DIR, "static"),

)

修改为

STATIC_URL = '/static/'

STATIC_ROOT = os.path.join(BASE_DIR, "static")

TEMPLATE_DIRS = (

    os.path.join(BASE_DIR, "templates"),

)

STATICFILES_DIRS = (

    #os.path.join(BASE_DIR, "static"),

)

在manage.py的目录下运行如下命令

python manage.py collectstatic

运行完毕之后，将上一步mysite/setting.py的设置还原。

按照同样的方法在云服务器上部署，效果如图

使用django搭建博客并部署

基本的框架搭建好了，接下来就可以修改网站的逻辑和样式了，对网站进行进一步的完善了。

参考

[1] 看云-django中文文档1.8

[2] 虫师-django快速搭建blog

[3] 一介码农-在django中使用markdown

[4] 追梦者的部落格-django输出html内容

[5] 蜗牛工作站-Django1.7+Apache2.4部署

[6] 小二走刀口-whl文件中找不到mod_wsgi.so文件解决办法

[7] sggmentfault-django如何渲染markdown的表格

本文链接：http://www.superzhang.site/blog/django-build-blog

相关文章