在 Hexo 中,我们可以通过站点配置中的 permalink 配置项来指定文章的永久链接的格式。比如说默认值是 :year/:month/:day/:title/,那么一篇 slug 为 hello-world 的文章,最终生成的链接就是 2019/10/13/hello-world/

如果你不想分得这么细,也可以根据自己的喜好 自定义这个配置项。本博客就将其设置为了 :title/,即仅使用文章的 slug 作为永久链接,更清爽一些。

但是这样一来,文章源文件的管理就有点难办了。Hexo 中所有的文章(Post layout)都存放在 source/_posts 目录中,如果仅使用 slug 作为文件名的话,文章一多就会出现乱成一坨的惨状 —— 只能通过文件名查找,根本无法通过日期定位文章!

too-many-files-in-posts-chaos

但如果你在 _posts 目录下新建子文件夹来存放文章,比如 _posts/2019/hello-world.md,你就会发现,最终生成的文章链接中也会带上这个子文件夹的名称:https://hexo.example/2019/hello-world/

这可咋整?难道就不能在不改变文章永久链接的情况下,把文章源文件放到子文件夹里去吗?

当然可以!Hexo 可是以灵活随便著称的 JavaScript 写的博客程序,那还不是想怎么魔改就怎么魔改?这里我抛砖引玉,介绍一种使用 filter 对文章永久链接进行操作的方法。其他应该也有不少方法能实现同样的效果,欢迎各位在评论区分享交流。

先贴代码(直接放到站点根目录的 scripts 文件夹中就可以了):

// posts-subfolder
const { join } = require('path');
const { readdirSync } = require('fs');
const moment = require('moment');

// 使用子文件夹管理文章且不改变文章永久链接
// e.g. "source/_posts/2019/slug.md" => "https://hexo.example/slug/"
hexo.extend.filter.register('post_permalink', function (permalink) {
  // 想保留在文章永久链接中的子文件夹
  const excludes = [];

  const postDir = join(this.source_dir, '_posts');
  const folders = readdirSync(postDir, { withFileTypes: true })
    .filter(dirent => dirent.isDirectory())
    .map(dirent => dirent.name)
    .filter(dir => !excludes.includes(dir));

  for (const name of folders) {
    if (permalink.startsWith(`${name}/`)) {
      // 删除链接中的子文件夹名称
      return permalink.replace(`${name}/`, '');
    }
  }
});

// 使 `hexo new` 生成的文件保存至相应的年份子文件夹中
// @see hexo/lib/plugins/filter/new_post_path.js
hexo.extend.filter.register('new_post_path', data => {
  const year = moment(data.date || Date.now()).format('YYYY');
  data.path = join(year, data.slug);
  return data;
}, 1); // 设置为高优先级

其中 post_permalinknew_post_path 都是 Hexo 预留的钩子,所以基本不用费什么力气(不得不说,Hexo 的插件系统设计还是很不错的,非常灵活,也埋了足够多的 filter 和 event,基本覆盖了整个生命周期)。

修改 post_permalink filter 传进来的值就可以直接修改最终生成的文章永久链接,所以我们直接把自定义的子文件夹从 permalink 中删掉,这样文章链接中就不会出现子文件夹的名称啦,非常简单粗暴。

> _posts $ tree
.
├── ...
├── 2018
│   ├── ...
│   ├── the-difference-between-cli-terminal-shell-tty.md
│   └── wsl-guide.md
└── 2019
    ├── disqus-migration-tools-url-mapper.md
    ├── first-post-of-2019.md
    └── hexo-posts-in-subfolder.md

我使用了年份来组织文件,基本上就足够了(反正我一年也写不了几篇)

另外附送个我批量整理源文件时用的命令:

# 记得配合自己实际的 front-matter 格式修改一下哦
grep -r "date: '2015-" *.md -l | xargs mv -v -t 2015/

Happy hacking.