使用gulp压缩博客静态资源
更新记录
2022-01-19: 文本迁移
- 将gulp内容从合集迁移至独立文章
- 新增字体压缩相关内容
参考方向 | 教程原贴 |
|---|---|
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]打开终端，输入：
npm install --global gulp-cli #全局安装gulp指令集
npm install gulp --save #安装gulp插件安装各个下属插件以实现对各类静态资源的压缩。在此高呼卓越科技 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 代码，所以不存在因为语法变动导致的错误 。事实上，当我们使用jsdelivr的CDN服务时，只需要在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为 Gulp 创建gulpfile.js任务脚本。在博客根目录[Blogroot]下新建gulpfile.js, 打开[Blogroot]\gulpfile.js, 输入以下内容：
- 方案一：babel 压缩 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'
))- 方案二：terser 压缩 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');
// 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'
))在每次运行完hexo generate生成静态页面后，运行gulp对其进行压缩。指令流程如下：
hexo clean
hexo generate
gulp
hexo server 或 hexo deploy关于 font-min 的补充说明，在本文中，是通过读取所有编译好的 html 文件（./public/**/*.html）中的字符，然后匹配原有字体包内./public/fonts/*.ttf 字体样式，输出压缩后的字体包到./public/fontsdest/ 目录。所以最终引用字体的相对路径应该是 /fontsdest/*.ttf。而本地测试时，如果没有运行 gulp，自然也就不会输出压缩字体包到 public 目录，也就看不到字体样式。