Hexo框架(二)：配置文件详解与常用命令

前言：

本篇设置基于 NEXT 主题 7.7.2 版本！！

之前我们快速搭建了 Hexo 博客，并成功上传到了 GitHub 仓库，现在我们开始配置博客，对博客进行自定义。本篇主要是配置文件的详解，以及熟悉常用的一些 hexo 命令，可以帮我们更有效率的开发和管理博客。

配置文件详解

这里所说的配置文件，是位于站点根目录下的 _config.yml 文件，可以直接用记事本打开进行编辑,当然我们还是选择使用 VScode 进行编辑。

配置文件

Site

网站的个性化描述，大家需要根据自己的实际情况认真填写

Setting	描述
title	网站标题
subtitle	网站副标题
description	网站描述
keywords	网站关键字
author	网站作者
language	网站使用的语言，默认是`en` ，中文网站填`zh-CN`
Hans`zone	网站使用的时区，默认为 `计算机的预设置`，可以不填

URL

关于博客文章 URL 的设置，一般不用进行更改

Setting	描述
url	网站的网址
root	网站的根目录，也是存放文章的目录
permalink	文章的链接格式，默认为 `:year/:month/:day/:title/`
permalink_defaults	永久链接中每个段的默认值

Setting	描述
source_dir	资源文件夹，存放用户的资源文件，默认为 `source`
public_dir	公用文件夹，存放生成的静态文件，默认为 `public`
tag_dir	标签目录，默认为 `tags`
archive_dir	档案目录，默认为 `archives`
category_dir	分类目录，默认为 `categories`
code_dir	代码目录，默认为 `downloads/code`
i18n_dir	i18n 目录，默认为 `:lang`
skip_render	储存站长验证文件，跳过指定文件的渲染

Writing

比较常用的写作设置，可以根据自己的写作习惯随时进行调整

Setting	描述
new_post_name	文章的文件名格式，默认为 `:title.md`
default_layout	预设的布局模板，默认为 `post`
titlecase	标题是否使用首字母大写，默认为 `false`
external_link	链接是否在新标签页中打开，默认为 `true`
filename_case	将文件名转换为 `1` 小写或 `2` 大写，默认为 `0`
render_drafts	是否显示渲染草稿，默认为 `false`
post_asset_folder	是否启用 Asset 文件夹，默认为 `false`
relative_link	是否建立相对于根文件夹的链接，默认为 `false`
future	是否显示未来文章，默认为 `true`
highlight	代码块设置

highlight

Setting	描述
enable	是否使用代码高亮，默认为 `true`
line_number	是否显示行号，默认为 `true`
auto_detect	是否自动检测语言，默认为 `false`
tab_replace	tab 替代设置

Home page setting

首页设置，可以自己决定每页显示的文章数量和显示文章的顺序

Setting	描述
index_generator	主页设置

index_generator

Setting 描述

path 首页的根目录

per_page 每页显示文章的数量，默认为 10

order_by 显示文章的顺序，默认为 -date

Setting	描述
path	首页的根目录
per_page	每页显示文章的数量，默认为 `10`
order_by	显示文章的顺序，默认为 `-date`

Category & Tag

这里是关于分类和标签的配置

Setting	描述
default_category	预设分类，默认为 `uncategorized`
category_map	分类别名
tag_map	标签别名

Date / Time format

时间和日期的显示格式

Setting	描述
date_format	日期格式，默认为 `YYYY-MM-DD`
time_format	时间格式，默认为 `HH:mm:ss`

分页设置，可以自己决定单个页面上显示的文章数量和分页目录

Setting	描述
per_page	单个页面上显示的文章数量，默认为 `10` ，用 `0` 表示禁用分页
pagination_dir	分页目录，默认为 `page`

Extensions

这里可以设置主题类型和插件，之后讲到更换博客主题时需要进行更改

Setting	描述
theme	theme

Deployment

这里是关于网站部署的配置，常用的有部署类型和部署地址

Setting	描述
deploy	网站部署配置

deploy

Setting 描述

type 网站部署类型

repo 网站部署地址

Setting	描述
type	网站部署类型
repo	网站部署地址

常用命令

hexo init

hexo init 命令用于 **初始化 ** 本地文件夹为博客的根目录。

1	hexo init [folder]

folder 可选参数，用以指定初始化目录的路径，若无指定则默认为当前目录

hexo new

hexo new 命令用于 新建文章 ，一般可以简写为 hexo n

1	hexo new [layout] <title>

layout 可选参数，用以指定文章类型，若无指定则默认由配置文件中的 default_layout 选项决定
title 必填参数，用以指定文章标题，如果参数值中含有空格，则需要使用双引号包围

hexo generate

hexo generate 命令用于 生成静态文件，一般可以简写为 hexo g

1	hexo generate

-d 选项，指定生成后部署，与 hexo d -g 等价

hexo server

hexo server 命令用于 启动本地服务器，一般可以简写为 hexo s

1	hexo server

-p 选项，指定服务器端口，默认为 4000
-i 选项，指定服务器 IP 地址，默认为 0.0.0.0
-s 选项，静态模式，仅提供 public 文件夹中的文件并禁用文件监视

说明： 运行本地服务器需要安装 hexo-server 插件

1	npm install hexo-server --save

hexo deploy

hexo deploy 命令用于 **部署 ** 网站，一般可以简写为 hexo d

1	hexo deploy

-g 选项，指定生成后部署，与 hexo g -d 等价

说明：部署前需要修改 _config.yml 配置文件，下面以部署到 GitHub 为例进行说明

deploy:
  type: git
  repo: https://github.com/YourgithubName/YourgithubName.github.io.git
  branch: master
  message: 自定义提交消息，默认为Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}