基础配置入门

⭐
掌握基础配置是主题装修的核心技能

配置文件概述

Stellar 主题的配置分为多个层级，了解它们的关系对于定制非常重要。

配置层级

配置文件	优先级	用途
`_config.stellar.yml`	最高	站点级覆盖配置（推荐修改）
`themes/stellar/_config.yml`	中等	主题默认配置
`_config.yml`	基础	Hexo 站点基础配置

**重要提示：**永远不要在 themes/stellar/_config.yml 中直接修改，而是创建 _config.stellar.yml 文件进行覆盖配置。这样主题更新时不会丢失你的定制。

创建覆盖配置文件

步骤 1：创建文件

在博客站点根目录（与 _config.yml 同级）创建 _config.stellar.yml 文件：

1 2	# 在博客根目录执行 touch _config.stellar.yml

步骤 2：基本结构

在 _config.stellar.yml 中，你只需要写需要覆盖的配置项，不需要复制全部内容。

# _config.stellar.yml 示例

# 站点基本信息
site:
  name: 我的博客
  icon: /img/favicon.ico

# 导航菜单
menubar:
  columns: 4
  items:
    - id: home
      theme: "#1BCDFC"
      icon: >
        
          
        
      title: 首页
      url: /

    - id: wiki
      theme: "#3DC550"
      icon: ...
      title: 文档
      url: /wiki/

常用配置项详解

站点配置（site）

配置项	类型	说明
site.name	string	站点名称
site.icon	string	站点图标路径
site.desc	string	站点描述
site.url	string	站点 URL

颜色配置（color）

color:
  # 主色调 - 用于链接、按钮、激活状态
  theme: "#7bcfa6"

  # 强调色 - 用于高亮、徽章
  accent: "#e0f0e9"

  # 文字颜色
  text: "#333333"

  # 次要文字
  text-secondary: "#666666"

  # 背景色
  background: "#ffffff"

  # 代码块背景
  code: "#f5f5f5"

  # 边框颜色
  border: "#e8e8e8"

导航栏配置（menubar）

menubar:
  # 列数（1-6）
  columns: 4

  items:
    - id: home
      theme: "#1BCDFC"
      icon: >
        
          
        
      title: 首页
      url: /

    - id: wiki
      theme: "#3DC550"
      icon: ...
      title: 文档
      url: /wiki/

配置验证技巧

1. 使用 YAML 检查工具

YAML 对缩进非常敏感，建议使用以下方式检查：

VS Code 插件：YAML（redhat.vscode-yaml）
在线工具：YAML Lint

2. 启用 Hexo 调试模式

# 启动服务器时显示调试信息
hexo server --debug

# 生成时显示详细日志
hexo generate --debug

3. 常见配置错误

错误类型	表现	解决方法
缩进错误	YAML 解析失败	统一使用空格缩进（不要用 Tab）
中文冒号	配置项不生效	使用英文冒号（:）并留空格
路径错误	资源加载失败	检查路径是否以 / 开头

小结与练习

本章重点

理解配置层级：站点级 > 主题级 > 默认配置
掌握覆盖配置的方法：使用 _config.stellar.yml
了解常用配置项：站点信息、颜色、导航栏
学会验证配置：使用调试模式和 YAML 检查工具

动手练习

创建 _config.stellar.yml 文件
修改站点名称为你的名字
将主题色改为你喜欢的颜色
在导航栏添加一个新的菜单项

下一步

掌握了基础配置后，让我们深入了解各项功能的详细配置：

站点信息配置 - 完善博客的基本信息