2022/12/03 Sat 22:51    2022/12/03 Sat 23:17

Hexo + Github静态博客的搭建

前言

搭建博客是一直以来自己就想做的事情，18年的时候在好友的怂恿下开始写，不过都是些零零碎碎的。当时用的开源的Gridea这个静态博客，不过后来出了一些问题，所有就一直搁置这个问题（当然零零碎碎的一直在写），现在还是想继续进行下去，对自己写的或者整理的东西进行模块化梳理。相对于比较知名的wordpress以及typecho，hexo作为静态博客不需要自行搭建和维护服务器，可以部署在很多稳定且免费的环境中。

准备环境

安装如下软件

  1. Git
  2. Node & NPM
  3. Hexo

验证安装

在资源管理器右键菜单或开始菜单里，可以找到 Git Bash ，打开后是个命令行界面。分别执行node-v，npm-v命令查看执行的版本：我安装的是8.19.2，没有下载的可以下载最新的版本。

注册账号

  1. 自行注册git账号，前往注册，已有github账号则跳过
  2. 注册vercel账号，可直接与github账号绑定(这一步后面发现其实可以不用)

安装hexo

配置淘宝镜像，加速安装

npm config set registry https://registry.npmmirror.co

安装命令

npm install -g hexo

执行如上命令，安装hexo结果如下则安装成功

执行初始化命令

hexo init {博客名称}

若不指定博客名称，默认为初始化当前目录

本地运行查看博客

hexo serve

发表文章

只需要将md结尾markdown格式的文件放入source_posts下就可以了，再重新执行hexo serve命令即可看到效果

部署到外网

上传github* 创建Pulic仓库Repository name填自己的博客名称，其他不用修改，注意时Public仓库，private可能会构建失败。进入博客目录，即hexo init的那个目录鼠标右键打开Git Bash，顺序执行如下命令

git initgit add .
git commit -m "first commit"
git branch -M main
git remote add origin {github博客仓库url}
git push -u origin main

弹出对话框，输入github账号密码即可。

后续博客文章新增或改动都需要重新上传，命令如下：

git add .git commit -m "hexo blog commit"git push

几个需要注意的地方如下

  1. 环境的配置是十分重要的，比如node.js的安装。_config,yml文件是比较重要的一个文件，一些个性化的东西可以从这个文件中开始入手，注意每次改都要注意；
  2. 关于主题的问题：这里用的是hexo自带的主题配置，选了一个稍微简单的一点，先暂时不要追求花里胡哨的界面，把一些简单的东西先做好，后面有能力和实力之后再尝试做一些创新的东西，主题里面默认的主题不要轻易的删除；
  3. 关于每次上传都需要特定的代码，这是很重要的。

最基础的几个推送命令

  • hexo generate 生成静态文件该命令可以进行相应的简写：hexo g
  • hexo publish [layout] 该命令可以用来发表草稿
  • hexo server启动服务器，默认情况下，访问的网址为：http://localhost:4000/
  • hexo deploy部署网站，相应的简写：hexo d
  • hexo render [file2] …渲染文件
  • hexo migrate 从其他的博客系统迁移内容
  • hexo clean清除缓存文件 (db.json) 和已生成的静态文件 (public)。在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

Push远程仓库的一些步骤

首先在github建立新的仓库，作为你的博客的文件托管，命名需要以username.github.io命名

http://username.github.io,这个网址就是相应的博客的地址，需要把里面的username替换为你的Github账号。主要执行一下的一些操作

  1. git config –global user.name “你的github用户名”
  2. git config –global user.email “你的github注册邮箱”
  3. 生成ssh密钥文件
  4. ssh-keygen -t rsa -C “你的github注册邮箱”
  5. 然后直接三个回车即可，默认不需要设置密码
  6. 然后找到生成的.ssh的文件夹中的id_rsa.pub密钥，将内容全部复制
  7. 添加进入github中的ssh key
  8. 配置成功后
  9. hexo g
  10. hexo s
  11. Hexo d
  12. 完成推送和部署

关于博客图床的搭建

看到别人安利一个图床神器picgo，截图后快捷键上传自动复制Markdown链接，非常的好用，所以在写文件的时候如果配图是可以用到这个软件的。

在配置图床中遇到的几个问题以及解决方案：

  1. 打开github加速就会出现：RequestError: Error: unable to verify the first certificate

    • 解决方法：关掉github加速，为了便于访问github网站，可以用一些浏览器里面的加速插件可以达到同样的效果
    • 这样就不影响登录github网站，又可以在本地进行图床的配置以及图片上传。

  3. 如果关掉加速就会出现：Request failed with status code 404

    • 仔细核对博客的配置，看看是否有问题，一个小点都可能会造成bug

后记

很多东西都还不太成熟，都在部署和完善过程中，一些相应的东西我想在微信公众号和博客中进行相应的同步更新，暂时还是以文字为主。只能慢慢的推进，每一篇都想尽量做好，不过也才刚开始这样去做，难免会有这样那样的问题，好像不可避免，多写和整理几次就会有相应的经验了，就会更加的去注重相应的排版和文风。但是最最最重要的，不要头重脚轻，本末倒置，任何时候都是要以内容为主（虽然排版仍然是十分重要的。）

我的博客地址：

  • https://runnerxr.github.io/
  • title: bear的生活随笔
  • subtitle: 随心所想，随手所记
  • description: ‘记录生活、学习、工作’

配置博客参考链接：

  1. https://post.smzdm.com/p/alxd60g0/
  2. https://zhuanlan.zhihu.com/p/587675343
  3. https://hexo.io/zh-cn/docs/
  4. https://hexo.io/themes/
ToTOP
2018 bear