soundasleep/asset-discovery

此包的最新版本(0.1.1)没有可用的许可信息。

0.1.1 2014-12-15 23:15 UTC

This package is auto-updated.

Last update: 2024-09-14 10:08:42 UTC


README

asset-discovery 是一个启用Composer的PHP脚本,用于在多个PHP组件中定位资源(JS、CSS、Coffee、SASS、图片),然后可以自动将其复制到生成的样式表、脚本和图片文件夹中。

基于 component-discovery

配置

首先将 asset-discovery 包作为项目 composer.json 中的需求,并运行 composer update 将其安装到项目中

{
  "require": {
    "soundasleep/asset-discovery": "dev-master"
  }
}

现在在您的项目中创建一个 asset-discovery.json,以定义要发现的资源类型以及放置源文件的位置

{
  "src": ["vendor/*/*", "core"],
  "js": "site/generated/js/generated.js",
  "coffee": "site/generated/js/generated-coffee.coffee",
  "css": "site/generated/css/generated.css",
  "scss": "site/generated/css/generated-scss.scss",
  "images": "site/generated/images/"
}

asset-discovery 将在所有 src 文件夹中查找名为 assets.json 的文件以找到匹配的资源。支持通配符。例如,在您的 vendor/my/package/assets.json

{
  "scss": ["css/currencies.scss", "css/second.scss"],
  "coffee": ["js/*.coffee"],
  "images": ["images/*"]
}

除了图片以外的生成资源文件将按照指定的源顺序包含。

构建

运行生成脚本,无论是与您的构建脚本一起还是手动,提供一个给定的根目录

php -f vendor/soundasleep/asset-discovery/generate.php .

这将根据您的 asset-discovery.json 配置文件中的目录生成各种文件。然后可以将这些文件传递到构建链的下一步(例如,将SASS编译成CSS,压缩,精灵化,优化图片等)。

待办事项

  1. 实际上在Packagist上发布
  2. 更多文档,特别是默认的 asset-discovery.json 参数
  3. 测试
  4. 使用 asset-discovery 的示例项目
  5. 创建 grunt 任务 grunt-php-asset-discovery 以包装手动PHP命令
  6. 发布0.1版本