使用 Hexo + GitHub Page 搭建个人博客的实践记录。

1
## Deployment
2
### Docs: https://hexo.io/docs/one-command-deployment
3
deploy:
4
  type: 'git'
5
  repo: git@github.com:用户名/用户名.github.io.git
6
  branch: master

1
## abbrlink config
2
abbrlink:
3
  alg: crc32 #support crc16(default) and crc32
4
  rep: hex #support dec(default) and hex
5
  drafts: false #(true)Process draft,(false)Do not process draft. false(default)
6
  # Generate categories from directory-tree
7
  # depth: the max_depth of directory-tree you want to generate, should > 0
8
  auto_category:
9
    enable: true #true(default)
10
    depth: 3 #3(default)
11
    over_write: false
12
  auto_title: false #enable auto title, it can auto fill the title by path
13
  auto_date: false #enable auto date, it can auto fill the date by time today
14
  force: false #enable force mode,in this mode, the plugin will ignore the cache, and calc the abbrlink for every post even it already had abbrlink. This only updates abbrlink rather than other front variables.

1
## Site
2
title: HPCesia 的摆烂小屋
3
subtitle: ''
4
description: '记录自己的摆烂日常与学习记录'
5
keywords:
6
author: HPCesia
7
language:
8
  - zh-CN
9
  - zh-TW
10
timezone: 'Asia/Shanghai' # 这个默认是主机时区，不用管

1
## 用于浏览器标签的图标
2
## Icon for browser tab
3
favicon: /img/fluid.png
4

5
## 用于苹果设备的图标
6
## Icon for Apple touch
7
apple_touch_icon: /img/fluid.png

1
font:
2
  font_size: 16px
3
  font_family:
4
  letter_spacing: 0.02em
5
  code_font_size: 85%

1
custom_css:
2
  - https://cdn.jsdelivr.net/npm/lxgw-wenkai-screen-web/style.css

1
custom_js:
2
  - https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.js
3
  - https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/contrib/auto-render.min.js

1
custom_css:
2
  - https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.css # Twikoo Katex 数学公式渲染

1
## hexo-generator-feed
2
plugins: hexo-generator-feed
3
feed:
4
  enable: true
5
  type: rss2 # 类型 atom | rss2
6
  path: rss2.xml # 文件路径, 默认是 atom.xml | rss2.xml
7
  limit: 5 # 展示文章的数量, 使用0或则false代表展示全部
8
  hub: #
9
  content: # 在RSS文件中是否包含内容, true | false, 默认不填为 false
10
  content_limit: 140 # 指定内容的长度作为摘要,仅仅在上面content设置为false和没有自定义的描述出现
11
  content_limit_delim: ' ' # 截取描述的分隔符, 以指定分隔符作为截取结束的标志.
12
  order_by: -date
13
  autodiscovery: true
14
  template:

1
const gulp = require('gulp');
2
const cleancss = require('gulp-clean-css');
3
var terser = require('gulp-terser');
4
const htmlmin = require('gulp-html-minifier-terser');
5

6
// 压缩 public 目录下的 css 文件
7
// 可接受参数的文档：https://github.com/jakubpawlowicz/clean-css#constructor-options
8
gulp.task('minify-css', () => {
9
  return gulp
10
    .src('./public/**/*.css') // 处理public目录下所有的css文件，下同
11
    .pipe(cleancss())
12
    .pipe(gulp.dest('./public'));
13
});
14

15
// 压缩public目录下的js文件
16
// 可接受参数的文档：https://github.com/terser/terser?tab=readme-ov-file#minify-options-structure
17
gulp.task('minify-js', () =>
18
  gulp
19
    .src(['./public/**/*.js', '!./public/**/*.min.js'])
20
    .pipe(
21
      terser({
22
        format: {
23
          semicolons: false, // 使用换行而非分号压缩 JS 脚本，对浏览器压缩性能无影响，但是方便调试
24
        },
25
      })
26
    )
27
    .pipe(gulp.dest('./public'))
28
);
29

30
// 压缩public目录下的html文件
31
// 可接受参数的文档：https://github.com/terser/html-minifier-terser#options-quick-reference
32
gulp.task('minify-html', () => {
33
  return gulp
34
    .src('./public/**/*.html')
35
    .pipe(
36
      htmlmin({
37
        removeComments: true, // 移除注释
38
        caseSensitive: true, // 以区分大小写的方式处理属性
39
        removeEmptyAttributes: true, // 移除值为空的参数
40
        removeRedundantAttributes: true, // 移除值跟默认值匹配的属性
41
        collapseBooleanAttributes: true, // 省略布尔属性的值
42
        preventAttributesEscaping: true, // 避免属性被转义
43
        collapseWhitespace: true, // 移除空格和空行
44
        conservativeCollapse: true, // 始终折叠为 1 个空格（永远不要完全移除它）。必须与 collapseWhitespace=true 一起使用。
45
        noNewlinesBeforeTagClose: true, // 从一个元素闭合标签前永远不要添加换行
46
        minifyCSS: true, // 压缩 HTML 中的 CSS
47
        minifyJS: {
48
          // 调用 terser 压缩 HTML 中的 JS，配置同 terser
49
          format: {
50
            semicolons: false,
51
            quote_style: 1, // 始终使用单引号包裹字符串，可以避免类似 `onclick="foo('bar')"` 这类属性出现 bug
52
          },
53
        },
54
        minifyURLs: true, // 压缩 HTML 中的链接
55
      })
56
    )
57
    .pipe(gulp.dest('./public'));
58
});
59

60
// 默认任务，不带任务名运行gulp时执行的任务
61
gulp.task('default', gulp.parallel('minify-css', 'minify-js', 'minify-html'));

1
"scripts": {
2
  "postbuild": "gulp"
3
}

1
hexo.extend.generator.register('postbuild', function () {
2
  const { exec } = require('child_process');
3
  exec('npm run postbuild', (err, stdout, stderr) => {
4
    if (err) {
5
      console.error(`Error: ${stderr}`);
6
    } else {
7
      console.log(`Output: ${stdout}`);
8
    }
9
  });
10
});