a_tool_config.md

配置文档

每一个项目的根目录都有一个独立的config.json配置文件，其详细配置如下：

• "projectPath": null - 【常用】工程目录前缀

• "cssDir": "css" - css文件夹名称

• "imagesDir": "css/i" - images文件夹名称

• "jsDir": "js" - js文件夹名称

• "htmlDir": "html" - html文件夹名称

• "widgetDir": "widget" - widget文件夹名称

• "outputDirName": "build" - 输出文件夹名称

• "outputCustom": "" - 自定义输出文件夹，以逗号分隔的字符串

• "cdn": "//misc.360buyimg.com" - 【常用】静态cdn域名

• "serverDir": "misc.360buyimg.com" - 上传至远端服务器文件夹的名称

• "previewServerDir": "page.jd.com" - html文件夹上传至服务器所在的文件夹名称

• "widgetServerDir": "jdfwidget.jd.com" - widget服务器所在的文件夹名称

• "widgetOutputName": "widget" - 全局widgetOutputName名称

• "widgetOutputMode": 1 - 编译全局wigetOutputName模式，共三种：1: all widgets|2: white list|3: black list

• "widgetWhiteList": [] - 指定白名单，在widgetOutputMode=2时，输出这个列表内容到widget.js/widget.css中

• "widgetBlackList": [] - 指定黑名单，在widgetOutputMode=3时，排除这个列表的widget

• "widgetNesting": true - widget嵌套功能开关，默认开启

• "localServerPort": 80 - 【常用】本地服务器端口

• "build"

  • "jsPlace": "insertBody" - 调试时js文件位置 insertHead|insertBody

  • "livereload":true - 是否开启liveload

  • "sass":true - 是否开启sass编译

  • "less":true - 是否开启less编译

  • "csslint": false - 是否开启csslint

• "upload"

  • "type": "http" - 默认 ftp scp http
  • "host": null - 服务器的域名或者ip
  • "user": null - 上传时使用的用户名, ftp、scp需要，http不需要
  • "password": null - 规则同上
  • "port": null - 传输端口，ftp默认21，scp默认22，http默认3000
  • "rootPrefix": "/var/www/html/" - scp时传输的目录前缀，用来确认上传文件最终的地址，一个文件最终的地址会是rootPrefix + serverDir + projectPath + filePath，你可以根据自身server的配置来修改这个值

• "output"

  • "cssImagesUrlReplace": true - css中图片url加cdn替换

  • "linkReplace": true - 给link.href添加cdn前缀，v3.3.0版本新增，之前由jsUrlReplace参数控制link.href添加cdn

  • "jsUrlReplace": false - js文件的id和dependences是否添加cdn前缀

  • "jsPlace": "insertBody" - 编译后js文件位置 insertHead|insertBody

  • "cssCombo": true - 【常用】css进行combo

  • "jsCombo": true - 【常用】js进行combo todo

  • "hasBanner": true - 是否给js文件，css文件添加banner时间戳

  • "compressJs":true - 【常用】是否开启压缩js文件

  • "compressCss":true - 【常用】是否开启压缩css文件

  • "compressImage":true - 【常用】是否开启压缩图片

  • "cssSprite":true - 是否开启css sprite功能

  • "cssSpriteMode": 1 - 0: 将所有css文件中的背景图合并成一张sprite图片，1: 将每一个widget中的背景图分别合并成一张图片

  • "cssSpriteMargin": 10 - css sprite图片之间的间距

  • "cssSpriteDirection": vertical - vertical：垂直合并，horizontal：水平合并

  • "cssAutoPrefixer": true - 【常用】是否自动删除过时的浏览器css前缀，如-webkit-box-orient: vertical;

  • "browserslist": ["last 2 version", "> 0.2%", "ie > 7"] - 【常用】配置autoprefixer的browserslist。

  • "base64": false - 是否对图片进行base64编码

  • "webp":false - 是否生成对应的webp图片

  • "excludeFiles": "" - 【常用】想要直接忽略的文件/文件夹，以逗号分隔的字符串："test,build"

• "babel" - 默认只启用基本转义(3.4.10及之前preset-es2015，之后为preset-env)，您也可以在项目根目录下新建一个.babelrc文件独立配置

  • "presets": []
  • "plugins": []