DIV CSS 佈局教程網

把 Bootstrap 放進 Django:靜態檔案配置全流程
編輯:關於JavaScript     

Django 與 Bootstrap 的整合,真正需要設定的其實只有「靜態檔案要放哪、怎麼被找到」這件事。以下記錄完整流程。由於 Django 版本差異較大,以下配置以特定版本為例,僅供參考。

環境:Python 2.7.5、Django 1.9.4。

一、settings.py 的靜態檔案設定

 # Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/1.9/howto/static-files/

SITE_ROOT = os.path.join(os.path.abspath(os.path.dirname(__file__)), '..')
STATIC_ROOT = os.path.join(SITE_ROOT, 'static')
STATIC_URL = '/static/'

STATICFILES_DIRS = (
    ("css", os.path.join(STATIC_ROOT, 'css')),
    ("js", os.path.join(STATIC_ROOT, 'js')),
    ("images", os.path.join(STATIC_ROOT, 'images')),
    ("bower_components", os.path.join(STATIC_ROOT, 'bower_components')),
)

STATIC_URL 決定網址前綴,STATICFILES_DIRS 則是告訴 Django 到哪些目錄找資源。這裡用 bower_components 收放用 Bower 安裝的前端套件。

二、urls.py 的路由

 urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^$', views.index),
    url(r'^home/', views.home),
]

三、views.py 的視圖

 def home(request):
    return render_to_response('home/login.html')

四、樣板中引用靜態資源

 <!-- Bootstrap Core CSS -->
<link href="/static/bower_components/bootstrap/dist/css/bootstrap.min.css" rel="stylesheet">
<!-- Custom CSS -->
<link href="/static/css/sb-admin-2.css" rel="stylesheet">
<img src="/static/images/xjlxprocess.png" />

五、目錄結構

 website
---------static
---------|-----css
---------|-----js
---------|-----images
---------|-----bower_components
---------templates
---------|-----home
---------|-----------login.html
---------|-----admin
---------website

六、成果

兩個容易踩到的坑

第一,正式部署時 settings.py 的 DEBUG 必須關掉,而 Django 在 DEBUG=False 時不會自動服務靜態檔案,需要額外設定 STATIC_ROOT 並執行 collectstatic,再由 Nginx 或 CDN 提供。

第二,較新版本的 Django 已不建議直接寫死 /static/... 路徑,而應在樣板中 load static 後使用 {% static 'css/style.css' %}。這樣做的好處是路徑集中管理,日後要換 CDN 域名時只改一處設定即可。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved