hexo-theme-blank 文档-主题安装

目录

  1. 1. 安装
  2. 2. 平滑升级
  3. 3. 标签页
  4. 4. 分类
  5. 5. 归档页
  6. 6. 创建友情链接页面
  7. 7. 404页面
  8. 8. 本地搜索
  9. 9. 开始写作
    1. 9.1. 推荐的 Front-matter 设置
  10. 10. 致谢
  11. 11. 补充

hexo-theme-blank 文档一 ,这篇文章,介绍 blank 主题的安装以及各种页面的生成。

安装

  • 在hexo根目录
1
git clone https://github.com/a2396837/hexo-theme-blank.git themes/blank
  • 修改站点配置文件 _config.yml ,把主题改为 blank

平滑升级

为了主题的平滑升级, blank 使用了 data files 特性。

推荐把主题默认的配置文件 _config.yml 复制到 Hexo 工作目录下的 source/_data/blank.yml,如果 source/_data 的目录不存在那就创建一个。

注意:如果创建了 blank.yml ,它将会替换主题目录下的 _config.yml ,之后你只需要在 blank 主题目录下 git pull 就能平滑升级主题啦!
当你通过 git pull 升级主题后,请检查 _config.yml 是否有新的配置项,如果有,请把新的配置项复制粘贴在 blank.yml

标签页

  1. 前往你的 Hexo 博客的根目录
  2. 输入 hexo new page tags
  3. 你会找到 source/tags/index.md 这个文件
  4. 修改这个文件:
1
2
3
4
5
6
---
title: 标签
date: 2020-04-04 13:15:29
type: 'tags'
comments: false
---

分类

  1. 前往你的 Hexo 博客的根目录
  2. 输入 hexo new page categories
  3. 你会找到 source/categories/index.md 这个文件
  4. 修改这个文件:
1
2
3
4
5
6
---
title: 分类
date: 2020-04-06 12:44:34
type: 'categories'
comments: false
---

归档页

  1. 前往你的 Hexo 博客的根目录
  2. 输入 hexo new page archives
  3. 你会找到 source/archives/index.md 这个文件
  4. 修改这个文件:
1
2
3
4
5
6
---
title: 归档
date: 2020-04-05 12:06:45
type: 'archives'
comments: false
---

创建友情链接页面

  1. 前往你的 Hexo 博客的根目录
  2. 输入 hexo new page link
  3. 你会找到 source/link/index.md 这个文件
  4. 修改这个文件:
1
2
3
4
5
---
title: 友情链接
date: 2020-04-27 13:16:03
type: link
---
  1. source\_data 下创建 links.yml ,依照下面格式写入友情链接
  • 例如(乱序):
1
2
3
4
5
6
7
8
9
- name: DmxZ
link: https://dmx.pub/
avatar: https://dmx.pub/img/avatar.png
info: 欢迎来到 DmxZ 的自留地!

- name: DmxZ
link: https://dmx.pub/
avatar: https://dmx.pub/img/avatar.png
info: 欢迎来到 DmxZ 的自留地!
  • 更推荐的写法:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1:
name: DmxZ
link: https://dmx.pub
avatar: https://dmx.pub/img/avatar.png
info: 欢迎来到 DmxZ 的自留地!

2:
name: DmxZ
link: https://dmx.pub
avatar: https://dmx.pub/img/avatar.png
info: 欢迎来到 DmxZ 的自留地!

3:
name: DmxZ
link: https://dmx.pub
avatar: https://dmx.pub/img/avatar.png
info: 欢迎来到 DmxZ 的自留地!

404页面

主题自带一个很简单的 404 页面 ,如图

如果不想要这个样式,可以在主题配置文件中把它关掉

1
2
3
4
# 一个内置的简单404页面
page_404:
enable: false
subtitle: 'Oops! Page not found.'

,然后把你的 404.html 放在主题目录 themes/blank/source

本地搜索

  • 把下面的代码放在根目录下的 _config.yml
1
2
3
4
search:
path: search.xml
field: post
content: true
  • 在主题配置文件中把 local_search: enable: true

开始写作

推荐的 Front-matter 设置

1
2
3
4
5
6
7
8
9
10
---
title: {{ title }}
date: {{ date }}
comments: false
auto_excerpt: true
toc: true
tags:
categories:
description:
---
参数 描述 默认值
title 标题 文章的文件名
date 时间 文件建立日期
comments 是否显示评论 true
auto_excerpt 是否自动摘要 true
toc 是否显示目录 true
tags 标签
categories 分类
description 描述

致谢

本人代码小白,所以在制作这个主题,参考了下列几位大佬的主题,非常感谢!

  1. hexo
  2. hojun
  3. CaiCai
  4. Next
  5. fexo
  6. royce
  7. butterfly

补充

  1. 写作不易,请给我一个免费的Star⭐
  2. 如果觉得主题有什么补充,请协助我改进!
  3. 如果在安装主题过程有什么问题,欢迎提 Issues!
  4. 协助我开发主题:可以Fork一份,改好后,可以向我发起 Pr
hexo theme blank
hexo-theme-blank 文档-进阶设置
翻新:hexo-theme-blank
© 2020 DmxZ
Powered by hexo | Theme is blank