{% raw %}
# 編寫你的第一個Django應用,第6部分 #
本教程上接教程 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 打包的技術,并且對如何將投票應用制作成一個“可重用的應用”感興趣,請看高級教程:如何編寫可重用的應用。
> 譯者:[Django 文檔協作翻譯小組](http://python.usyiyi.cn/django/index.html),原文:[Part 6: Static files](https://docs.djangoproject.com/en/1.8/intro/tutorial06/)。
>
> 本文以 [CC BY-NC-SA 3.0](http://creativecommons.org/licenses/by-nc-sa/3.0/cn/) 協議發布,轉載請保留作者署名和文章出處。
>
> [Django 文檔協作翻譯小組](http://python.usyiyi.cn/django/index.html)人手緊缺,有興趣的朋友可以加入我們,完全公益性質。交流群:467338606。
{% endraw %}
- 新手入門
- 從零開始
- 概覽
- 安裝
- 教程
- 第1部分:模型
- 第2部分:管理站點
- 第3部分:視圖和模板
- 第4部分:表單和通用視圖
- 第5部分:測試
- 第6部分:靜態文件
- 高級教程
- 如何編寫可重用的應用
- 為Django編寫首個補丁
- 模型層
- 模型
- 模型語法
- 元選項
- 模型類
- 查詢集
- 執行查詢
- 查找表達式
- 模型的實例
- 實例方法
- 訪問關聯對象
- 遷移
- 模式編輯器
- 編寫遷移
- 高級
- 管理器
- 原始的SQL查詢
- 聚合
- 多數據庫
- 自定義查找
- 條件表達式
- 數據庫函數
- 其它
- 遺留的數據庫
- 提供初始數據
- 優化數據庫訪問
- 視圖層
- 基礎
- URL配置
- 視圖函數
- 快捷函數
- 裝飾器
- 參考
- 內建的視圖
- TemplateResponse 對象
- 文件上傳
- 概覽
- File 對象
- 儲存API
- 管理文件
- 自定義存儲
- 基于類的視圖
- 概覽
- 內建顯示視圖
- 內建編輯視圖
- API參考
- 分類索引
- 高級
- 生成 CSV
- 生成 PDF
- 中間件
- 概覽
- 內建的中間件類
- 模板層
- 基礎
- 面向設計師
- 語言概覽
- 人性化
- 面向程序員
- 表單
- 基礎
- 概覽
- 表單API
- 內建的Widget
- 高級
- 整合媒體
- 開發過程
- 設置
- 概覽
- 應用程序
- 異常
- 概覽
- django-admin 和 manage.py
- 添加自定義的命令
- 測試
- 介紹
- 部署
- 概述
- WSGI服務器
- 部署靜態文件
- 通過email追蹤代碼錯誤
- Admin
- 管理操作
- 管理文檔生成器
- 安全
- 安全概述
- 說明Django中的安全問題
- 點擊劫持保護
- 加密簽名
- 國際化和本地化
- 概述
- 本地化WEB UI格式化輸入
- “本地特色”
- 常見的網站應用工具
- 認證
- 概覽
- 使用認證系統
- 密碼管理
- 日志
- 分頁
- 會話
- 數據驗證
- 其它核心功能
- 按需內容處理
- 重定向
- 信號
- 系統檢查框架