Hexo配置指南

本文翻译自官方文档，如需查看最新版本，请点击

你的配置可以写在 _config.yml 里，或者用一个替代的配置文件，见本文末尾

网站配置

设置	解释
title	网站的标题
subtitle	网版的副标题
description	网站的描述
author	作者名字
language	网站的语言，使用 2-letter ISO-639-1 code.默认为en
timezone	网站的时区。Hexo使用你计算机默认的时区。你可以在这里找到列表。例如：America/New_York, Japan, UTC

URL

设置	解释	默认值
url	网站的URL
root	网站的根目录
permalink	网站的永久链接	:year/:month/:day/:title
permalink_defaults	每一节永久链接的默认字符

网站在子目录的情况
如果你的网站在一个子目录（例如http://example.org/blog）设置url为http://example.org/blog并且设置root为/blog/

设置	解释	默认
source_dir	源文件夹，放置你的内容的地方	source
public_die	公开文件夹，放置生成的站点	public
tag_dir	Tag 文件夹	tags
archive_dir	Archive 文件夹	archives
category_dir	Category 文件夹	categories
code_dir	Include code 文件夹	downloads/code
i18n_dir	i18n 文件夹	:lang
skip_render	生成时忽略的文件夹。你可以使用 glob expressions 来进行路径匹配

Writing

设置	解释	默认
new_post_name	新文章文件名格式	:title.md
default_layout	默认布局	post
titlecase	是否转换标题到 title case	false
external_link	是否在新的tab里打开外部链接	true
filename_case	转换文件名为： 1.小写 2.大写	0
render_drafts	显示草稿	false
relative_link	使链接相对于根目录？	false
future	显示未来的文章	true
highlight	代码块设置

Category & Tag

Setting	Description	Default
default_category	默认类别	uncategorized
category_map	类别
tag_map	标签

Date / Time format

Hexo 使用 Moment.js 处理日期

Setting	Description	Default
date_format	日期格式	YYYY-MM-DD
time_format	时间格式	HH:mm:ss

Setting	Description	Default
per_page	每页现实的文章数量，设置为0则取消分页	10
pagination_dir	分页文件夹	page

Extensions

Setting	Description
theme	主题名字，false则禁止主题
deploy	部署设置

使用替代的配置文件

用户自定义的配置文件可以通过在你的 hexo 命令中加上 --config 并跟随一个JSON或YAML配置文件的路径来设置
，或者使用逗号分隔开多个配置文件。

# use 'custom.yml' in place of '_config.yml'
$ hexo server --config custom.yml
# use 'custom.yml' & 'custom2.json', prioritizing 'custom2.json'
$ hexo server --config custom.yml,custom2.json

使用多个文件组合所有的配置文件并且保存合并设置到_multiconfig.yml。在后面的值拥有优先权。这个特性可以拥有任意数量的JSON或YAML文件，并且允许任意深的目录。注意，列表中不允许有空格。

例如：在上面的例子中，如果 foo:bar 在 custom.yml中，但是 "foo": "dinosaur" 在 custom2.json 中，_multiconfig.yml会包含foo: dinosaur

网站配置

URL

网站在子目录的情况

Directory

Writing

Category & Tag

Date / Time format

Pagination

Extensions

使用替代的配置文件