前言

之前介绍了如何用 Hexo 搭建博客，接下来介绍 Hexo 的基本使用
注：这些基本使用基于我自己平时的习惯，更多细节请参考 官方文档

1. 命令

搭建时用过的一些命令

1
2
3
4
5
$ hexo -v // 查看版本信息
$ hexo init // 初始化 Hexo
$ hexo generate // 生成静态页面，缩写为 hexo g
$ hexo server // 启动服务，可在本地访问，缩写为 hexo s
$ deploy // 部署 Hexo，缩写为 hexo d

创建新文章

1
$ hexo new <title>

很显然，创建的文章是 .md 文件，这需要我们了解 Markdown 语法，可以从 Markdown官网 学习，也可以在 菜鸟教程-markdown 学习（这里推荐 Markdown + Typora，写作更加方便~）

2. 配置

_config.yml 是 Hexo 的默认配置文件，我们可以在该文件中修改大部分配置

Site(网站)

1
2
3
4
5
6
7
8
# Site
title: '' # 网站主标题
subtitle: '' # 网站副标题
description: '' # 描述
keywords: '' # 关键词
author: # 作者
language: zh-CN # 语言
timezone: 'Asia/Shanghai' # 时区

URL(网址)

1
2
3
4
5
6
7
# URL
url: https://你的域名
permalink: :year/:month/:day/:title/ # 文章的永久链接格式
permalink_defaults:
pretty_urls:
  trailing_index: false # 是否在永久链接中保留尾部的 index.html，设置为 false 时去除
  trailing_html: false # 是否在永久链接中保留尾部的 .html, 设置为 false 时去除 (对尾部的 index.html无效)

Directory(目录)

1
2
3
4
5
6
7
8
9
# Directory
source_dir: source # 资源文件夹，这个文件夹用来存放内容
public_dir: public # 公共文件夹，这个文件夹用于存放生成的站点文件
tag_dir: tags # 标签文件夹
archive_dir: archives # 归档文件夹
category_dir: categories # 分类文件夹
code_dir: downloads/code # Include code 文件夹，source_dir 下的子目录
i18n_dir: :lang # 国际化（i18n）文件夹
skip_render: # 跳过指定文件的渲染。匹配到的文件将会被不做改动地复制到 public 目录中。您可使用 glob 表达式来匹配路径

Writing(文章)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# Writing
new_post_name: :title.md # 新文章的文件名称
default_layout: post # 预设布局
titlecase: false # 把标题转换为 title case
external_link:
  enable: true # 在新标签中打开链接
  field: site # 对整个网站（site）生效或仅对文章（post）生效
  exclude: '' # 需要排除的域名
filename_case: 0 # 把文件名称转换为 (1) 小写或 (2) 大写
render_drafts: false # 显示草稿
post_asset_folder: false # 启用 资源文件夹
relative_link: false # 把链接改为与根目录的相对位址
future: true # 显示未来的文章
syntax_highlighter: highlight.js # 以下都是对代码块的设置
highlight:
  line_number: true
  auto_detect: false
  tab_replace: ''
  wrap: true
  hljs: false
prismjs:
  preprocess: true
  line_number: true
  tab_replace: ''

Category & Tag(分类 & 标签)

1
2
3
4
# Category & Tag
default_category: uncategorized # 默认分类
category_map: # 分类别名
tag_map: # 标签别名

Date / Time format(日期 / 时间格式)

1
2
3
4
# Date / Time format
date_format: YYYY-MM-DD # 日期格式
time_format: HH:mm:ss # 时间格式
updated_option: 'mtime' # 当 Front Matter 中没有指定 updated 时 updated 的取值

Pagination(分页)

1
2
3
# Pagination
per_page: 10 # 每页显示的文章量 (0 = 关闭分页功能)
pagination_dir: page # 分页目录

Extensions(扩展)

1
2
# Extensions
theme: butterfly # 当前主题名称。值为 false 时禁用主题(这里我用的 butterfly)

Deployment(部署)

1
2
3
4
5
# Deployment
deploy:
  type: # 类型
  repo: # 仓库
  branch: # 分支

以上就是 Hexo 的基本使用，但是 UI 不好看（喜欢默认的除外），感兴趣的可以在主题等方面进行优化噢~