hexo使用问题汇总

2022-10-08

博客 / hexo

字数统计: 1.1k | 阅读时长≈ 4 分钟

本地搭建 hexo 框架

参考链接：

从零开始免费搭建自己的博客(一)——本地搭建hexo框架

我选择的主题与参考链接中作者使用的主题一样 ayer，以下涉及的部分需求会与主题关联。

使用过程中遇到的问题及解决过程

1. 执行 hexo deploy 后报错`Error Deployer not found: git`

配置_config.yml 文件中的deploy字段后报错Error Deployer not found: git

deploy:
  type: git
  repo: git@github.com:ligongzhao/ligongzhao.github.io.git
  branch: main

解决方法，安装 hexo-deployer-git 插件，在站点目录下安装插件即可。
1
npm install hexo-deployer-git --save

2. 分类、标签和关于我菜单点击报错

本地启动 hexo 后，发现侧边菜单栏中的 分类 ， 标签 和关于我，点击报错。

解决方法：

参考主题作者博文：

主题配置分类

具体操作如下：

分类

1	hexo new page categories

然后将以下复制到 source/categories/index.md 文件

---
title: categories
type: "categories"
layout: "categories"
---

关于我

关于我的配置为 about，即一个post文件

1	hexo new about

会在 _post 目录下创建一个 about.md 文件，然后把需要的内容写在里面即可。

如果需要贴图片，想放在本地，可以参考官方资源目录的操作方式，即在项目的 _config.yml 配置文件中修改 post_asset_folder 值为 true，

即， post_asset_folder: true，这样再执行上面新建 post 文件时，会创建一个与文件同名的目录，将图片放入目录，文件中使用相对路径引用即可。

3. 文章如何分目录存放

使用 hexo new 命令创建的 post 文件时，默认是直接生产在 _post 目录下。如果文件过多时所有文件放在一个目录下容易显得凌乱。如何对文件进行分类且 hexo 能识别呢？

解决方法：

1	hexo new <文章标题> -p <文章相对路径>

例如：

1	hexo new "认识虚拟化" -p "学习笔记\容器&虚拟化\认识虚拟化.md"

如何批量导入？

将文件按照指定目录复制到 _post 目录下，文件中添加文件前缀 Yaml Front Matter ，可以参考 scaffolds\post.md 文件中的内容。

例如：

先创建目录 学习笔记\容器&虚拟化\，然后在 认识虚拟化.md 文件头中添加下面内容。

---
title: 认识虚拟化
permalink: 认识虚拟化.html
date: 2022-04-03 12:21:28
updated: 2022-10-04 23:16:19
tags: 
- 容器&虚拟化

categories: 
- [容器&虚拟化]
---

可以通过写脚本批量处理。

4. 如何在主页上仅展示标题，不展示摘要

默认主页中的文章是展示标题和正文的。

如果需要展示正文摘要，然后添加 更多 按钮，可以通过在文章中添加  来截取并生成更多的按钮；

如果要满足仅展示标题，不展示摘要需求，则需要修改 ayer 主题配置文件 _config.yml 的参数。将 excerpt_all 的参数修改为 false，即 excerpt_all: false 。

hexo 分支问题

hexo双分支管理有时会出现一些问题，诸如本地与远端分支不同，pull失败，分支文件混淆等问题，按照以下方式操作避免并解决已存在的问题

查看本地分支，输入命令
1
git branch -a

　　绿色的为当前选中分支

查看远端分支，输入命令
1
git branch -r

当本地分支与远端分支不同时，采取下列对应情况处理

远端已有main和hexo分支，本地只有main分支，则执行以下命令
1
git checkout --track origin/hexo

本地会新建一个分支hexo并自动跟踪远端

本地已有main和hexo分支，远端只有main分支，则执行以下命令

1	git push origin hexo

将本地分支推送到远端，并在远端建立hexo分支

若无法关联，需要先输入命令关联

1	git remote add origin '远端仓库地址'

远端仓库地址若设置SSH后，使用git@github.com:’用户名‘/’仓库名‘.git