前言

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

配置教程

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

    1
    2
    npm install --global gulp-cli #全局安装gulp指令集
    npm install gulp --save #安装gulp插件
  2. 安装各个下属插件以实现对各类静态资源的压缩。

  • 压缩 HTML:

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

    1
    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。

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

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

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

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

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

1
npm install gulp-fontmin --save-dev
  1. 为 Gulp 创建 gulpfile.js 任务脚本。在博客根目录 [Blogroot] 下新建 gulpfile.js, 打开 [Blogroot]\gulpfile.js, 输入以下内容:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
//用到的各个插件
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 压缩任务的相关配置

1
2
3
4
5
6
7
8
9
10
11
12
      //压缩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'))
)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
//用到的各个插件
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'
))
  1. 在每次运行完 hexo generate 生成静态页面后,运行 gulp 对其进行压缩。指令流程如下:

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