hexo 学习 0006:hexo 目录配置

在使用 Hexo 搭建博客的过程中,目录配置是基础且关键的一环。它定义了站点内容的存储路径、生成路径以及特定功能页面的组织方式。本文将围绕 _config.yml 文件中的目录相关配置进行详细说明,帮助你清晰理解每个参数的作用和使用方法。

一、核心目录配置说明

Hexo 的目录配置主要集中在 _config.yml 文件的 Directory 区域,以下是各参数的具体含义:

  • source_dir
    指定资源文件夹的路径,即存放所有原始内容的位置,如文章、页面、图片等。默认值为 source。所有需要被 Hexo 处理的内容都应放在该目录下。

  • public_dir
    指定公共文件夹的路径,即生成的静态站点文件输出位置。执行 hexo generate 命令后,生成的 HTML、CSS、JS 等文件将存放于此。默认值为 public,部署时通常上传此目录的内容。

  • tag_dir
    设置标签页面的存储目录。Hexo 自动生成的标签分类页面将位于此路径下。默认值为 tags,对应 URL 路径如 /tags/

  • archive_dir
    设置归档页面的存储目录。用于存放按时间归档的文章列表页面。默认值为 archives,对应路径如 /archives/2026/

  • category_dir
    设置分类页面的存储目录。用于组织不同分类下的文章列表。默认值为 categories,对应路径如 /categories/技术/

  • code_dir
    指定代码文件夹路径,是 source_dir 下的子目录,用于存放文章中引用的代码片段。默认值为 downloads/code,可根据需要调整。

  • i18n_dir
    设置国际化文件夹路径,用于支持多语言内容。其值通常为 :lang,表示根据语言动态生成路径,如 /zh-CN//en/

二、跳过渲染配置:skip_render

skip_render 是一个实用功能,用于指定某些文件或目录不经过 Hexo 的渲染流程,直接复制到 public_dir 中。这适用于需要保留原始格式的文件,例如静态 HTML 页面或特定脚本文件。

  • 支持使用 Glob 表达式进行路径匹配。
  • 示例配置如下:
1
skip_render: "mypage/**/*"

该配置会将 source/mypage/ 目录下的所有文件(如 index.htmlcode.js)原样输出到 public 目录中,不进行任何处理。

也可以用于跳过对特定文章的渲染:

1
skip_render: "_posts/test-post.md"

此配置将忽略对 source/_posts/test-post.md 文件的渲染,使其不会生成对应的页面。

三、配置参数汇总表

设置 描述 默认值
source_dir 资源文件夹,存储内容源文件的位置 source
public_dir 公共文件夹,生成静态站点的输出位置 public
tag_dir 标签页面的存储目录 tags
archive_dir 归档页面的存储目录 archives
category_dir 分类页面的存储目录 categories
code_dir 代码文件夹,位于 source_dir 下的子目录 downloads/code
i18n_dir 国际化(i18n)文件夹路径 :lang
skip_render 匹配的文件将不被渲染,直接复制到 public 目录 (空)

以上配置共同构成了 Hexo 博客的目录结构基础。合理设置这些参数,有助于更好地组织和管理博客内容,满足个性化部署需求。