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

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

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

1、Site

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

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

2、URL

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

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

3、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 储存站长验证文件，跳过指定文件的渲染

4、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 替代设置

5、Home page setting

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

Setting 描述
index_generator 主页设置

index_generator

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

6、Category & Tag

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

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

7、Date / Time format

时间和日期的显示格式，一般没特殊要求的也不需要改

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

8、Pagination

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

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

9、Extensions

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

Setting 描述
theme 博客使用的主题，默认为 landscape

10、Deployment

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

Setting 描述
deploy 网站部署配置

deploy

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

【参考资料】

【Hexo系列相关文章】

posted @ 2018-08-07 20:54  半虹  阅读(833)  评论(0)    收藏  举报