1.3基本配置
基本配置
文件夹目录
1 | . |
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 中没有指定 updated 时 updated 的取值 |
mtime |
1.8 分页
参数 | 描述 | 默认值 |
---|---|---|
per_page |
每页显示的文章量 (0 = 关闭分页功能) | 10 |
pagination_dir |
分页目录 | page |
文件中两个per_page
的分页条数值为6
的倍数,如:12
、18
等,这样文章列表在各个屏幕下都能较好的显示。
1.9 部署托管
查看1.2托管的相关内容
deploy下面是部署的相关配置
repo:仓库
branch:分支
2.package.json
应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装,您可以自由移除。项目所需模块项目的配置信息。
1 | package.json{ |
3.scaffolds
模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。
Hexo的模板是指在新建的文章文件中默认填充的内容。例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。
3.1 配置新建页面模板
进入目录 /scaffolds/post.md
1 | --- |
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 |
|
-
2021-08-03
-
2021-07-24
-
2021-07-24
-
2021-07-24
-
2021-07-26