了解文件结构

⭐
理解文件结构是主题装修的第一步

Stellar 主题文件结构概览

在开始定制之前，我们需要了解 Stellar 主题的文件组织结构。这有助于你快速定位需要修改的文件。

主题目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

themes/stellar/
├── _config.yml              # 主题主配置文件
├── _config.stellar.yml      # 站点覆盖配置（推荐在这里修改）
├── layout/                  # 页面模板
│   ├── _partial/           # 局部模板（头部、尾部、侧边栏等）
│   ├── _widget/            # 小组件模板
│   ├── archive.ejs       # 归档页
│   ├── index.ejs         # 首页
│   ├── page.ejs          # 独立页面
│   ├── post.ejs          # 文章页
│   └── wiki.ejs          # Wiki 页
├── source/                 # 静态资源
│   ├── css/              # 主题样式
│   ├── js/               # 主题脚本
│   └── fonts/            # 字体文件
└── scripts/               # Hexo 脚本
    └── ...

关键配置文件说明

1. 主题配置文件

Stellar 主题有两个主要配置文件：

• themes/stellar/_config.yml - 主题默认配置（不建议直接修改）
• _config.stellar.yml - 站点根目录下的覆盖配置（推荐）

**最佳实践：**在站点根目录创建 _config.stellar.yml 文件来覆盖主题默认配置。这样主题更新时不会丢失你的定制。

2. 数据文件目录

Stellar 主题使用 source/_data/ 目录存放各种数据配置：

1
2
3
4
5
6
7

source/_data/
├── authors.yml       # 作者信息
├── wiki.yml          # Wiki 项目列表
├── wiki/             # Wiki 项目配置
│   ├── c.yaml
│   └── python.yaml
└── widgets.yml       # 小组件库

目录与文件的作用

布局模板（layout/）

静态资源（source/）

装修前的重要提醒

备份！备份！备份！

在开始任何修改之前，务必备份以下文件：

• _config.yml - 站点主配置
• _config.stellar.yml - 主题覆盖配置
• source/_data/ 目录下的所有数据文件
• source/ 目录下的自定义资源

修改原则

• 不修改主题源文件：避免直接修改 themes/stellar/ 下的文件
• 使用覆盖配置：通过 _config.stellar.yml 覆盖默认配置
• 使用自定义目录：将自定义资源放在 source/custom/ 或 source/css/
• 渐进式修改：每次只修改一处，验证效果后再继续

推荐的开发流程：

1. 本地运行 hexo server 开启开发服务器
2. 修改配置文件或添加自定义样式
3. 浏览器实时预览效果（大部分修改会自动刷新）
4. 满意后提交修改到 Git 仓库

下一步

现在你已经了解了 Stellar 主题的文件结构，接下来让我们开始学习基础配置：

• 基础配置入门 - 了解核心配置文件和常用设置