hexo+github搭建博客详细教程

经历了两天的折腾,终于搭建好了个人博客。由于第一次搭建个人博客,所以在搭建过程中也遇到了很多的问题。现在特意整理一下整个搭建过程以及中间遇到的问题。

一、软件准备

image-20210727204933786

根据系统需求下载对应的版本,这里下载windows版本

默认已经安装以上两个软件,接下来安装Hexo。在任意文件夹中打开CMD窗口执行如下指令安装hexo

1
npm install -g hexo-cli

等待大概一分钟安装完毕,执行hexo -v 如果出现版本信息,说明安装成功。

二、创建git远程仓库

1、如果还没有github账号,需要先注册账号。如果不会注册直接百度就可以,类似的教程百度有很多;这里默认都注册过了github。接下来登录github创建仓库:如下图

image-20210727221144333

特别需要注意的是 第一步中仓库名称必须是Ower.github.io 格式,其中Ower是用户名。如果不是这个格式的话,后面使用hexo生成的静态页面会识别不了

2、以上步骤完成之后,在电脑本地创建一个文件夹,存放我们的本地blog。

image-20210727222117448

3、打开CMD命令窗口,并且cd到blog文件中执行初始化blog工程指令hexo init

image-20210727223759193

完毕之后目录结构如下:

image-20210727223938616

想要详细了解目录结构可以查看hexo官网 https://hexo.io/zh-cn/docs/index.html

4、配置blog工程中的_config.yml文件

image-20210727224818946

image-20210727225056195

这里主要是设置上图中圈中的三个地方,这里解释一下三个代表什么:

  • url: 表示将来访问仓库博客的地址,其格式为”https://仓库名称”
  • theme: 表示博客要使用的主题,默认使用landscape,如果是不想使用默认主题,可以到hexo官网找自己喜欢的主题。当然如果自己有web相关基础的话也可以自己参照hexo官网自定义主题
  • type: 表示博客将来要发布到哪个服务器,这里我们选择发布到git
  • repo: 表示发布到git中的哪个仓库里,这里我们是发布到上面创建的仓库中https://github.com/li-huibin/li-huibin.github.io

注意这里设置的repo 地址是仓库地址,而不是https://仓库名称。应该是如下图红框中的地址,这里不能设置错了,否则会访问不到博客

image-20210727230856137

  • branch: 表示发布到仓库的哪个分支,默认master

到此为止,个人博客基本搭建完毕。接下来在cmd中编译工程,然后启动本地服务

1
2
D:\Users\A\Desktop\lihuibin\tmp\blog> hexo generate
D:\Users\A\Desktop\lihuibin\tmp\blog> hexo server

image-20210727231758842

本地服务启动后,hexo默认地址是http://localhost:4000 。我们访问这个地址就可以看到本地的博客服务了

image-20210727231930894

5、将本地博客发布到git仓库

执行如下指令将我们的本地博客发布到刚刚创建的远程git仓库

1
D:\Users\A\Desktop\lihuibin\tmp\blog> hexo deploy

然后,就可以直接在浏览器中访问https://li-huibin.github.io来访问博客了。到此为止博客搭建完毕。

  • 版权声明: 本博客所有文章除特别声明外,著作权归作者所有。转载请注明出处!

请我喝杯咖啡吧~

支付宝
微信