Hexo+GitHub搭建个人博客

本文最后更新于:2022年5月29日 上午

前言

之前一直都是使用Jeklly+Github Pages搭建的博客,可能是使用久了感觉看上去不是很满意。索性就趁这两天有空改用Hexo+Github Pages搭建博客了。

我真是个花心Boy (─‿‿─)

关于GitHub Pages

这是它的官网介绍GitHub pages

开始搭建

主页效果图

14MSiQ.png

安装工具

详细参考hexo官网文档

安装Git

1
sudo apt-get install git-core

Node.js v12.x

1
2
3
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs

安装hexo

1
2
sudo apt install npm
sudo npm install -g hexo-cli

初始化hexo

1、在你电脑上创建一个文件夹,命名根据你喜欢。

2、进入该文件夹,终端执行命令:

1
hexo init

初始化完成之后打开所在的文件夹可以看到以下文件:

14KxIg.png

配置主题

hexo初始化之后默认的主题是landscape , 你可以去hexo主题官网里面找到你喜欢的主题,这个网站有很多主题可以供我们去选择,我选择使用的是Butterfly

每一个主题都有对应网站可以预览,并且都有 Github 地址,我们可以照着 Github 的 wiki 就可以安装了,过程都比较简单

下载主题

找到你喜欢的主题,到它的github去克隆到你的本地电脑。

PS:可以直接通过在hexo主题官网里找到的主题,点进去拉到最下面,会有github的地址。

该主题的配置步骤已经有很详细的介绍,按照步骤往下配置即可。

更多详细配置

我选用的是Butterfly主题。更多详细配置可以参考主题开发者写的文章hexo-theme-butterfly安裝文檔,里面已经很详细的介绍了如何修改配置主题。

配置Github

如果没有github账号,先创建一个账号。

新建一个仓库

新建一个仓库,点击右上角的 + 新建一个仓库,如下图所示:

V1qlrR.png

添加SSH秘钥

打开终端,执行命令:

1
2
git config --global user.name "yourname"
git config --global user.email "youremail"

这里的yourname输入你的GitHub用户名,youremail输入你GitHub的邮箱。这样GitHub才能知道你是不是对应它的账户。

可以用以下两条,检查一下你有没有输对:

1
2
git config user.name
git config user.email

然后创建SSH,一路回车

1
2
ssh-keygen -t rsa -C "youremail"
# youremail输入你Github的邮箱

这个时候它会告诉你已经生成了.ssh的文件夹,打id_rsa.pub文件:

1
gedit ~/.ssh/id_rsa.pub

复制里面的内容。而后在GitHub的setting中,找到SSH keys的设置选项,点击New SSH key,把你的id_rsa.pub里面的信息复制进去保存即可。

配置Git

回到本地初始化hexo的那个文件夹,修改根目录下配置文件_config.yml信息:

1
2
3
4
5
deploy:
type: git
repo: <repository url>
branch: [branch]
message: [message]
参数 描述
repo 库(Repository)地址
branch 分支名称。如果您使用的是 GitHub 或 GitCafe 的话,程序会尝试自动检测。
message 自定义提交信息 (默认为 Site updated: now(‘YYYY-MM-DD HH:mm:ss’) )

例如:

1
2
3
4
deploy:
type: git
repo: git@github.com:Magicalsoso/Magicalsoso.github.io.git
branch: master

本地验证

进入你的博客根目录,分别执行以下命令:

1
2
3
hexo clean
hexo generate
hexo server
  • 打开浏览器输入:http://localhost:4000
  • 不出意外接着你就可以看见你的博客啦~

发布到Github

  • 安装工具:

    1
    sudo npm install hexo-deployer-git --save

    用于使用deploy命令时调用git push,将更新信息推送至github.com。

  • 执行命令:

    1
    2
    3
    hexo clean
    hexo generate
    hexo deploy

注意:deploy的过程中要输入你的username及passward,正常输入即可。

上传完成后,在浏览器中输入http://yourgithubname.github.io就可以看到你的个人博客啦~

修改主题出现问题

点击查看Butterfly 安裝文檔(五) 主題問答


Hexo+GitHub搭建个人博客
https://kevinloongc.github.io/posts/48892.html
作者
Kevin Loongc
发布于
2020年2月9日
许可协议