Hexo系列(二) 配置文件详解

Hexo 是一款优秀的博客框架，在使用 Hexo 搭建一个属于本身的博客网站后，咱们还须要对其进行配置，使得 Hexo 更能知足本身的需求

这里所说的配置文件，是位于站点根目录下的 _config.yml 文件，能够直接用记事本打开进行编辑，文件中的具体配置项以下：

一、Site

网站的个性化描述，你们须要根据本身的实际状况认真填写

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

二、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_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

六、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	描述
theme	博客使用的主题，默认为 landscape

十、Deployment

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

Setting	描述
deploy	网站部署配置

deploy

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

【参考资料】

• https://hexo.io/docs/configuration

【Hexo系列相关文章】

• Hexo系列(一) 搭建博客网站

• Hexo系列(二) 配置文件详解

• Hexo系列(三) 经常使用命令详解

• Hexo系列(四) NexT主题配置

• Hexo系列(五) 撰写文章