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永久链接中每个段的默认值

Directory

关于文件夹的设置,也是一般不用进行更改

Setting描述
source_dir资源文件夹 ,存放用户的资源文件,默认为 source
public_dir公用文件夹 ,存放生成的静态文件,默认为 public
tag_dir标签目录 ,默认为 tags
archive_dir档案目录 ,默认为 archives
category_dir分类目录 ,默认为 categories
code_dir代码目录 ,默认为 downloads/code
i18n_diri18n目录 ,默认为 :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_replacetab 替代设置

Home page setting

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

Setting描述
index_generator主页设置
  • index_generator

    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

Pagination

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

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

Extensions

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

Setting描述
themetheme

Deployment

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

Setting描述
deploy网站部署配置
  • deploy

    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为例进行说明

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

hexo clean

hexo clean 命令用于 *清理缓存文件 *。网站显示异常的时候可以尝试此操作

1
hexo clean

Option

hexo –safe

hexo --safe 表示安全模式,用于禁用加载插件和脚本,安装新插件时遇到问题可以尝试此操作。

1
hexo --safe

hexo –debug

hexo --debug 表示调试模式,用于将消息详细记录到终端和 debug.log 文件

1
hexo --debug

hexo –silent

hexo --silent 表示静默模式,用于静默输出到终端

1
hexo --silent

结语

主要配置文件信息和常用命令就是这样了,

更多配置文件请参考官方文档:

配置:https://hexo.io/docs/configuration

命令:https://hexo.io/docs

------ 本文结束  感谢阅读 ------