/dd

Primary LanguageJavaScriptMIT LicenseMIT

Boom

1、简介

使用gulp搭建一个传统的多页面前端项目的开发环境

  • 支持pug scss es6编译支持
  • 支持开发环境和打包生成sourceMap
  • 支持文件变动自动刷新浏览器，css是热更新（css改动无需刷新浏览器即可更新）
  • 支持新增文件没无需重启gulp，即可改动自动刷新浏览器
  • 支持命令生成雪碧图和对应css
  • 支持eslint，使用的eslint插件是eslint-config-alloy
  • 支持打包html，css，js图片压缩，css中小图片转base64
  • 支持css，js文件版本hash值，文件无变动则版本hash不会改变，更好利用缓存
  • 支持html中的css，js，img路径添加cdn域名前缀，css中的图片链接建议使用相对路径
  • 支持代理，便于跨域调试

2、如何使用

2.1 下载项目

（1）npm install 安装依赖

（2）npm run dev

2.2 命令

npm run dev

进入开发模式

npm run build

打包命令

npm run start

打包并且以dist为根目录开启服务器查看效果

npm run sp

把根目录下的sprites文件夹下的子目录内的所有文件夹中的png和jpg的图片，以子文件夹目录为单位生产雪碧图，文件名为子目录名

在执行完npm run build后执行npm run webp

默认情况下html中的img[src]会被处理成img[data-src]

  • 当img的src为http开头则会被忽略该处理
  • 当img的className中包含not-webp开头则会被忽略该处理

npm run lint

eslint检测

npm run fix

eslint修复

3、 约定的目录

src是源码目录，可以通过config.srcPath进行配置，以下src只目录只是个例子，代表源码目录

3.1 src/static

静态文件目录

3.2 src/static/_vendor

第三方js，css，iconfont等

3.3 src/_scss

scss模块目录，里面的.scss文件不会被单独编译成css文件

3.4src/_pug

pug模块目录，里面的.pug文件不会被单独编译成html文件

4.5 src/_modules

该目录里面的.pug,.scss文件不会被单独编译成html文件

4、功能配置文件

根目录下的config.js

module.exports = {
  srcPath: 'src',
  pug: true,
  scss: true,
  babel: true,
  tmpPath: 'node_modules/__tmp__',
  build: {
    htmlmin: true,
    cssmin: true,
    jsmin: true,
    base64: 10 * 1024, // (bytes) 使用css中图片使用相对路径，否者无效
    cssSourcemap: true,
    jsSourcemap: true,
    cdn: 'http://your/cdn/url/',
    versionHash: true, // 版本hash
  },
  proxyTable: {
    '/api': 'http://localhost:3000',
    '/hehe': {
      target: 'http://localhost:3000',
      pathRewrite: {
        // 地址重写
        '^/hehe': '/api'
      }
    }
  }
}

5、功能配置项详解

如不需要使用某个配置项目，直接将其注释即可

srcPath

配置目录源文件目录，默认为'src'

pug

  • 值为true时，会开启对src目录内所有的.pug文件（除src/_pug/外）编译成html
  • src/_pug作为pug的模块目录，不会被单独编译为html文件

scss

  • 值为true时，会开启对src内所有的.scss,.sass文件（除src/_scss外）编译成scss
  • src/_scss/作为scss的模块目录，不会被单独编译为css文件

babel

  • 值为true时，会开启对src目录内所有的.js文件（除src/static/vendor/外）编译成es5
  • babel配置文件，根目录下.babelrc文件

tmpPath

  • 默认值为 'node_modules/__tmp__'

  • npm run dev作为.pug，.scss，.js文件编译的临时文件目录，和src同为静态文件目录，且优先级高于src目录

    browserSync.init({
    server: {
      baseDir: [config.tmpPath, 'src'],
    },
    middleware,
    port: 9000,
    online: false
  })

  • 编译后文件访问：src/static/public/public.scss在html的访问路径为/static/public/public.css

  • 每次运行npm run dev config.tmpPath都会被清理

打包配置项

config.build 描述
htmlmin 值为true时开启html压缩
cssmin 值为true时开启css压缩
jsmin 值为true时开启js压缩
base64 Number类型，单位（bytes），当css图片大小小于该值时将转base64
css中图片地址必须为相对路径才会生效
cssSourcemap 值为true时，生成cssSourcemap文件
jsSourcemap 值为true时，生成jsSourcemap文件
cdn 值为你的cdn地址
versionHash 值为true时，生成css js文件版本hash值
proxyTable 代理配置，http-proxy-middleware

proxyTable配置实例

  proxyTable: {
    '/api': 'http://localhost:3000',
    '/hehe': {
      target: 'http://localhost:3000',
      pathRewrite: {
        // 地址重写
        '^/hehe': '/api'
      }
    }
  }

6、js中如何判断是否为开发模式

// 当前环境为开发环境
var isDev = !!document.getElementById('__bs_script__')

注意： isDev只能在body标签内的js中这样获取，或者在DOMContenLoaded或load事件回调中初始化 isDev