Hexo的基本使用

发表于 | 分类于

创建博客

1
hexo new "博客标题"

发布博客

先清理缓存，一般可能会由于本地缓存而导致发布没有生效（可选）

1
hexo clean

发布和部署

1
hexo g -d

以上命令其实和：1. hexo g，2. hexo d 是一样的。

另外：发布的时候需要输入github用户名和密码，如果输入密码时报错：

1
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.

就把输入密码时换成你的personal access token就可以了。这个personal access token可以在github->Settings->Developer settings->Personal access tokens添加。

更换主题

推荐人气最佳的next主题，其他更换主题的方式都差不多的

  • 1.安装
1
git clone https://github.com/theme-next/hexo-theme-next.git themes/next
  • 2.修改

打开根目录下配置文件_config.yml, 找到theme项，修改为以下

1
theme: next

修改主题配置文件

一 修改主题布局

在根目录下

1
vi themes/next/_config.yml

找到

1
2
3
4
5
# Schemes
#scheme: Muse
#scheme: Mist
scheme: Pisces
#scheme: Gemini

根据自己需要，打开相应的scheme项，即可浏览相应的效果。我比较喜欢scheme: Pisces，左侧是栏目，右侧显示内容。

二 增加标签和分类

在根目录下

1
vi themes/next/_config.yml

找到

1
2
3
4
5
6
7
8
9
menu:
  home: / || home
  #about: /about/ || user
  tags: /tags/ || tags
  categories: /categories/ || th
  archives: /archives/ || archive
  #schedule: /schedule/ || calendar
  #sitemap: /sitemap.xml || sitemap
  #commonweal: /404/ || heartbeat

打开主题配置文件里面的menu项，接着打开相应的子配置项tags和categories。

2.1 分类

  • 2.1.1 新建一个页面，命名为 categories 。命令如下：
1
hexo new page categories
  • 2.1.2 编辑刚新建的页面，将页面的类型设置为 categories ，主题将自动为这个页面显示所有分类。
1
2
3
4
title: 分类
date: 2019-10-07 21:27:11
type: "categories"
---
  • 2.1.3 关联博客

在文章头部，添加

1
categories: iOS

这样就关联到了iOS分类了。

  • 2.1.4 二级分类

有时候可能需要添加二级分类，比如iOS下面有Swift和Objective-C， 那么二级分类也很简单，直接在文章的头部的分类中依次添加一级分类、二级分类。比如

iOS分类下有一个Swift分类

1
2
3
4
5
6
7
8
---
title: Hello, swift!
date: 2019-11-04 20:01:18
categories: 
- iOS
- Swift
tags: Swift
---

iOS分类下再有一个Objective-C分类

1
2
3
4
5
6
7
8
---
title: Hello, Objective-C!
date: 2019-11-04 20:01:18
categories: 
- iOS
- Objective-C
tags: OC
---

2.2 标签

  • 2.2.1 新建一个页面，命名为tags 。命令如下：
1
hexo new page "tags"
  • 2.2.2 编辑刚新建的页面，将页面的类型设置为 tags ，主题将自动为这个页面显示标签云。
1
2
3
4
title: 标签
date: 2019-10-07 21:27:11
type: "tags"
---

三 添加头像

编辑主题的 _config.yml，新增字段avatar， 值设置成头像的链接地址。

其中，头像的链接地址可以是：
1 完整的互联网 URL，例如：https://avatars1.githubusercontent.com/u/32269?v=3&s=460
2 站点内的地址，例如：
◦ /uploads/avatar.jpg 需要将你的头像图片放置在 站点的 source/uploads/（可能需要新建uploads目录）
◦ /images/avatar.jpg 需要将你的头像图片放置在 主题的 source/images/ 目录下。

在根目录下

1
vi themes/next/_config.yml

找到并打开avatar: /images/avatar.jpg

1
2
3
4
# Sidebar Avatar
# in theme directory(source/images): /images/avatar.gif
# in site  directory(source/uploads): /uploads/avatar.gif
avatar: /images/avatar.jpg

四 文章截断

在themes/next/_config.yml下开启

1
2
3
auto_excerpt:
  enable: true
  length: 150

五 添加文章阅读次数

详细请查看：添加文章阅读次数 ，若访问出现问题，查看：Leancloud访客统计插件重大安全漏洞修复指南。

提示：在部署插件过程中或在leancloud官网注册的时候，要把账号密码记下来，比如我就是放在手机的备忘录中，不然后期部署可能会有麻烦。

五 添加本地搜索

添加百度/谷歌/本地 自定义站点内容搜索

  • 安装 hexo-generator-searchdb，在站点的根目录下执行以下命令：
1
$ npm install hexo-generator-searchdb --save
  • 编辑 站点配置文件，新增以下内容到任意位置：
1
2
3
4
5
search:
  path: search.xml
  field: post
  format: html
  limit: 10000
  • 编辑 主题配置文件，启用本地搜索功能：
1
2
3
# Local search
local_search:
  enable: true

更多可以查看：第三方服务

本文已涉及或未涉及的配置详情可见：hexo-theme-next主题在github的使用配置文档说明