README

在Symfony2环境中轻松管理你的精灵图

安装

依赖

要使此扩展包正常工作，您必须安装[Glue] (http://glue.readthedocs.org/en/latest/)

获取扩展包

在您的composer.json文件中添加以下内容

{
	"require": {
		"sphax/sprite-bundle": "dev-master@dev"
	}
}

然后运行

php composer.phar update

或

composer update

如果您已全局安装composer。

将类添加到您的Kernel

new SphaxSprite\SphaxSpriteBundle(),

配置

您需要通过在您的`config.yml`文件中放置以下行来配置精灵图

最小配置

sphax_sprite:
    sprite:
        spritename:
            sourceSpriteImage: "%kernel.root_dir%/../web/imp/sprites/spritename/"
            outputSpriteImage: "%kernel.root_dir%/../web/img/sprites/"
        another_spritename:
            sourceSpriteImage: "%kernel.root_dir%/../web/img/sprites/another/"
            outputSpriteImage: "%kernel.root_dir%/../web/img/sprites/"

完整配置（包含默认值）

        spritename:
            nameBin: 'glue'
            sourceSpriteImage: "%kernel.root_dir%/../web/imp/sprites/spritename/"
            outputSpriteImage: "%kernel.root_dir%/../web/img/sprites/"
            force: false # erase old generated files
            options: 
                optipng: true
                cachebuster: true
                less: false
                namespace: "sprite" 
                separator: "-"

生成精灵图

生成所有精灵图

$ php app/console sphax:sprite:generate

生成单个精灵图

$ php app/console sphax:sprite:generate spritename

在模板中使用

现在您需要将生成的文件集成到模板中。示例

{% block stylesheets %}
    {% stylesheets
        "img/sprite/*.css"
        output="css/sprite.css"
    %}
        <link rel="stylesheet" type="text/css" href="{{ asset_url }}" />
    {% endstylesheets %}
{% endblock %}