hexo 学习 0008:hexo 首页配置

Hexo 的首页行为由 _config.yml 文件中的 index_generator 选项控制，主要负责定义博客主页的文章展示逻辑，包括路径、分页和排序方式。

核心配置项说明

index_generator.path
设置博客首页的根路径。默认值为空字符串 ''，表示首页位于站点根目录。若需将首页设为子目录（如 /blog/），可在此处指定路径。

index_generator.per_page
定义每页显示的文章数量。默认值为 10。若设置为 0，则会禁用分页功能，所有文章将在一页中显示。

index_generator.order_by
设置文章的排列顺序。默认值为 -date，表示按发布时间降序排列（最新的在前）。若设置为 date（无负号），则按升序排列（最老的在前）。也可根据需要设置为按标题 title 或其他 Front-matter 中的字段排序。

分页路径设置

index_generator.pagination_dir
定义分页链接的 URL 格式。默认值为 page。例如，当此值为 page 时，第二页的 URL 将为 /page/2/。该设置影响分页导航的生成结构。

配置示例

以下是一个自定义首页配置的示例：

index_generator:
  path: ''
  per_page: 5
  order_by: -date
  pagination_dir: page

此配置表示：首页位于根路径，每页显示 5 篇文章，按发布时间从新到旧排序，分页链接格式为 /page/2/ 等。

注意事项

• 分页性能：若博客文章数量极大（如上千篇），建议合理设置 per_page 数值，避免单页加载过慢，影响用户体验。
• SEO 优化：保持 order_by 为 -date 是博客类网站的常规做法，能确保最新内容优先被搜索引擎抓取。
• 路径冲突：修改 path 时，需确保该路径未被其他页面或分类占用，否则可能导致路由冲突。
• 配置生效：修改配置后，需执行 hexo clean && hexo generate 命令重新生成站点，更改才会生效。