
改 Hexo 博客时,我既想把文章置顶,也想让某些文章不出现在首页。找过的插件各有一部分:有的支持置顶,有的按标签隐藏,直接在主题里隐藏又会留下分页数量的问题。最后我从官方首页生成器 fork 了一份,补上自己要用的规则,发布成 hexo-generator-index-custom。
首页文章的顺序
插件读取文章 frontmatter 里的 top、sticky 和 hide。先按配置的 order_by 排序、去掉 hide 为 true 的文章,再整理置顶顺序,最后交给 hexo-pagination 分页。
这一版把 top 与 sticky 相加作为置顶值,数值越大越靠前:
posts.data = posts.data.sort(
(a, b) =>
((b.sticky || 0) + (b.top || 0)) -
((a.sticky || 0) + (a.top || 0))
);因此,原来用 top 的文章和用 sticky 的文章都能参与排序;只想隐藏一篇文章时,写 hide: true 即可。
---
title: 一篇需要置顶的文章
top: 10
---隐藏发生在分页之前
在主题模板里判断是否显示文章,文章已经参与了分页。隐藏多篇后,首页实际能看到的条目就会减少。
我把过滤放到生成器中,分页接收到的就是过滤后的列表。我还在 v1.0.1 修过尾页数量的问题,在开发记录里补了句“光速修复”。
插件继续使用官方生成器的 path、per_page、order_by 和 pagination_dir 等配置,接入点也是 Hexo 的 index generator。安装时替换原来的首页生成器,避免两个插件同时生成首页。

