Hexo踩坑指南

七月 08, 2020

Hexo

此文主要整合了用Hexo搭建博客时遇到的一些疑难杂症

不会js css也能也能用hexo搭建博客网上已经有各种比较成熟的资源和解决方案

当然会更好可以有更高自由度的体验

hexo提供了框架剩下的只要跟着搭积木(插件)就行了

hexo搭建的主要流程网上已经有许多详细教程此处不再赘述

在搭建之前请先下载安装 node.js git hexo

npm（Node Package Manager，节点包管理器）是NodeJS的包管理器，用于节点插件的管理（包括安装，卸载和管理依赖等）。npm是随同新版的NodeJS一起安装的包管理工具，所以我们需要安装NodeJS。

安装完node.js后在控制台输入

1	npm install cnpm -g --registry=https://registry.npm.taobao.org

用cnpm 从淘宝源中下载所需插件

git 主要是用于clone github中的主题和其他插件

在部署仓库上有三种选择 github / gitee / coding 仓库

github 国外网站加载缓慢但可以自动部署支持Gittalk

gitee 码云仓库加载快但是需要付费才能自动部署每次hexo d 都得到仓库里手动更新

coding 相较之下加载快而且支持自动部署但是地址难记

关于主题这篇博客中罗列了一些 hexo官网也有展示但是不知道怎么下载

还得在github渠道git clone

win10环境下本地部署到github时经常会出现

HttpRequestException encountered报错

解决方法一

尝试后仍不能解决

之后将网站根目录的配置文件 _config.yml 中的

deploy:
  type: git
  repo: 
    github: git@github.com:PeiGiZhu/PeiGiZhu.github.io.git
    gitee: https://gitee.com/peigizhu/PeiGiZhu.git
    coding: https://e.coding.net/peigizhu/peigizhu/peigizhu.git
  branch: master

github: 后面的仓库地址从 http:// 改为 git@ 后就不再出现

更改为git@ 需要本地和仓库间需要ssh公钥验证才能从本地直接将代码部署到仓库

如何生成ssh key

如何用ssh key部署

本地生成的ssh key(public key)可以反复使用

此处以gitee和coding部署流程为例 github仓库操作类似

这篇博客里有图文流程可以参考

hexo常用指令

部署时记得先清理缓存

1	hexo clean & hexo g -d ///一次性清理&生成&部署

可视化编辑工具-Typora下载

大佬自建博客详细指导

Hexo功能&插件优化

在更新文章时发现的问题

文章出现乱码：尝试将文章.md 文件用笔记本打开另存为时设置编码为 UTF-8

博客中进入某个标签再点菜单中的首页加载十分缓慢

多数情况是由于引用了google源字体导致加载缓慢解决方案

但是由于使用主题不同本人没有贸然修改(主要不懂这方面)

如何在百度上搜素到自己的博客而不是以链接的形式参考此处

注意！私有仓库的前提下再使用第二种主动推送

部署到仓库后网页没有更新如果是gitee仓库请到gitee page 手动更新

若不同浏览器打开博客后内容不同尝试清理浏览器缓存后重新加载

typora插入图片网页中不显示？原因

可以在要编辑的md同目录下新建一个img文件夹

然后在要插入的地方写入以下html语句

1	<img src="img/xxx.jpg" width="100px" height="100px" />

有些主题没有自带百度统计功能需要手动写入

具体方法参考此处

置顶功能没有达到理想效果参考

Note：主题(themes)不同, 实现/解决方案不同 ,不同themes间并不能完全移植

更多资源/问题在优化本站时会再更新整合

查看评论