| 使用子文件夹管理 Hexo 文章且不改变文章永久链接 | 您所在的位置：网站首页 › 怎么把写的文章变成文件 › 使用子文件夹管理 Hexo 文章且不改变文章永久链接 |
使用子文件夹管理 Hexo 文章且不改变文章永久链接
|
使用子文件夹管理 Hexo 文章且不改变文章永久链接
2019-10-13
Category:
技术
Hexo 博客
loading views
2020-01-15 更新：如果你只是想实现「文章源码放在子目录、永久链接保持不变」的效果，可以直接修改 _config.yml 中的配置： permalink: :name/ new_post_name: :year/:title.md感谢 @SukkaW 在评论区提供的建议！ 在 Hexo 中，我们可以通过站点配置中的 permalink 配置项来指定文章的永久链接的格式。比如说默认值是 :year/:month/:day/:title/，那么一篇 slug 为 hello-world 的文章，最终生成的链接就是 2019/10/13/hello-world/。 如果你不想分得这么细，也可以根据自己的喜好 自定义这个配置项。本博客就将其设置为了 :title/，即仅使用文章的 slug 作为永久链接，更清爽一些。 但是这样一来，文章源文件的管理就有点难办了。Hexo 中所有的文章（Post layout）都存放在 source/_posts 目录中，如果仅使用 slug 作为文件名的话，文章一多就会出现乱成一坨的惨状 —— 只能通过文件名查找，根本无法通过日期定位文章！
但如果你在 _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_permalink 和 new_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. 除另有声明外，本博客文章均采用 知识共享(Creative Commons) 署名 4.0 国际许可协议 进行许可。转载请注明原作者与文章出处。 |
【本文地址】