本文翻译自官方文档，如需查看最新版本，请 点击
你的配置可以写在 _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/
Directory
| 设置 |
解释 |
默认 |
| 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 |
Pagination
| 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
