Django2.0 推出,本篇幅文章有些根不上,我決定重點整理一下這篇入門教程!- ----2018.1.6 更新
-------
Django 自稱是“最適合開發有限期的完美WEB框架”。本文參考《Django web開發指南》,快速搭建一個blog 出來,在中間涉及諸多知識點,這里不會詳細說明,如果你是第一次接觸Django ,本文會讓你在感性上對Django有個認識,完成本文操作后會讓你有興趣閱讀的相關書籍和文檔。
廢話少說,come on!!
本操作的環境:
===================
Windows 10
python 3.6 https://www.python.org/
Django 2.0 https://www.djangoproject.com/
===================
創建項目
創建mysite項目和 blog應用:
> django-admin startproject mysite # 創建mysite項目
> cd mysite # 切換到mysite目錄
mysite> python manage.py startapp blog # 創建blog應用
項目目錄結構:
項目目錄介紹:
--------
manage.py : Django項目里面的工具,通過它可以調用django shell和數據庫等。
mysite/
| --- settings.py : 包含了項目的默認設置,包括數據庫信息,調試標志以及其他一些工作的變量。
| --- urls.py : 負責把URL模式映射到應用程序。
| --- wsgi.py : 用於項目部署。
blog /
| --- admin.py : django 自帶admin后面管理,將models.py 中表映射到后台。
| --- apps.py : blog 應用的相關配置。
| --- models.py : Django 自帶的ORM,用於設計數據庫表。
| --- tests.py : 用於編寫Django單元測試。
| --- veiws.py :視圖文件,用於編寫功能的主要處理邏輯。
打開settings.py 配置文件,添加blog應用。
# Application definition
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'blog', ]
初始化admin后台數據庫
Python 自帶SQLite3數據庫,Django默認使用SQLite3數據庫,如果使用其它數據庫請在settings.py文件中設置。
# Database # https://docs.djangoproject.com/en/2.0/ref/settings/#databases
DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': os.path.join(BASE_DIR, 'db.sqlite3'), } }
Django默認幫我們做很多事情,比如User、Session 這些都需要創建表來存儲數據,Django已經把這些模塊幫我准備好了,我們只需要執行數據庫同步,把相關表生成出來即可:
mysite> python manage.py migrate
Operations to perform: Apply all migrations: admin, auth, contenttypes, sessions Running migrations: Applying contenttypes.0001_initial... OK Applying auth.0001_initial... OK Applying admin.0001_initial... OK Applying admin.0002_logentry_remove_auto_add... 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 auth.0007_alter_validators_add_error_messages... OK Applying auth.0008_alter_user_username_max_length... OK Applying auth.0009_alter_user_last_name_max_length... OK Applying sessions.0001_initial... OK
要想登錄admin后台,必須要有帳號,接下來創建超級管理員帳號。
mysite> python manage.py createsuperuser Username (leave blank to use 'fnngj'): admin # 管理員帳號 Email address: admin@mail.com # email Password: # 密碼 Password (again): # 重復密碼 Superuser created successfully.
啟動應用 & 訪問admin后台
Django自帶Web,可以通過“runserver”命令啟動應用:
mysite> python manage.py runserver Performing system checks... System check identified no issues (0 silenced). January 06, 2018 - 11:02:32 Django version 2.0, using settings 'mysite.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CTRL-BREAK.
通過瀏覽器訪問:http://127.0.0.1:8000
訪問Admin 后台:http://127.0.0.0:8000/admin , 通過前面創建的超級管理員賬號。
django2.0 后台樣式做了自適應。
到此,准備工作結束。
設計Model(即設計數據庫表)
1、設計blog表
打開blog目錄下的models.py文件,這是定義blog數據結構的地方。
from django.db import models # Create your models here.
class BlogsPost(models.Model): title = models.CharField(max_length = 150) # 博客標題
body = models.TextField() # 博客正文
timestamp = models.DateTimeField() # 創建時間
2、再次執行數據庫同步。
mysite> python manage.py makemigrations blog Migrations for 'blog': blog\migrations\0001_initial.py - Create model BlogsPost mysite> python manage.py migrate Operations to perform: Apply all migrations: admin, auth, blog, contenttypes, sessions Running migrations: Applying blog.0001_initial... OK
4、通過Admin 管理。
通過Admin后台來管理blog表數據。打開 admin.py 文件。
from django.contrib import admin from blog.models import BlogsPost # Register your models here.
class BlogsPostAdmin(admin.ModelAdmin): list_display = ['title', 'body', 'timestamp'] admin.site.register(BlogsPost, BlogsPostAdmin)
5、登錄Admin后台添加blog
再次啟動項目,訪問:http://127.0.0.1:8000/admin
博客編寫完成,點擊“SAVE” 按鈕保存。
到此,數據部分已經搞定。
創建模板
在blog項目下創建templates目錄(mysite/blog/templates/),在目錄下創建模板文件index.html,內容如下:
{% for blog in blog_list %} <h2>{{ blog.title }}</h2>
<p>{{ blog.timestamp }}</p>
<p>{{ blog.body }}</p> {% endfor %}
這里涉及到Django模板語言,循環讀取表中的數據,顯示標題,創建時間和正文。
創建視圖函數
打開mysite/blog/views.py文件:
from django.shortcuts import render from blog.models import BlogsPost # Create your views here.
def blog_index(request): blog_list = BlogsPost.objects.all() # 獲取所有數據
return render(request,'index.html', {'blog_list':blog_list}) # 返回index.html頁面
blog_list = BlogPost.objects.all() :獲取數據庫里面所擁有BlogPost對象
render返回一個頁面(index.html),順帶把數據庫中查詢出來的所有博客內容(blog_list)也一並返回。
創建blog的URL模式
在mysite/urls.py文件里添加blog的url:
from django.contrib import admin from django.urls import path from blog import views urlpatterns = [ path('admin/', admin.site.urls), path('blog/', views.blog_index), ]
再次啟動服務($ python manage.py runserver),訪問blog應用(http://127.0.0.1:8000/blog/)。
頁面如下:
當然,你可以繼續到admin后台添加blog,從而刷新這個頁是否顯示新添加的blog。
到此,項目開發完成
美化blog
到 BootStrap 官網去找樣模板。http://www.bootcss.com/
https://v3.bootcss.com/examples/starter-template/ 這個樣式就很合適。
修改index.html模板。
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <!-- 上述3個meta標簽*必須*放在最前面,任何其他內容都*必須*跟隨其后! --> <meta name="description" content=""> <meta name="author" content=""> <title>Starter Template for Bootstrap</title> <!-- Bootstrap core CSS --> <link href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet"> <!-- Custom styles for this template --> <link href="starter-template.css" rel="stylesheet"> </head> <body> <nav class="navbar navbar-inverse navbar-fixed-top"> <div class="container"> <div class="navbar-header"> <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">蟲師blog</a> </div> <div id="navbar" class="collapse navbar-collapse"> <ul class="nav navbar-nav"> <li class="active"><a href="#">Home</a></li> <li><a href="#about">About</a></li> <li><a href="#contact">Contact</a></li> </ul> </div><!--/.nav-collapse --> </div> </nav> <div class="container" style="margin-top: 50px;"> <div class="starter-template"> {% for blog in blog_list %} <h2>{{ blog.title }}</h2> <p>{{ blog.timestamp }}</p> <p>{{ blog.body }}</p> {% endfor %} </div> </div><!-- /.container --> <script src="https://cdn.bootcss.com/jquery/1.12.4/jquery.min.js"></script> <script src="https://cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script> </body> </html>
再次刷新博客頁面:
http://127.0.0.1/blog/ 。
請系統的學習django web框架,然后在此基礎上做更多的擴展,開發自己真正的blog 。
-------------------------------------------------------------------------------------------------------------------------------------
參考:
《Django Web開發指南》 第二章
blog:http://my.oschina.net/matrixchan/blog/184445