在使用 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.html 和 code.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 博客的目录结构基础。合理设置这些参数,有助于更好地组织和管理博客内容,满足个性化部署需求。