Django Media Bundler 项目下载及安装教程

1. 项目介绍

Django Media Bundler 是一个用于 Django 应用的插件，旨在帮助开发者在生产环境中打包 JavaScript、CSS 和图标，同时在开发环境中保持易于调试的特性。该插件通过描述媒体文件的组合方式，自动将这些文件打包并优化，支持 JavaScript 和 CSS 的合并与压缩，以及图标的精灵化处理。

2. 项目下载位置

Django Media Bundler 项目托管在 GitHub 上，可以通过以下命令进行克隆下载：

git clone https://github.com/rnk/django-media-bundler.git

3. 项目安装环境配置

3.1 Python 环境

Django Media Bundler 需要 Python 2.5 及以上版本。确保你的系统中已经安装了 Python。

3.2 依赖库

• Python Imaging Library (PIL)：用于处理图像精灵化。在 Ubuntu 系统中，可以通过以下命令安装：

  sudo apt-get install python-imaging
  

• pngcrush：用于优化生成的 PNG 图像。可以通过以下命令安装：

  sudo apt-get install pngcrush
  

3.3 环境配置示例

以下是一个简单的环境配置示例：

# 安装 Python Imaging Library
sudo apt-get install python-imaging

# 安装 pngcrush
sudo apt-get install pngcrush

4. 项目安装方式

4.1 克隆项目

首先，克隆项目到本地：

git clone https://github.com/rnk/django-media-bundler.git

4.2 配置 Django 项目

将克隆下来的项目放置在 Django 项目的 PYTHONPATH 中，并在 settings.py 文件中添加 django-media-bundler 到 INSTALLED_APPS：

INSTALLED_APPS = [
    ...
    'media_bundler',
    ...
]

5. 项目处理脚本

5.1 配置媒体文件

在 settings.py 中配置需要打包的 JavaScript 和 CSS 文件：

MEDIA_BUNDLES = (
    {
        "type": "javascript",
        "name": "myapp_scripts",
        "path": MEDIA_ROOT + "/scripts/",
        "url": MEDIA_URL + "/scripts/",
        "minify": True,
        "files": (
            "foo.js",
            "bar.js",
            "baz.js",
        )
    },
    {
        "type": "css",
        "name": "myapp_styles",
        "path": MEDIA_ROOT + "/styles/",
        "url": MEDIA_URL + "/styles/",
        "minify": True,
        "files": (
            "foo.css",
            "bar.css",
            "baz.css",
            "myapp-sprites.css",
        )
    },
    {
        "type": "png-sprite",
        "name": "myapp_sprites",
        "path": MEDIA_ROOT + "/images/",
        "url": MEDIA_URL + "/images/",
        "css_file": MEDIA_ROOT + "/styles/myapp-sprites.css",
        "files": (
            "foo.png",
            "bar.png",
            "baz.png",
        )
    },
)

5.2 运行打包命令

在项目根目录下运行以下命令来打包媒体文件：

python manage.py bundle_media

5.3 在模板中使用

在 Django 模板中，使用以下标签来加载打包后的文件：

{% load bundler_tags %}

<!-- 加载单个 JavaScript 文件 -->
{% javascript "myapp_scripts" "foo.js" %}

<!-- 加载单个 CSS 文件 -->
{% css "myapp_styles" "foo.css" %}

<!-- 加载整个 JavaScript 包 -->
{% load_bundle "myapp_scripts" %}

<!-- 加载整个 CSS 包 -->
{% load_bundle "myapp_styles" %}

总结

通过以上步骤，你可以成功下载并安装 Django Media Bundler 项目，并将其集成到你的 Django 应用中，实现 JavaScript、CSS 和图标的打包与优化。