Hexo 主题 Indigo 使用教程
1. 项目的目录结构及介绍
Hexo 主题 Indigo 的目录结构如下:
hexo-theme-indigo/
├── languages/ # 多语言支持文件
├── layout/ # 页面模板文件
├── scripts/ # 脚本文件
├── source/ # 静态资源文件
├── _config.yml # 主题配置文件
├── editorconfig # 编辑器配置文件
├── LICENSE # 许可证文件
├── README.md # 项目说明文件
└── package.json # 项目依赖文件
目录结构介绍
languages/
: 包含多语言支持的配置文件,用于国际化。layout/
: 包含页面的模板文件,使用 EJS 模板引擎。scripts/
: 包含一些自定义脚本,用于扩展主题功能。source/
: 包含主题的静态资源文件,如 CSS、JavaScript、图片等。_config.yml
: 主题的主要配置文件,用于配置主题的各种选项。editorconfig
: 编辑器配置文件,用于统一代码风格。LICENSE
: 许可证文件,说明项目的开源许可协议。README.md
: 项目说明文件,提供项目的基本信息和使用指南。package.json
: 项目依赖文件,列出了主题所需的 Node.js 包。
2. 项目的启动文件介绍
Hexo 主题 Indigo 的启动文件主要是 _config.yml
和 package.json
。
_config.yml
_config.yml
是主题的主要配置文件,包含了主题的各种配置选项,如站点信息、导航菜单、侧边栏设置等。以下是一些常见的配置项:
# 站点信息
title: 我的博客
subtitle: 副标题
description: 描述
author: 作者
language: zh-CN
timezone: Asia/Shanghai
# 导航菜单
menu:
首页: /
归档: /archives
关于: /about
# 侧边栏设置
sidebar: right
package.json
package.json
文件列出了主题所需的 Node.js 包和一些脚本命令。以下是一些常见的配置项:
{
"name": "hexo-theme-indigo",
"version": "1.7.0",
"description": "一个Material Design风格的Hexo主题",
"main": "index.js",
"scripts": {
"start": "hexo server",
"build": "hexo generate",
"deploy": "hexo deploy"
},
"dependencies": {
"hexo": "^3.0.0",
"hexo-renderer-less": "^2.0.0"
}
}
3. 项目的配置文件介绍
Hexo 主题 Indigo 的配置文件主要是 _config.yml
。以下是一些常见的配置项及其介绍:
站点信息
title: 我的博客 # 站点标题
subtitle: 副标题 # 站点副标题
description: 描述 # 站点描述
author: 作者 # 作者名称
language: zh-CN # 语言设置
timezone: Asia/Shanghai # 时区设置
导航菜单
menu:
首页: / # 首页链接
归档: /archives # 归档页面链接
关于: /about # 关于页面链接
侧边栏设置
sidebar: right # 侧边栏位置,可选值:left, right
其他配置
# 主题样式
style:
primary_color: "#3F51B5" # 主色调
accent_color: "#FF4081" # 强调色
# 社交链接
social:
GitHub: https://github.com/yourusername
Twitter: https://twitter.com/yourusername
通过这些配置项,可以灵活地定制 Hexo 主题 Indigo,使其符合个人或项目的需求。