利用Hexo+Github搭建个人博客(记录帖)

准备

一台能联网的电脑,最好能连上GitHub。点击链接试试

如果你没有接触过markdown,建议在电脑上下载typora熟悉一下md的语法。

不用担心有没有基础,反正我是前端零基础纯小白。

让我们开始吧!

尽管CSDN上有关这种搭建方法的文章很多,真正有时效性而且浅显易懂的还是很少。

如果你是windows系统,这是我第一天搭建框架时查阅的最有用的文章,非!常!详!细!

TRHX • 鲍勃:使用 Github Pages 和 Hexo 搭建自己的独立博客【超级详细的小白教程】,以及知乎上这篇吴润:GitHub+Hexo 搭建个人网站详细教程

如果你是linux系统,那么我不知道。

如果你不想安装git和node.js的话,我推荐hexo懒人包bilibili视频:懒人版HEXO搭建,以及两分钟学会最新的用github+便携版hexo做网站服务器教程+绑定域名,还有Portable Hexo的官网

安装过程中出现的问题

不知当讲不当讲,我的node.js装了两遍…第一次安装的时候npm管理总是出问题,害的我改了好几次npm的资源镜像链接,还是淘宝的链接最管用。后来才发现blog根目录和hexo根目录是两个不一样的东西,在两个地方git bash的时候一定要看清现在的位置。

可以参考关于安装hexo遇到的一些问题

hexo搭建博客踩坑

美化/魔改

本人选择的是butterfly主题,这是一款集成了很多实用小功能的主题,作者是香港人,介绍语言是我们能看懂的繁体中文。这个主题本身也比较成熟,已经更新到3.8.3。推荐大家选择主题时要在自己喜欢的基础上,选择一个比较成熟,而且有人更新维护的。

这是butterfly主题的帮助文档:Butterfly 安裝文檔(一) 快速開始

当然,对于不同主题来说,美化的方式也会存在不同,我们需要查阅相关主题的帮助文档来获取信息。

这是butterfly的魔改文章目录:Butterfly 美化/優化/魔改 教程合集

公式/图片

关于公式的插入,参阅的是这几篇文章:

这次彻底解决在Hexo中渲染MathJax数学公式出现的问题!!!

hexo主题渲染latex公式之多行公式显示问题

butterfly主题帮助文档(二)-Math数学

关于图片的插入,这篇文章基本解决:

hexo博客中插入图片失败——解决思路及个人最终解决办法

Hexo 默认文章链接生成规则是按照年、月、日、标题来生成的。一旦文章标题或者发布时间被修改,URL 就会发生变化,之前文章地址也会变成 404,而且 URL 层级很深,不利于分享和搜索引擎收录。如果文章标题中有中文,URL 被转码后会很长,我装了hexo-abbrlink插件,会为每篇生成一个唯一字符串,并不受文章标题和发布时间的影响。

参见 Hexo | 博客文章链接优化之abbrlink
以及图片无法显示的问题:解决:Hexo安装abbrlink插件后asset-image无法显示图片

博客的迁移

如果换了电脑,或者预防电脑损坏而更新不了博客,可以通过在github的仓库创建分支来备份你的文章和配置文件。

具体可以参考(由于俺本人还没用到,所以留着链接等着看):

利用Hexo在多台电脑上提交和更新博客

换电脑后怎么继续维护以前hexo+GitHub创建的个人网站

如何解决github+Hexo的博客多终端同步问题

hexo:更换电脑,如何继续写博客

hexo系列问题之我们换了电脑怎么办

好啦,我们搭建个人博客的旅程就告一段落,如果你也在安装中遇到了问题,可以来跟我探讨一下。(其实我啥也不会,要是我也遇到过这个问题可以帮帮你,否则的话就去指路大佬啦XD)