在GitHub-Page搭建Hexo博客

我打算用hexo结合github pages构建一个轻博客网站,每周发表至少一篇博文。
Hexo建站参考教程

使用hexo建站到github pages的完整教程推荐如下:

https://zhuanlan.zhihu.com/p/78467553

https://segmentfault.com/a/1190000017986794

https://theme-stun.github.io/docs/zh-CN/

https://hexo.io/zh-cn/index.html

https://blog.csdn.net/hhgggggg/article/details/77853665

使用Stun主题

Stun主题比较好看,我还稍微配置了一下可以跟Typora连用(主要是为了能够正常显示插图和附件)。效果如下图:

需要安装的插件列表

  1. Git相关插件,用于Deploy到GitHub Pages上
  2. Search相关插件,方便对站内内容进行搜索
  3. Asset-imager相关插件,方便插图附件之类的

开启评论系统

Gitalk插件是利用GitHub仓库的Issue功能,为了节约空间,我另外开了一个Sea-Comments的仓库作为存储。然后照着以下教程进行操作:

https://www.jianshu.com/p/4242bb065550

https://theme-stun.github.io/docs/zh-CN/advanced/third-part.html#gitalk

https://github.com/gitalk/gitalk

需要注意的是,Stun主题已经嵌入了Gitalk,只要到Stun主题下的_config.yaml下添加自己评论仓库的一些信息即可。

gitalk会出现Error Network报错,弃用~,之后使用valine,评论数据存储在LeanCloud中,如有必要,及时备份。

https://theme-stun.github.io/docs/zh-CN/advanced/third-part.html#valine

常用命令

需要进入到hexo网站的本地根目录下执行命令,以windows系统为例:

1. hexo clean && hexo g && hexo s: 若修改了**_config.yaml**配置文件,需要清除         public目录下所有内容,然后根据新的配置文件重新生成静态网页,并且启动本地服务器
2. hexo clean && hexo d:修改配置后,重新发布到gitee pages上。

注意事项
1. 尽量使用hexo new命令生成 pages或者新的Markdown文件,然后到_posts目录下对 Markdown文件进行编辑修改(使用typora)
2. Markdown文件命名只能为英文或者数字,而标题可以在Markdown文件里边的Front Matter YAML中进行设定(Front Matter YAML设定非常重要,参考链接)。
3. GitHub仓库容量有限(< 1 GB),长期使用个人博客,注意不要插入太多太大的图片,建议是 篇博文图片不超过10张。
4. 博客内容完全公开,注意不要发布违法或者引发舆论的内容,并注意保护个人隐私。

参考内容: https://theme-stun.github.io/docs/zh-CN/