README

为 Magento 2 新建的 gulpfile

安装

1. 更新您的 composer.json 文件

“require-dev”: {
	...
	“antoniocarboni/magento2-gulp”:"2.0.*”
},

 "repositories": [
    { "type": "vcs", "url":  "https://github.com/magenio-it/magento2-gulp" }
    ],
    

1. 运行 composer update
2. 安装 node.js
3. 将 package.gulp.json.sample 重命名为 package.json
4. 运行 npm install
5. 使用 npm install -g gulp-cli 全局安装 gulp
6. 在 dev/gulp-configs.js 中定义您的 gulp 配置，使用文件样本 gulp-configs.sample.js

configs.js 结构

此 gulpfile 的 gulp-configs.js 文件有一些选项

选项

• debug: 启用详细模式（true/false）
• liveReload: 启用 LiveReload 插件（true/false）
• browsersync: 启用 Browsersync 插件（true/false）
• cache-disable: 在开发者模式下默认禁用缓存

less

• sourcemap: 在 less 编译期间创建 sourcemap（true/false）
• singletheme: 如果设置，less 任务将只监视指定的主题以加快编译速度

监视

supwatch

• extensionPermitted: 检查创建 pub/static 目录符号链接的特定扩展
• folderCustomTheme: 定制主题所在的目录。目前 superwatch 只能同时处理一个定制主题。使用 'app' 作为 app/design/ 中的定制主题，或者使用 'Vendorname/themename' 作为由 composer 管理的定制主题
• notifyAll: 通知不需要符号链接在 pub/static 的文件更改
• notifyExt: 为通知添加特定的文件扩展名过滤器

执行

• enableDefaultTask: 如果设置，任务 deploy 不带参数使用默认任务集（true/false）
• defaultTask: 如果启用 enableDefaultTask，将运行的默认任务
• staticFolderToClear: 在部署源主题之前清除 pub/static 主题的完整路径。

browsersync

有关更多信息及所有配置，请访问 https://browsersync.io/docs

任务列表

• prepare-dev: 设置开发者模式并禁用缓存
• default: 运行 less 任务
• less: 编译 LESS 文件。参数
• • --[nometema]: 仅针对特定主题编译
• watch: 监视文件更改并运行处理任务和/或浏览器同步重新加载
• • --[nometema]: 仅监视特定主题
• superwatch: 监视 less 文件并在 pub/static 上自动创建和删除符号链接，而无需运行 'exec' 命令
• browser-sync: 重新加载浏览器页面
• exec: 执行 dev:source-theme:deploy 命令
• cache-disable: 禁用特定缓存
• cache-clear：清除Magento2缓存
• developer：将Magento2设置为开发者模式