Hexo博客配置文件说明

Nest是一款制作精良，不断维护的大众款博客主题。好的主题往往拥有友好的文档、合理的接口、技术讨论和更新支持。这款主题适合新手入手，通过配置可以达到自己想要的定制化效果。

本文详细说明配置文件中的设置选项含义，适合初学者了解配置内容和信息备查。主题的安装过程在挑选和初步配置Hexo主题中已经有所讲解，这里默认大家已经搭建好本地环境，选择了对应的子主题。

文件说明

博客配置文件：在博客源代码的文件夹下的“_config.yml”文件，是Hexo博客内置的默认配置文件。
主题配置文件：在主题文件夹下的“_config.yml”文件，是主题内置的默认配置文件。
主题配置的所有主要说明在官方文档里都有体现。有一些不太明白的地方Google一下，或者直接去仓库发Issue，基本都能找到答案。

博客配置文件

博客配置文件功能清单

名称	作用说明	配置类型	备注
网站（Site）	博客名称、副标题、作者、语言设置	基础配置
链接（URL）	博客的链接、根目录、链接格式等	基础配置
目录（Directory）		基础配置
书写（Writing）		基础配置
分类和标签（Category & Tag）		优化配置
日期和时间格式（Date / Time format）	用于设置日期和时间默认格式	基础配置
分页（Pagination）		优化配置
扩展设置（Extensions）	设置主题	基础配置	从零开始新建Hexo博客已详细说明
部署（Deployment）	部署设置	基础配置	从零开始新建Hexo博客已详细说明

博客配置文件详细解释

网站（Site）

# Site
title: 浚宇的博客
subtitle: 
description:
author: 浚宇
language: zh-Hans
timezone:

“title”：博客的名称，一般是要填写的，仁者见仁。
“subtitle、description”：根据主题的不同，有的会显示有的不会显示。我的这个主题不会显示，所以自己并没有填写。
“author”：作者，建议填写。
“language”：语言会对应的解析正在应用的主题中的languages文件夹下的不同语言文件。所以这里的名称要和languages文件夹下的语言文件名称一致。
“timezone”：可不填写。

链接（URL）

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://blog.junyu.pro
root: /
# permalink: :year/:month/:day/:title/
permalink: posts/:category/:title.html
permalink_defaults:

“url”：一般填写自己的站点链接。
“root”：设置根目录的位置，如果站点在服务器上的子目录，就需要做设置。
“permalink”：生成的链接的格式。带井号的是默认的格式，带有日期感觉怪怪的，改成了自己喜欢的格式。规则也比较简单，标签前面要加英文冒号。
“permalink_defaults”
注意：由于作者的需求比较简单，这里的内容解释相对简单。实际上关于变量和permalink的作用还有很多，甚至可以建立多语言的站点，可以参考：Hexo的高级进阶

目录（Directory）

# Directory
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:

目录结构一般是不动的的，保持默认即可。

书写（Writing）

# Writing
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight:
  enable: true
  line_number: true
  auto_detect: true
  tab_replace:

书写相关的事宜
“new_post_name”：新的博文的文件名
“default_layout:“ 默认布局
“titlecase: false“ # Transform title into titlecase
“external_link: true“ #Open external links in new tab
“filename_case: 0“ #把文件名称转换为 (1) 小写或 (2) 大写
“render_drafts: false“ 是否显示草稿
“post_asset_folder: false“ #是否启动资源文件夹
“relative_link: false“ #把链接改为与根目录的相对位址
“future: true “
“highlight:“ #代码块的设置
“enable: true“
“line_number: true“
“auto_detect: true“
“tab_replace:“

分类和标签（Category & Tag）

# Category & Tag
default_category: uncategorized
category_map:
  博客技术: hexo
  数据科学: ds
  千字文: essay
tag_map:
  千字文: essay

分类和标签的设置。
“default_category”：如果撰写文章时没有设置分类，默认的分类选择。
“category_map”：用于映射分类的别名，url就可以尽量简洁。
“tag_map”：用法和分类别名是一样的。

日期和时间格式（Date / Time format）

# Date / Time format
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-MM-DD
time_format: HH:mm:ss

日期格式，一般都是默认。

# Pagination
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

分页，如果“per_page:0”就会关闭分页功能。目前设置的是每页显示十篇文章。且显示的分页目录是page页面。

扩展设置（Extensions）

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
# theme: landscape
theme: next

挑选和初步配置Hexo主题已详细说明，不再赘述。

部署（Deployment）

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: 
branch:

从零开始新建Hexo博客已详细说明，不再赘述。

主题配置文件

主题配置文件功能清单

一级名称	二级名称	配置类型
站点信息设置（Site Information Settings）	设置favicon图标	优化配置
	设置默认关键字	优化配置
	Rss设置	优化配置
	建站时间	基础配置
	Canonical标签	优化配置
目录设置（Menu Settings）	目录结构
	目录图标
主题设置（Scheme Settings）		基础配置
字体设置（Font Settings）		优化配置
侧边栏设置（Sidebar Settings）	社交链接设置（Social Links）	优化配置
	社交链接图标设置（Social Links Icons）	优化配置
	侧边栏头像设置（Sidebar Avatar）	基础配置
	侧边栏内容设置（Table Of Contents in the Sidebar）	优化配置
	4.0证书（Creative Commons 4.0 International License）	优化配置
	侧边栏位置相关	优化配置
	友情链接设置（Blogrolls）	优化配置
Misc主题设置（Misc Theme Settings）		优化配置
第三方服务设置（Third Party Services Settings）		优化配置
不要碰的设置		基础配置

主题配置文件的详细解释参见Next主题配置文件说明

完

声明: 本文转载需标明出处，禁止用于商业目的。

ChangeLog

20161110 新建
20161110 发布
20161111 更新
20161112 更新