IT博客汇 | 使用gulp压缩博客静态资源

使用gulp压缩博客静态资源

JayHrn发表于 2023-12-19 09:35:28

本文是转载文章，参考自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 2	npm install --global gulp-cli #全局安装gulp指令集 npm install gulp --save #安装gulp插件

安装各个下属插件以实现对各类静态资源的压缩。
- 压缩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

为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');
// 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'
))

//用到的各个插件
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压缩任务的相关配置

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

转载自Akilar的文章，本文仅为记录魔改过程