Jun 3, 2011

Django 文件,静态文件设置

django 关注的是网页应用的动态部分(model, view, template),对于静态部分,最好使用专门的服务器
django 也可以 server 静态内容,但是一般是在开发阶段
我觉得如果是小型 web app,和应用无关的静态文件(图片,css, js 等),可以用 django 来 serve


一个网站除了 Html 文件,还有其他文件

  1. 一个完整的页面所需的静态文件,如图片, css, js 等
  2. 和应用有关的静态文件(图片,音乐,视频)等
  3. 用户上传的文件,这个和 2 可能有重叠
无论哪种,jdango 都在其 URL 和实际路径间做了一个映射(区分 URL 和 DIR)
比如如下映射
URL前缀           DIR前缀
/media/               /user/path/
假设网站域名为 http://some.com/
则用户请求
http://some.com/media/img/cat.jpg
Django 就知道对应的文件为
/user/path/img/cat.jpg

反之,对于模型中的文件名 /img/cat.jpg
Django 写入 Html 中时也会改变为
/media/img/cat.jpg

而对于许多不同映射,其 url 前缀不能相同
否则就会出现一个url映射到不同一方
比如 MEDIA_URL 不能和 ADMIN_MEDIA_PREFIX 相同

Django 1.3 版本之前的

1. 接下来先说第一类,一个完整的页面所需的静态文件,如图片, css, js 等。它又分为两种
  • admin (django 管理)专门的静态文件
  • 其他页面专门的静态文件
和 admin 相关的设置是
ADMIN_MEDIA_PREFIX  映射的 URL 部分
一般
ADMIN_MEDIA_PREFIX  = '/media/'
而 django 自己知道 django.contrib.admin 的安装位置,故而不需要设置映射的路径部分

另一种,其他页面专门的静态文件

STATIC_DOC_ROOT = '/path/to/media'
urls.py:
from django.conf import settings
...
(r'^site_media/(?P.*)$', 'django.views.static.serve',
        {'document_root': settings.STATIC_DOC_ROOT}),
如映射为
/site_media/       ->   STATIC_DOC_ROOT
最终在 Html 文件中,css 文件为
/site_media/css/head.css
实际路径为 STATIC_DOC_ROOT/css/head.css



2. 和应用有关的静态文件(图片,音乐,视频)等
3. 用户上传的数据

数据模型中有文件,图片等,数据库中只保存文件的路径,不保存具体文件
通过设置

# Absolute path to the directory that holds media.
# Example: "/home/media/media.lawrence.com/"
映射的路径部分
MEDIA_ROOT = STATIC_DOC_ROOT = os.path.join(os.path.dirname(__file__),'upload').replace('\\','/')


# URL that handles the media served from MEDIA_ROOT. Make sure to use a
# trailing slash if there is a path component (optional in other cases).
# Examples: "http://media.lawrence.com", "http://example.com/media/"
映射的 url 前缀
MEDIA_URL = '/user/'

http://some.com/user/car/bmw.jpg
映射为
MEDIA_ROOT/car/bmw.jpg
而数据库只保存
car/bmw.jpg

Django 1.3 版本

Managing static files
Using django.contrib.staticfiles

各个应用的静态文件放在自己的 static 目录下,全局的静态文件放在 STATICFILES_DIRS 中。
用户上传的文件放在 MEDIA_ROOT 中。
# Absolute filesystem path to the directory that will hold user-uploaded files.
# Example: "/home/media/media.lawrence.com/media/"
MEDIA_ROOT = os.path.join(os.path.dirname(__file__),'upload').replace('\\','/')

# URL that handles the media served from MEDIA_ROOT. Make sure to use a
# trailing slash.
# Examples: "http://media.lawrence.com/media/", "http://example.com/media/"
MEDIA_URL = '/user/'

# Absolute path to the directory static files should be collected to.
# Don't put anything in this directory yourself; store your static files
# in apps' "static/" subdirectories and in STATICFILES_DIRS.
# Example: "/home/media/media.lawrence.com/static/"
STATIC_ROOT = os.path.join(os.path.dirname(__file__),'static').replace('\\','/')

# URL prefix for static files.
# Example: "http://media.lawrence.com/static/"
STATIC_URL = '/static/'

# URL prefix for admin static files -- CSS, JavaScript and images.
# Make sure to use a trailing slash.
# Examples: "http://foo.com/static/admin/", "/static/admin/".
ADMIN_MEDIA_PREFIX = '/static/admin/'

# Additional locations of static files
STATICFILES_DIRS = (
    # Put strings here, like "/home/html/static" or "C:/www/django/static".
    # Always use forward slashes, even on Windows.
    # Don't forget to use absolute paths, not relative paths.
    os.path.join(os.path.dirname(__file__),'site_media').replace('\\','/'),
)

0 comments: