django課堂(5)靜態文件

除了由服務器生成的HTML文件外,網頁應用一般需要提供其它必要的文件 —— 比如圖片文件、JavaScript腳本和CSS樣式表 —— 來爲用戶呈現出一個完整的網站。 在Django中,我們將這些文件稱爲“靜態文件”。

對於小型項目,這不是個大問題,因爲你可以將它們放在你的網頁服務器可以訪問到的地方。 然而,在大一點的項目中 —— 尤其是那些由多個應用組成的項目 —— 處理每個應用提供的多個靜態文件集合開始變得很難。

這正是django.contrib.staticfiles的用途:它收集每個應用(和任何你指定的地方)的靜態文件到一個單獨的位置,這個位置在線上可以很容易維護。

自定義你的應用的外觀

首先在你的polls中創建一個static目錄。Django將在那裏查找靜態文件,這與Django在polls/templates/中尋找對應的模板文件的方式是一致的。

Django 的 STATICFILES_FINDERS 設置包含一個查找器列表,它們知道如何從各種源找到靜態文件。 其中默認的一個是AppDirectoriesFinder,它在每個INSTALLED_APPS下查找“static”子目錄,就像剛剛在polls中創建的一樣。管理站點也爲它的靜態文件使用相同的目錄結構。

在你剛剛創建的static目錄中,創建另外一個目錄polls並在它下面創建一個文件style.css換句話講,你的樣式表應該位於polls/static/polls/style.css因爲AppDirectoriesFinder 靜態文件查找器的工作方式,你可以通過polls/style.css在Django中訪問這個靜態文件,與你如何訪問模板的路徑類似。

靜態文件的命名空間

與模板類似,我們可以將靜態文件直接放在polls/static(而不是創建另外一個polls 子目錄),但實際上這是一個壞主意。Django將使用它所找到的第一個符合要求的靜態文件的文件名,如果在你的不同應用中存在兩個同名的靜態文件,Django將無法區分它們。我們需要告訴Django該使用其中的哪一個,最簡單的方法就是爲它們添加命名空間。 也就是說,將這些靜態文件放進以它們所在的應用的名字命名的另外一個目錄下。 

將下面的代碼放入樣式表中 (polls/static/polls/style.css):

polls/static/polls/style.css

li a {
    color: green;}

下一步,在polls/templates/polls/index.html的頂端添加如下內容 :

polls/templates/polls/index.html

{% load staticfiles %}<link rel="stylesheet" type="text/css" href="{% static 'polls/style.css' %}" />

{% load staticfiles %} 從staticfiles模板庫加載{% static %} 模板標籤。{% static %}模板標籤會生成靜態文件的絕對URL。

這就是你在開發過程中所需要對靜態文件做的所有處理。 重新加載http://localhost:8000/polls/,你應該會看到Question的超鏈接變成了綠色(Django的風格!),這意味着你的樣式表被成功導入。

添加一張背景圖片

下一步,我們將創建一個子目錄來存放圖片。 polls/static/polls/目錄中創建一個 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/,你應該在屏幕的右下方看到載入的背景圖片。

警告:

當然,{% static %}模板標籤不能用在靜態文件(比如樣式表)中,因爲他們不是由Django生成的。 你應該永遠使用相對路徑來相互鏈接靜態文件,因爲這樣你可以改變STATIC_URL ( static模板標籤用它來生成URLs)而不用同時修改一大堆靜態文件的路徑。

這裏有些基礎需要了解。關於靜態文件設置的更多細節和框架中包含的其它部分,參見靜態文件 howto 和靜態文件參考部署靜態文件討論如何在真實的服務器上使用靜態文件。

下一步?

新手教程到此結束。 在這期間,你可能想要在如何查看文檔中瞭解文檔的結構和查找相關信息方法。

如果你熟悉Python 打包的技術,並且對如何將投票應用製作成一個“可重用的應用”感興趣,請看高級教程:如何編寫可重用的應用


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章