本教程上接教程 5。 我們已經(jīng)建立一個測試過的網(wǎng)頁投票應(yīng)用,現(xiàn)在我們將添加一張樣式表和一張圖片。
除了由服務(wù)器生成的HTML文件外,網(wǎng)頁應(yīng)用一般需要提供其它必要的文件 —— 比如圖片文件、JavaScript腳本和CSS樣式表 —— 來為用戶呈現(xiàn)出一個完整的網(wǎng)站。 在Django中,我們將這些文件稱為“靜態(tài)文件”。
對于小型項(xiàng)目,這不是個大問題,因?yàn)槟憧梢詫⑺鼈兎旁谀愕木W(wǎng)頁服務(wù)器可以訪問到的地方。 然而,在大一點(diǎn)的項(xiàng)目中 —— 尤其是那些由多個應(yīng)用組成的項(xiàng)目 —— 處理每個應(yīng)用提供的多個靜態(tài)文件集合開始變得很難。
這正是django.contrib.staticfiles的用途:它收集每個應(yīng)用(和任何你指定的地方)的靜態(tài)文件到一個單獨(dú)的位置,這個位置在線上可以很容易維護(hù)。
首先在你的polls中創(chuàng)建一個static目錄。Django將在那里查找靜態(tài)文件,與Django如何polls/templates/內(nèi)部的模板類似。
Django 的 STATICFILES_FINDERS 設(shè)置包含一個查找器列表,它們知道如何從各種源找到靜態(tài)文件。 其中默認(rèn)的一個是AppDirectoriesFinder,它在每個INSTALLED_APPS下查找“static”子目錄,就像剛剛在polls中創(chuàng)建的一樣。管理站點(diǎn)也為它的靜態(tài)文件使用相同的目錄結(jié)構(gòu)。
在你剛剛創(chuàng)建的static目錄中,創(chuàng)建另外一個目錄polls并在它下面創(chuàng)建一個文件style.css。換句話講,你的樣式表應(yīng)該位于polls/static/polls/style.css。因?yàn)锳ppDirectoriesFinder 靜態(tài)文件查找器的工作方式,你可以通過polls/style.css在Django中訪問這個靜態(tài)文件,與你如何訪問模板的路徑類似。
靜態(tài)文件的命名空間
與模板類似,我們可以家那個我們的靜態(tài)文件直接放在polls/static(而不是創(chuàng)建另外一個polls 子目錄),但實(shí)際上這是一個壞主意。Django將使用它所找到的第一個文件名符合要求的靜態(tài)文件,如果在你的不同應(yīng)用中存在兩個同名的靜態(tài)文件,Django將無法區(qū)分它們。 我們需要告訴Django該使用其中的哪一個,最簡單的方法就是為它們添加命名空間。 也就是說,將這些靜態(tài)文件放進(jìn)以它們所在的應(yīng)用的名字命名的另外一個目錄下。
將下面的代碼放入樣式表中 (polls/static/polls/style.css):
polls/static/polls/style.css
li a {
color: green;
}
下一步,在polls/templates/polls/index.html的頂端添加如下內(nèi)容 :
polls/templates/polls/index.html
{% load staticfiles %}
<link rel="stylesheet" type="text/css" href="{% static 'polls/style.css' %}" />
{% load staticfiles %} 從staticfiles模板庫加載{% static %} 模板標(biāo)簽。{% static %}模板標(biāo)簽會生成靜態(tài)文件的絕對URL。
這就是你在開發(fā)過程中,所需要對靜態(tài)文件做的所有處理。 重新加載 http://localhost:8000/polls/ ,你應(yīng)該會看到Question的超鏈接變成了綠色(Django的風(fēng)格!),這意味著你的樣式表被成功導(dǎo)入。
下一步,我們將創(chuàng)建一個子目錄來存放圖片。 在polls/static/polls/目錄中創(chuàng)建一個 images 子目錄。在這個目錄中,放入一張圖片background.gif。換句話,將你的圖片放在 polls/static/polls/images/background.gif。
然后,向你的樣式表添加(polls/static/polls/style.css):
polls/static/polls/style.css
body {
background: white url("images/background.gif") no-repeat right bottom;
}
重新加載 http://localhost:8000/polls/ ,你應(yīng)該在屏幕的右下方看到載入的背景圖片。
警告:
當(dāng)然,
{% static %}模板標(biāo)簽不能用在靜態(tài)文件(比如樣式表)中,因?yàn)樗麄儾皇怯蒁jango生成的。 你應(yīng)該永遠(yuǎn)使用相對路徑來相互鏈接靜態(tài)文件,因?yàn)檫@樣你可以改變STATIC_URL ( static模板標(biāo)簽用它來生成URLs)而不用同時(shí)修改一大堆靜態(tài)文件的路徑。
這些知識基礎(chǔ)。關(guān)于靜態(tài)文件設(shè)置的更多細(xì)節(jié)和框架中包含的其它部分,參見靜態(tài)文件 howto 和靜態(tài)文件參考。部署靜態(tài)文件討論如何在真實(shí)的服務(wù)器上使用靜態(tài)文件。
新手教程到此結(jié)束。 在這期間,你可能想要在如何查看文檔中了解文檔的結(jié)構(gòu)和查找相關(guān)信息方法。
如果你熟悉Python 打包的技術(shù),并且對如何將投票應(yīng)用制作成一個“可重用的應(yīng)用”感興趣,請看高級教程:如何編寫可重用的應(yīng)用。
譯者:Django 文檔協(xié)作翻譯小組,原文:Part 6: Static files。
本文以 CC BY-NC-SA 3.0 協(xié)議發(fā)布,轉(zhuǎn)載請保留作者署名和文章出處。
Django 文檔協(xié)作翻譯小組人手緊缺,有興趣的朋友可以加入我們,完全公益性質(zhì)。交流群:467338606。