创建你的第一个 Django 项目， 第六部分

这一篇从 第五部分（zh）结尾的地方继续讲起。我们已经为投票程序编写了测试，而现在我们要为它加上样式和图片。

除了服务端生成的 HTML 以外，网络应用通常需要一些其他的文件 —— 比如图片，脚本和样式表 —— 来帮助渲染网络页面。在 Django 中，我们把这些文件统称为“静态文件”。

对于小项目来说，这个问题没什么大不了的，因为你可以把这些静态文件随便放在哪，只要服务程序能够找到它们就行。然而在大项目 —— 特别是由好几个应用组成的大项目中，处理不同应用所需要的静态文件的工作就显得有点麻烦了。

这就是 django.contrib.staticfiles 存在的意义：它将各个应用的静态文件（和一些你指明的目录里的文件）统一收集起来，这样一来，在生产环境中，这些文件就会集中在一个便于分发的地方。

自定义应用的界面和风格

首先，在 polls 目录下创建一个 static 目录。 Django 将会从这里收集静态文件，就像 Django 在 polls/templates 里寻找模板一样。

Django 的 STATICFILES_FINDERS 设置项是一个列表，它包含了若干个知道如何从不同地点寻找静态文件的搜寻器。其中之一是 AppDirectoriesFinder，它会从 INSTALLED_APPS 中各个应用的 “static” 子目录中寻找文件，比如刚刚创建的 polls/static。 之前的管理页面也使用了相同的目录结构来管理静态文件。

在刚创建的 static 目录下创建一个 polls 目录，再在其中新建文件 style.css。也就是说，你的样式文件的位置是 polls/static/polls/style.css。由于 AppDirectoriesFinder 的存在，你可以在 Django 中使用 polls/style.css 来引用这个文件，就像我们引用模板文件那样。

静态文件命名空间

和模板一样，虽然我们可以直接把样式表放在 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 static %}

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

{% static %} 语句会把对静态文件的引用转化为绝对地址。

这就是你需要做的所有工作了。现在重新载入 http://localhost:8000/polls/，你会看到问题链接变成了绿色（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 生成的。在静态文件中，你应该使用 相对路径（relative paths）来互相引用。因为这样的话，你可以通过改变 STATIC_URL（static 模块用它来生成 URL）达到改变静态文件地址的目的，而不需要在大量的文件中逐一修改引用文件的地址。

这些都只是 基础（basics）。关于静态文件的各种设置，和框架中其余和静态文件有关的部分，请参考 the static files howto 和 the staticfiles reference。另外，Deploying static files 讨论了在真实的服务器上组织静态文件的方法。

如果你明白静态文件，来阅读 教程第七部分（zh） 学习如何自定义 Django 自动生成的管理站点吧！