Hexo 主题 BlueLake 使用教程

1. 项目的目录结构及介绍

Hexo 主题 BlueLake 的目录结构如下：

hexo-theme-BlueLake/
├── _config.yml
├── languages
│   ├── default.yml
│   └── zh-CN.yml
├── layout
│   ├── _partial
│   │   ├── footer.ejs
│   │   ├── head.ejs
│   │   ├── header.ejs
│   │   └── ...
│   ├── index.ejs
│   ├── archive.ejs
│   ├── category.ejs
│   ├── page.ejs
│   ├── post.ejs
│   └── tag.ejs
├── scripts
│   └── ...
├── source
│   ├── css
│   │   ├── _base.styl
│   │   ├── _partial
│   │   │   ├── footer.styl
│   │   │   ├── header.styl
│   │   │   └── ...
│   │   ├── style.styl
│   │   └── ...
│   ├── fonts
│   │   └── ...
│   ├── images
│   │   └── ...
│   └── js
│       └── ...
└── package.json

目录结构介绍

• _config.yml: 主题的配置文件。
• languages: 存放多语言配置文件。
  • default.yml: 默认语言配置。
  • zh-CN.yml: 中文语言配置。
• layout: 存放页面布局模板文件。
  • _partial: 存放部分模板文件，如页眉、页脚等。
  • index.ejs: 首页模板。
  • archive.ejs: 归档页面模板。
  • category.ejs: 分类页面模板。
  • page.ejs: 页面模板。
  • post.ejs: 文章模板。
  • tag.ejs: 标签页面模板。
• scripts: 存放脚本文件。
• source: 存放静态资源文件。
  • css: 存放样式文件。
    • _base.styl: 基础样式文件。
    • _partial: 部分样式文件。
    • style.styl: 主样式文件。
  • fonts: 存放字体文件。
  • images: 存放图片文件。
  • js: 存放JavaScript文件。
• package.json: 项目的依赖管理文件。

2. 项目的启动文件介绍

Hexo 主题 BlueLake 的启动文件主要是 _config.yml 和 package.json。

_config.yml

这是主题的主要配置文件，包含了主题的各种设置，如网站标题、描述、导航菜单、社交链接等。

package.json

这是 Node.js 项目的依赖管理文件，包含了项目所需的依赖包和一些脚本命令。

3. 项目的配置文件介绍

_config.yml

_config.yml 是主题的核心配置文件，以下是一些常见的配置项：

# Site
title: 网站标题
subtitle: 网站副标题
description: 网站描述
author: 作者
language: 语言
timezone: 时区

# URL
url: 网站URL
root: 网站根路径

# Directory
source_dir: 源文件目录
public_dir: 生成文件目录
tag_dir: 标签目录
archive_dir: 归档目录
category_dir: 分类目录
code_dir: 代码目录
i18n_dir: 国际化目录
skip_render: 跳过渲染的文件

# Writing
new_post_name: 新文章的文件名格式
default_layout: 默认布局
titlecase: 标题是否转换为标题格式
external_link: 外部链接是否在新窗口打开
filename_case: 文件名大小写转换
render_drafts: 是否渲染草稿
post_asset_folder: 是否启用资源文件夹
relative_link: 是否使用相对链接
future: 是否发布未来的文章
highlight: 代码高亮设置

# Category & Tag
default_category: 默认分类
category_map: 分类映射
tag_map: 标签映射

# Date / Time format
date