本文翻译自官方文档,如需查看最新版本,请 点击
你的配置可以写在 _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
最后编辑于 :2017.12.06 07:57:57
©著作权归作者所有,转载或内容合作请联系作者 平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。