点击查看更新记录

更新记录

2022-01-19: 文本迁移

  1. 将gulp内容从合集迁移至独立文章
  2. 新增字体压缩相关内容
点击查看参考教程
参考方向教程原贴
gulp官方文档,用于查找API用法及查看已收录的gulp插件gulp.js中文文档
参考了Gulp压缩的基本方案Butterfly主题文档-Gulp压缩
参考了gulp的优化方案卓越科技-如何优化博客
参考了小魏找到的字体压缩方案小魏-fontmin&&hexo 字体压缩
gulp-fontmin的使用文档gulp-fontmin

写在最前

gulp能够帮助用户自动压缩静态资源,配合各类下属插件,能够压缩包括css、js、html乃至各类格式的图片文件。(图片文件的压缩往往只能节省几十KB,效果远远不如imagine、tinypng等压缩方式,所以此处不再写使用gulp压缩图片的内容)。

配置教程

  1. 安装Gulp插件:在博客根目录[Blogroot]打开终端,输入:

    npm install --global gulp-cli #全局安装gulp指令集
    npm install gulp --save #安装gulp插件
  2. 安装各个下属插件以实现对各类静态资源的压缩。在此高呼卓越科技NB!

    • 压缩HTML:

      npm install gulp-htmlclean --save-dev
      npm install gulp-html-minifier-terser --save-dev
      # 用gulp-html-minifier-terser可以压缩HTML中的ES6语法
    • 压缩CSS:

      npm install gulp-clean-css --save-dev
    • 压缩JS

      Butterfly主题文档提供了两种压缩JS的插件方案。两者的差别在于terser是ES6+的JavaScript解析器,而gulp-babel是一个JavaScript转换编译器,可以把ES6转换成ES5,两种方案都有效。但使用上各有利弊。考虑到目前的浏览器市场占有率,更加建议各位使用terser来压缩js。

      方案一:为了适配绝大多数浏览器(IE:就是老子),可以将ES6语法降为ES5语法。则使用gulp-babel,这一方案在压缩部分使用了ES6的js以后,由于强制降级导致变量生命周期的变动,会引发一系列迷之bug,需要手动再去添加屏蔽项以选择不压缩对应的js。

      npm install gulp-uglify --save-dev
      npm install gulp-babel @babel/core @babel/preset-env --save-dev

      方案二(更加推荐):gulp-terser只会直接压缩js代码,所以不存在因为语法变动导致的错误 。事实上,当我们使用jsdelivrCDN服务时,只需要在css或者js的后缀前添加.min,例如example.js->example.min.js,JsDelivr就会自动使用terser帮我们压缩好代码。

      npm install gulp-terser --save-dev
    • 压缩字体包

      字体文件作为最让人又爱又恨的静态资源,为了保证站点文字匹配,全字库字体包往往超过15MB,这对博客的加载速度造成了巨大压力。fontmin可以遍历博客内用到的字符,并将字体包内这些字符的字体样式提取出来输出为新的字体包。

      font-min仅支持压缩ttf格式的字体包

      npm install gulp-fontmin --save-dev
  3. 为Gulp创建gulpfile.js任务脚本。在博客根目录[Blogroot]下新建gulpfile.js,打开[Blogroot]\gulpfile.js,输入以下内容:

    //用到的各个插件
    var gulp = require('gulp');
    var cleanCSS = require('gulp-clean-css');
    var htmlmin = require('gulp-html-minifier-terser');
    var htmlclean = require('gulp-htmlclean');
    var fontmin = require('gulp-fontmin');
    var uglify = require('gulp-uglify')
    var babel = require('gulp-babel')
    //压缩js
    gulp.task('compress', () =>
    gulp.src(['./public/**/*.js', '!./public/**/*.min.js'])
    .pipe(babel({
    presets: ['@babel/preset-env']
    }))
    .pipe(uglify().on('error', function (e) {
    console.log(e)
    }))
    .pipe(gulp.dest('./public'))
    )
    //压缩css
    gulp.task('minify-css', () => {
    return gulp.src(['./public/**/*.css'])
    .pipe(cleanCSS({
    compatibility: 'ie11'
    }))
    .pipe(gulp.dest('./public'));
    });
    //压缩html
    gulp.task('minify-html', () => {
    return gulp.src('./public/**/*.html')
    .pipe(htmlclean())
    .pipe(htmlmin({
    removeComments: true, //清除html注释
    collapseWhitespace: true, //压缩html
    collapseBooleanAttributes: true,
    //省略布尔属性的值,例如:<input checked="true"/> ==> <input />
    removeEmptyAttributes: true,
    //删除所有空格作属性值,例如:<input id="" /> ==> <input />
    removeScriptTypeAttributes: true,
    //删除<script>的type="text/javascript"
    removeStyleLinkTypeAttributes: true,
    //删除<style>和<link>的 type="text/css"
    minifyJS: true, //压缩页面 JS
    minifyCSS: true, //压缩页面 CSS
    minifyURLs: true //压缩页面URL
    }))
    .pipe(gulp.dest('./public'))
    });
    //压缩字体
    function minifyFont(text, cb) {
    gulp
    .src('./public/fonts/*.ttf') //原字体所在目录
    .pipe(fontmin({
    text: text
    }))
    .pipe(gulp.dest('./public/fontsdest/')) //压缩后的输出目录
    .on('end', cb);
    }

    gulp.task('mini-font', (cb) => {
    var buffers = [];
    gulp
    .src(['./public/**/*.html']) //HTML文件所在目录请根据自身情况修改
    .on('data', function(file) {
    buffers.push(file.contents);
    })
    .on('end', function() {
    var text = Buffer.concat(buffers).toString('utf-8');
    minifyFont(text, cb);
    });
    });
    // 运行gulp命令时依次执行以下任务
    gulp.task('default', gulp.parallel(
    'compress', 'minify-css', 'minify-html','mini-font'
    ))

    可能出现的bug,毕竟是bug御三家,没点bug都不好意思出来混
    部分js经过gulp-babel的压缩加密后,因为一些变量的生命周期变化,可能无法正常使用,报错一般为提示该js中的某个变量未被声明。最快的解决方案就是干脆不要压缩它,对它设置压缩屏蔽。(terser就不会有这问题)


    此处举例,假设使用gulp压缩后,位于/source/js/example.js无法正常使用。则在[Blogroot]\gulpfile.js中修改js压缩任务的相关配置

          //压缩js
    gulp.task('compress', () =>
    - gulp.src(['./public/**/*.js', '!./public/**/*.min.js'])
    + gulp.src(['./public/**/*.js', '!./public/**/*.min.js','!./public/js/example.js'])
    .pipe(babel({
    presets: ['@babel/preset-env']
    }))
    .pipe(uglify().on('error', function (e) {
    console.log(e)
    }))
    .pipe(gulp.dest('./public'))
    )
    //用到的各个插件
    var gulp = require('gulp');
    var cleanCSS = require('gulp-clean-css');
    var htmlmin = require('gulp-html-minifier-terser');
    var htmlclean = require('gulp-htmlclean');
    var fontmin = require('gulp-fontmin');
    // gulp-tester
    var terser = require('gulp-terser');
    // 压缩js
    gulp.task('compress', () =>
    gulp.src(['./public/**/*.js', '!./public/**/*.min.js'])
    .pipe(terser())
    .pipe(gulp.dest('./public'))
    )
    //压缩css
    gulp.task('minify-css', () => {
    return gulp.src(['./public/**/*.css'])
    .pipe(cleanCSS({
    compatibility: 'ie11'
    }))
    .pipe(gulp.dest('./public'));
    });
    //压缩html
    gulp.task('minify-html', () => {
    return gulp.src('./public/**/*.html')
    .pipe(htmlclean())
    .pipe(htmlmin({
    removeComments: true, //清除html注释
    collapseWhitespace: true, //压缩html
    collapseBooleanAttributes: true,
    //省略布尔属性的值,例如:<input checked="true"/> ==> <input />
    removeEmptyAttributes: true,
    //删除所有空格作属性值,例如:<input id="" /> ==> <input />
    removeScriptTypeAttributes: true,
    //删除<script>的type="text/javascript"
    removeStyleLinkTypeAttributes: true,
    //删除<style>和<link>的 type="text/css"
    minifyJS: true, //压缩页面 JS
    minifyCSS: true, //压缩页面 CSS
    minifyURLs: true //压缩页面URL
    }))
    .pipe(gulp.dest('./public'))
    });
    //压缩字体
    function minifyFont(text, cb) {
    gulp
    .src('./public/fonts/*.ttf') //原字体所在目录
    .pipe(fontmin({
    text: text
    }))
    .pipe(gulp.dest('./public/fontsdest/')) //压缩后的输出目录
    .on('end', cb);
    }

    gulp.task('mini-font', (cb) => {
    var buffers = [];
    gulp
    .src(['./public/**/*.html']) //HTML文件所在目录请根据自身情况修改
    .on('data', function(file) {
    buffers.push(file.contents);
    })
    .on('end', function() {
    var text = Buffer.concat(buffers).toString('utf-8');
    minifyFont(text, cb);
    });
    });
    // 运行gulp命令时依次执行以下任务
    gulp.task('default', gulp.parallel(
    'compress', 'minify-css', 'minify-html','mini-font'
    ))
  4. 在每次运行完hexo generate生成静态页面后,运行gulp对其进行压缩。指令流程如下:

    hexo clean
    hexo generate
    gulp
    hexo server 或 hexo deploy
  5. 关于font-min的补充说明,在本文中,是通过读取所有编译好的html文件(./public/**/*.html)中的字符,然后匹配原有字体包内./public/fonts/*.ttf字体样式,输出压缩后的字体包到./public/fontsdest/目录。所以最终引用字体的相对路径应该是/fontsdest/*.ttf。而本地测试时,如果没有运行gulp,自然也就不会输出压缩字体包到public目录,也就看不到字体样式。