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) 设置urlhttp://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

【Hexo配置指南】使用多个文件组合所有的配置文件并且保存合并设置到_multiconfig.yml。在后面的值拥有优先权。这个特性可以拥有任意数量的JSON或YAML文件,并且允许任意深的目录。注意,列表中不允许有空格。
例如:在上面的例子中,如果 foo:barcustom.yml中, 但是 "foo": "dinosaur"custom2.json 中,_multiconfig.yml会包含foo: dinosaur

    推荐阅读