概述
看懂配置文件, 自己想怎么弄就怎么弄!!
Hexo
站点配置文件参数介绍来自官网本文除了搬运官网中文外, 还会翻译 英文官网内容, 同时加上自己的见解
常用配置项
配置项名 | 描述 |
---|---|
Site | 站点信息配置, 最开始需要修改 |
Url | 主要修改里面的站点网址 |
deploy | 部署的配置 |
Site
参数 | 描述 |
---|---|
title | 网站标题 |
subtitle | 网站副标题 |
description | 网站描述 |
author | 您的名字 |
language | 网站使用的语言,Next 主题中文为zh-CN |
timezone | 网站时区。Hexo 默认使用您电脑的时区。查看时区列表。比如说:Asia/Shanghai、UTC |
其中,
description
主要用于SEO,告诉搜索引擎一个关于您站点的简单描述,通常建议在其中包含您网站的关键词author
参数用于主题显示文章的作者
Url
参数 | 描述 | 默认值 |
---|---|---|
url | 网址 | |
root | 网站根目录 | |
permalink | 文章的 永久链接 格式 | :year/:month/:day/:title/ |
permalink_defaults | 永久链接中各部分的默认值 |
如果您的网站存放在子目录中,
例如 http://yoursite.com/blog ,
则请将您的url
设为 http://yoursite.com/blog 并把root
设为/blog/
PS: 永久链接默认格式的 层级太深,修改永久链接的方法 -> Hexo 修改永久链接的默认格式
Directory
参数 | 描述 | 默认值 |
---|---|---|
source_dir | 资源文件夹,这个文件夹用来存放内容。 | source |
public_dir | 公共文件夹,这个文件夹用于存放生成的站点文件。 | public |
tag_dir | 标签文件夹 | tags |
archive_dir | 归档文件夹 | archives |
category_dir | 分类文件夹 | categories |
code_dir | Include code 文件夹 | downloads/code |
i18n_dir | 国际化(i18n)文件夹 | :lang |
skip_render | 跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。比如说想跳过MyPage 目录下所有文件的渲染,可使用skip_render: mypage/**/* , 这样会原样输出source/mypage/ ,而不修改它 |
Writing
参数 | 描述 | 默认值 |
---|---|---|
new_post_name | 新文章的文件名称 | :title.md |
default_layout | 预设布局 | post |
auto_spacing | 在中文和英文之间加入空格 | false |
titlecase | 把标题转换为 title case | false |
external_link | 在新标签中打开链接 | true |
filename_case | 把文件名称转换为 (1) 小写或 (2) 大写 | 0 |
render_drafts | 显示草稿 | false |
post_asset_folder | 启动 Asset 文件夹 | false |
relative_link | 把链接改为与根目录的相对位址 | false |
future | 显示未来的文章 | true |
highlight | 代码块的设置 |
Home page setting
这里的参数是设置首页的,一般不动它
参数 | 描述 | 默认值 |
---|---|---|
index_generator | 网站首页生成器, 有path , per_page , order_by 参数 | |
path | 博客首页所在的路径 | '' |
per_page | 一页显示的文章数,默认为10,即一页显示10篇文章。设置为0时表示禁止分页 | 10 |
order_by | 文章的排序方式,默认按时间降序 | -date |
Category & Tag
参数 | 描述 | 默认值 |
---|---|---|
default_category | 默认分类 | uncategorized |
category_map | 分类别名 | |
tag_map | 标签别名 |
Date / Time format
Hexo
使用 Moment.js 来解析和显示时间。
参数 | 描述 | 默认值 |
---|---|---|
date_format | 日期格式 | YYYY-MM-DD |
time_format | 时间格式 | H:mm:ss |
Pagination
参数 | 描述 | 默认值 |
---|---|---|
per_page | 每页显示的文章量 (0 = 关闭分页功能) | 10 |
pagination_dir | 分页目录 | page |
Extensions
参数 | 描述 |
---|---|
theme | 当前主题名称。值为false时禁用主题 |
deploy | 部署的设置,可以部署git、leancloud等,见deploy例子 |
deploy
1 | # 设置多个的话,用-type来设置 |
Include/Exclude Files/Folders
在配置文件中,设置include
/ exclude
以使hexo
显式处理或忽略某些文件/文件夹。
参数 | 描述 |
---|---|
include | Hexo默认忽略的隐藏文件和文件夹,可设置此字段将使Hexo处理它们 |
exclude | 设置 Hexo 忽略的文件列表 |
Sample
1 | # Include/Exclude Files/Folders |