Hexo 主题 3-Hexo 安装与使用教程
1. 项目的目录结构及介绍
hexo-theme-3-hexo/
├── _config.yml
├── languages/
├── layout/
├── source/
│ ├── css/
│ ├── img/
│ ├── js/
│ └── lib/
├── LICENSE
├── README.md
└── package.json
- _config.yml: 主题的配置文件,包含主题的各种设置。
- languages/: 存放多语言支持的文件。
- layout/: 存放主题的模板文件,定义了页面的结构。
- source/: 存放静态资源文件,如CSS、图片、JavaScript等。
- css/: 存放样式文件。
- img/: 存放图片资源。
- js/: 存放JavaScript文件。
- lib/: 存放第三方库文件。
- LICENSE: 项目的开源许可证文件。
- README.md: 项目的说明文档。
- package.json: 项目的依赖管理文件。
2. 项目的启动文件介绍
Hexo 主题的启动文件主要是 _config.yml
和 layout/
目录下的模板文件。_config.yml
文件包含了主题的所有配置选项,而 layout/
目录下的文件定义了页面的结构和布局。
2.1 _config.yml
这是主题的主要配置文件,包含了主题的各种设置,如网站标题、描述、作者信息、导航菜单、侧边栏设置等。
2.2 layout/
目录
layout/
目录下的文件定义了页面的结构和布局,包括首页、文章页、归档页、标签页等。每个页面都有一个对应的模板文件,如 index.ejs
、post.ejs
、archive.ejs
等。
3. 项目的配置文件介绍
3.1 _config.yml
这是主题的核心配置文件,包含了主题的所有设置。以下是一些常见的配置项:
# 网站标题
title: 我的博客
# 网站描述
subtitle: 记录生活,分享技术
# 作者信息
author: 张三
# 网站语言
language: zh-CN
# 导航菜单
menu:
首页: /
归档: /archives
标签: /tags
关于: /about
# 侧边栏设置
sidebar:
position: right
display: always
# 评论系统设置
comments:
enable: true
provider: disqus
shortname: your-disqus-shortname
# 其他设置
# ...
3.2 package.json
package.json
文件包含了项目的依赖管理信息,定义了项目所需的 Node.js 包及其版本。
{
"name": "hexo-theme-3-hexo",
"version": "1.0.0",
"description": "A simple and elegant hexo theme.",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "yelog",
"license": "MIT",
"dependencies": {
"hexo": "^5.0.0"
}
}
通过以上配置,你可以根据自己的需求定制 Hexo 主题 3-Hexo,打造一个符合个人风格的博客。