1.3基本配置

基本配置

文件夹目录

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

1._config.yml

网站的 配置 信息,您可以在此配置大部分的参数。

1.1 网站相关

参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述,与搜索引擎相关,网站关键词
author 您的名字
language 网站使用的语言 参考:zh-Hans,zh-CN
timezone 网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York, Japan, 和 UTC 。参考:’Asia/Shanghai’

1.2 网址

参数 描述
url 网址,写github地址
root 网站根目录
permalink 文章的 永久链接 格式
permalink_defaults 永久链接中各部分的默认值
参数 结果
:year/:month/:day/:title/ 2013/07/14/hello-world
:year-:month-:day-:title.html 2013-07-14-hello-world.html
:category/:title foo/bar/hello-world

1.3 theme主题

默认主题:lanscape

安装:next

安装和配置相关在以后教程

1.4 目录

参数 描述 默认值
source_dir 资源文件夹,这个文件夹用来存放内容。 source
public_dir 公共文件夹,这个文件夹用于存放生成的站点文件。 public
tag_dir 标签文件夹 tags
archive_dir 归档文件夹 archives
category_dir 分类文件夹 categories
code_dir Include code 文件夹,source_dir 下的子目录 downloads/code
i18n_dir 国际化(i18n)文件夹 :lang
skip_render 跳过指定文件的渲染。匹配到的文件将会被不做改动地复制到 public 目录中。您可使用 glob 表达式来匹配路径。

1.5 文章

参数 描述 默认值
new_post_name 新文章的文件名称 :title.md
default_layout 预设布局(post ,page,draft) post
auto_spacing 在中文和英文之间加入空格 false
titlecase 把标题转换为 title case false
external_link 在新标签中打开链接 true
external_link.enable 在新标签中打开链接 true
external_link.field 对整个网站(site)生效或仅对文章(post)生效 site
external_link.exclude 需要排除的域名。主域名和子域名如 www 需分别配置 []
filename_case 把文件名称转换为 (1) 小写或 (2) 大写 0
render_drafts 显示草稿 false
post_asset_folder 启动 Asset 文件夹 false
relative_link 把链接改为与根目录的相对位址 false
future 显示未来的文章 true
highlight 代码块的设置, 请参考 Highlight.js 进行设置
prismjs 代码块的设置, 请参考 PrismJS 进行设置

1.6 分类 & 标签

参数 描述 默认值
default_category 默认分类 uncategorized
category_map 分类别名
tag_map 标签别名

1.7 日期 / 时间格式

Hexo 使用 Moment.js 来解析和显示时间。

参数 描述 默认值
date_format 日期格式 YYYY-MM-DD
time_format 时间格式 HH:mm:ss
updated_option 当 Front Matter 中没有指定 updatedupdated 的取值 mtime

1.8 分页

参数 描述 默认值
per_page 每页显示的文章量 (0 = 关闭分页功能) 10
pagination_dir 分页目录 page

文件中两个per_page的分页条数值为6的倍数,如:1218等,这样文章列表在各个屏幕下都能较好的显示。

1.9 部署托管

查看1.2托管的相关内容

deploy下面是部署的相关配置

repo:仓库

branch:分支

2.package.json

应用程序的信息。EJS, StylusMarkdown renderer 已默认安装,您可以自由移除。项目所需模块项目的配置信息。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
package.json{
"name": "hexo-site",
"version": "0.0.0",
"private": true,
"hexo": {
"version": ""
},
"dependencies": {
"hexo": "^3.8.0",
"hexo-generator-archive": "^0.1.5",
"hexo-generator-category": "^0.1.3",
"hexo-generator-index": "^0.2.1",
"hexo-generator-tag": "^0.2.0",
"hexo-renderer-ejs": "^0.3.1",
"hexo-renderer-stylus": "^0.3.3",
"hexo-renderer-marked": "^0.3.2",
"hexo-server": "^0.3.3"
}
}

3.scaffolds

模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。

Hexo的模板是指在新建的文章文件中默认填充的内容。例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。

3.1 配置新建页面模板

进入目录 /scaffolds/post.md

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
title: {{ title }}
date: {{ date }}
updated:
img:
top: true
cover: true
coverImg:
toc: true
mathjax:false
summary:
password:
categories:
tags:
keywords:
---

top:首页推荐文章

cover:首页轮播封面
coverImg:首页轮播的封面,没有显示默认

password:阅读验证密码,为SHA256加密后的密码

toc:开启toc,生成目录。插件hexo-toc

mathjax:启动数学公式支持

summary:文章摘要,缶则截取部分文章内容作为摘要

keywords:关键词,SEO时使用

updated:更新时间,网上没找见直接的解决办法,搭配主题next可以实现

4.source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。

5.themes

主题 文件夹。Hexo 会根据主题来生成静态页面。

6.node_modules

依赖包

7.public

存放的是生成的页面

8.db.json

source解析所得到的

9.其他

source新建404.md

1
2
3
4
5
6
7
---
title: 404
date: 2020-05-14 10:45:11
type: "404"
layout: "404"
description: "你来到了没有知识的荒原 "
---