Django搭建个人博客:创建并配置APP功能模块

5371阅读 · 4评论 · 2018/08/25发布   前往评论

创建APP

在Django中的一个app代表一个功能模块。开发者可以将不同功能的模块放在不同的app中, 方便代码的复用。app就是项目的基石,因此开发博客的第一步就是创建新的app,用来实现跟文章相关的功能模块。

打开命令行,进入项目所在的目录:(注意Django的操作必须在虚拟环境下进行)

E:\>cd django_project
E:\django_project>

进入虚拟环境(忘记进入venv方法的看这里: 在Windows中搭建Django的开发环境):

 E:\django_project> env\Scripts\activate.bat
(env) E:\>

看到盘符前有(env)标识则表示进入虚拟环境成功。

输入python manage.py startapp article指令,创建名为article的app:

(env) E:\django_project\my_blog>python manage.py startapp article

查看一下my_blog文件夹,应该看到这样的结构:

my_blog
│  db.sqlite3
│  manage.py
│
├─article
│  │  admin.py
│  │  apps.py
│  │  models.py
│  │  tests.py
│  │  views.py
│  │  __init__.py
│  │
│  └─migrations
│        └─ __init__.py
│
└─my_blog
    │  settings.py
    │  urls.py
    │  wsgi.py
    └─ __init__.py

项目结构分解如下:

  • 根目录my_blog下有两个文件:db.sqlite3是一个轻量级的数据库文件,用来存储项目产生的数据,比如博客文章;manage.py是项目执行命令的入口,比如runserver。

  • 目录article是刚创建出来的app,用来放置博客文章相关的代码:后台管理文件admin.py,数据模型文件models.py,视图文件views.py,存放数据迁移文件的目录migrations

  • 根目录下还有一个my_blog目录,其中的settings.py包含项目的配置参数,urls.py则是项目的根路由文件。

目前你需要了解的就这么多,后面的章节都会用到。剩下还有一些没讲到的文件可以暂时不管它,碰到时再查资料。

注册APP(settings)

接着我们需要修改项目配置文件,“告诉”Django现在有article这么一个app了。

打开my_blog目录的settings.py,找到INSTALLED_APPS写入如下代码:

my_blog/settings.py

INSTALLED_APPS = [
    # 其他代码
    ...

    # 新增'article'代码,激活app
    'article',
]

配置访问路径(urls)

然后再给app配置访问路径url。

url可以理解为访问网站时输入的网址链接,配置好url后Django才知道怎样定位app。

打开my_blog目录下的urls.py,增加以下代码:

my_blog/urls.py

from django.contrib import admin
# 记得引入include
from django.urls import path, include

# 存放映射关系的列表
urlpatterns = [
    path('admin/', admin.site.urls),

    # 新增代码,配置app的url
    path('article/', include('article.urls', namespace='article')),
]

path为Django的路由语法:

  • 参数article/分配了app的访问路径;
  • include将路径分发给下一步处理;
  • namespace可以保证反查到唯一的url,即使不同的app使用了相同的url(后面会用到)。

记得在顶部引入include

在开发环境下,article的url为:http://127.0.0.1:8000/article/

还没结束。现在我们已经通过path将根路径为article的访问都分发给article这个app去处理。但是app通常有多个页面地址,因此还需要app自己也有一个路由分发,也就是article.urls了。

article可以有多个页面,如列表页面、详情页面等,那么就需要如下两个url:

http://127.0.0.1:8000/article/list/

http://127.0.0.1:8000/article/detail/

app中的url.py就是用来区分它们的。

在app生成时并没有这个文件,因此需要自己在article文件夹中创建urls.py,在里面输入:

article/urls.py

# 引入path
from django.urls import path

# 正在部署的应用的名称
app_name = 'article'

urlpatterns = [
    # 目前还没有urls
]

urlpatterns中暂时是空的,没写入任何路径的映射,不着急以后会写。

此时我们的app就配置完成了。

注意此时app还没有写好,因此启动服务器可能会报错,是正常的。

Django2.0之后,app的urls.py必须配置app_name,否则会报错。

总结

本章创建了博客文章功能的app,学习了注册app并配置url。

下一章开始编写模型Model,理解Django的数据库处理。





<< 上一章 下一章 >>
本文作者: 杜赛
发布时间: 2018年08月25日 - 09:39
最后更新: 2019年03月10日 - 22:00
知识共享许可协议   转载请保留原文链接及作者



登录 后回复

共有4条评论

avatar
qq534959383 么么哒! 2

您好,安装依赖运行以后,admin正常进,首页http://127.0.0.1:8000后404错误

6个月前 回复


avatar
杜赛 [博主] qq534959383 么么哒! 1

这一章的app还没有写完,站点404应该是正常的。您先跟着把接下来几章写完,看看还报错不。

6个月前 回复


avatar
sys0613 么么哒! 1

跟随学习中,分享下部分心得。感谢博主

my_blog\urls.py中如果配置成

app的url,include(('article.urls', 'article'), namespace='article'))

则在article\urls.py中就不用配置如下的app_name='article'

app_name='article'

这是一个二选一的操作。

1个月前 回复


avatar
杜赛 [博主] sys0613 么么哒! 1

我没试过,学习了yes

1个月前 回复