关于Hexo的避坑指南

Dear 丶 2023-05-22 22:39 10阅读 0赞

# 关于Hexo的避坑指南 #

## 一.构建文件时无法生成index.html文件 ##

#### 部署到GitHub后主页空白出现如下字符: ####

extends includes/layout.pug block content include includes/recent-posts.pug include includes/partial

##### 问题:一般为缺少hexo所需的插件,可通过查看 npm 安装各 hexo 插件的情况 #####

npm ls --depth 0

###### 1.查看是否缺少插件: ######

![查看是否缺少插件][format_png]

###### 2.如图,我这里缺少 下面的五个插件,只需要把缺少的插件补上即可 ######

npm i hexo-deployer-git --save
    npm i hexo-browsersync --save
    ......
    ......

安装缺少的插件

###### 3.安装好插件后再次检查一次是否安装完成 ######

![mark][]

###### 4.再次构建,无问题后部署到GitHub上 ######

![mark][mark 1]

##### \*\*\*解决此问题只需要逐个安装所缺的插件 ,全部安装好后再次构建即可.\*\*\* #####

## 二.部署到GitHub后的自定义域名解析 (以阿里云为例) ##

### 1.首先找到阿里云控制台的域名解析页面 ###

![mark][mark 2]

![mark][mark 3]

### *2.在解析中添加CNAME类型的记录 记录值为你GitHub的博客网址 ,如我的GitHub网址为 : Aealen.github.io* ###

![mark][mark 4]

### 3.在hexo的source目录中创建CNAME文件,没有任何后缀,用编辑器打开,在第一行填入域名 ###

#### 至于为什么在source文件夹,在 [之前的一篇文章][Link 1] 中有说明. ####

这里以我的博客的域名为例:

![mark][mark 5]

#### ***注意: 只能填一行*** ####

## 三.部署到github的配置文件中git需要加引号 ‘git’ ,否则无法部署,此问题暂时只有我遇到,原因不明. ##

![mark][mark 6]

把git打上引号即可

## 四.在友链link的index.md中添加type: "link"后构建出错,如图: ##

![mark][mark 7]

### 1.首先排除是否没有安装pug以及 stylus渲染器. ###

#### 如果你沒有pug以及stylus的渲染器，請下載安裝： ####

npm install hexo-renderer-pug hexo-renderer-stylus --save or yarn add hexo-renderer-pug hexo-renderer-stylus

#### 确认安装 ####

![mark][mark 8]

### 2.根本问题还是没有在hexo\\source下创建\_data文件夹然后再创建link.yml文件,并再文件内添加友链. ###

![mark][mark 9]

全部修改好后,再次构建检查无事后再部署.

***注意: 注意格式,注意空格!!***

## 五.修改card卡片颜色,也就是侧边栏和信纸的颜色,白色略过于单调 ##

### 在 \\hexo\\themes\\Butterfly\\source\\css\\var.styl文件中找到 card-bg位置 后面修改颜色即可 ###

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-AlVJCYyE-1588677135350)(http://qiniuph.fangmingxuan.com/blog/20200420/uwTtQsqanKW6.png?imageslim)\]

## 六.去除网页中超链接的下划线 ##

## 在遇到问题后持续更新… ##

## 更多文章在: 博客: blog.fangmingxuan.com ##

[\[方·圆–方寸之间 丨 博客 \]][_ _]

[format_png]: /images/20230521/3b153b26c37d41238ffc731490648048.png
[mark]: /images/20230521/64781f39191543feb603bb7c621826cc.png
[mark 1]: /images/20230521/d84c23963ff14aac9e1862632d705e0d.png
[mark 2]: /images/20230521/c9e62db3b59b4333aa1458db3fa34674.png
[mark 3]: /images/20230521/47f3501effc14611bd9319f03c673d73.png
[mark 4]: /images/20230521/ecafef396b524a709c92334212a13fc4.png
[Link 1]: http://blog.fangmingxuan.com/2020/04/14/Hexo%E5%9C%A8%E9%83%A8%E7%BD%B2%E5%88%B0Github%E5%90%8ECNAME%E6%96%87%E4%BB%B6%E4%BC%9A%E6%B6%88%E5%A4%B1%E6%88%96%E6%94%B9%E5%8F%98%E7%9A%84%E8%A7%A3%E5%86%B3%E6%96%B9%E6%B3%95/
[mark 5]: /images/20230521/b4ebd48458fb4810aa284d3578ea78b2.png
[mark 6]: /images/20230521/2651f64407a6487b806613d6991aa9cf.png
[mark 7]: /images/20230521/c6b28dac3dc0490e88b98988a6ae1c50.png
[mark 8]: /images/20230521/ce24c69921734247992354535734cd29.png
[mark 9]: /images/20230521/5b61945230274ed2afc86ec435543b91.png
[_ _]: http://blog.fangmingxuan.com/