使用gulp压缩博客静态资源
本文是转载文章,参考自Akilar
点击查看参考教程
参考方向 | 教程原贴 |
---|---|
gulp官方文档,用于查找API用法及查看已收录的gulp插件 | gulp.js中文文档 |
参考了Gulp压缩的基本方案 | Butterfly主题文档-Gulp压缩 |
参考了gulp的优化方案 | 卓越科技-如何优化博客 |
参考了小魏找到的字体压缩方案 | 小魏-fontmin&&hexo 字体压缩 |
gulp-fontmin的使用文档 | gulp-fontmin |
写在最前
gulp
能够帮助用户自动压缩静态资源,配合各类下属插件,能够压缩包括css
、js
、html
乃至各类格式的图片文件。(图片文件的压缩往往只能节省几十KB,效果远远不如imagine、tinypng等压缩方式,所以此处不再写使用gulp压缩图片的内容)。
配置教程
安装Gulp插件:在博客根目录
[Blogroot]
打开终端,输入:1
2npm install --global gulp-cli #全局安装gulp指令集
npm install gulp --save #安装gulp插件安装各个下属插件以实现对各类静态资源的压缩。
压缩HTML:
1
2
3npm 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
2npm 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
为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//用到的各个插件
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
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
部分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'))
)在每次运行完
hexo generate
生成静态页面后,运行gulp
对其进行压缩。指令流程如下:1
2
3
4hexo clean
hexo generate
gulp
hexo server 或 hexo deploy关于font-min的补充说明,在本文中,是通过读取所有编译好的html文件(
./public/**/*.html
)中的字符,然后匹配原有字体包内./public/fonts/*.ttf
字体样式,输出压缩后的字体包到./public/fontsdest/
目录。所以最终引用字体的相对路径应该是/fontsdest/*.ttf
。而本地测试时,如果没有运行gulp,自然也就不会输出压缩字体包到public目录,也就看不到字体样式。
转载自Akilar的文章,本文仅为记录魔改过程
- 感谢你赐予我前进的力量