利用Hexo搭建github个人博客

摘要

一直想搞个人博客,一直也没时间,等到了暑假,老师的新项目还没有开启就想起来搭建个人博客,中间碰到了挺多问题,这里也会跟大家讲一下,希望大家迅速的搭建个人博客,同时感谢帮助我的大神,他们的博客地址我会在底部给出链接,大家也可以去浏览、参考,现在开启我的搭建之旅。
首先给出Github网址:GitHub

准备

  • 注册github账号以及github本地电脑安装客户端
    当然你也要回一些github的基本操作,否则后面的代码也是看不懂。
    附上一个学习github的地址: github
    网址上有非常详细的讲解,希望对大家有帮助,建议大家安装完检查下安装是否成功。
  • 安装Node.js
    给出官网地址 Node
    具体安装步骤,百度就可以,建议大家安装完检查下安装是否成功。
  • Hexo
    介绍我就不说了,给出官网地址 HEXO,大家要注意,这个网站的右上角是可以选择语言的,方便大家浏览官网,谅解相关的基础知识。

    HEXO安装

1 . 首先点击git shell来启动或者使用cmd命令输入一下命令(两种方式都行):

1
2
npm install hexo-cli -g --这也是官方的安装命令,可参考官网
npm install hexo --save

2 . Hexo初始化配置
上面一步安装成功后,开始创建hexo文件夹: 自己随意在 D盘、F 盘选择一个英文路径的文件夹,我们假设是F:Hexo/,首先 cd 到文件夹Hexo中,使用以下命令:

1
2
hexo init --初始化这个文件夹
npm install --安装配置信息

安装 Hexo 完成后,Hexo 将会在指定文件夹中新建所需要的文件。Hexo文件夹下的目录如下:
Hexo文件内容

3 . 安装相关的Hexo插件
这些插件其实也可以当你要用的时候再来安装,不过为了不出错误,我们还是提前安装吧。

1
2
3
4
5
6
7
8
9
10
11
12
13
npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save

4 . 查看本地Hexo服务效果
以上插件安装成功后,我们来测试本地的服务,看本地环境是否搭建成功。执行以下命令:

1
2
hexo g --有的博客上是用 hexo generate,其实这两条命令是等价的,不影响
hexo s --有的博客是利用 hexo server,这两条命令是等价的

接下来登录到我们的本地测试 ,就可以看到如下界面:
hexo测试主页
如果长时间没有出现,首先你就要去查看你的4000端口号是不是被占用了,最可能的结果
就是安装了福昕阅读器,因为这个软件会占用你的4000端口,导致hexo server命令行显示服务器启动成功但实际上无法正常访问,这个时候你就要更改下端口号,
利用命令:hexo s -p 4001 ,来启动localhost:4001,你就可以发现问题解决了,即可看到本地的效果如下:
(注意看图中的端口号)
hexo测试主页

Github Pages设置以及将博客部署到Github Pages

以上的操作只能让我们在本地看到我们的博客,现在我们要来设置Github Pages,让别人通过地址
联网来查看博客。

1 . 注册Github后新建一个Github项目,点击 New repository,如图来设置:
hexo测试主页

注意:这里添写的项目名称一定要记得必须是严格按照一下格式来的:
(你的github用户名).github.io
这样名字就只有二级,否则会很长。
2 . 创建Github Pages
点击刚刚创建的(你的github用户名).github.io里面去,在右侧我可以看到一个Setting,
hexo测试主页
然后在跳转的页面上找到 Github Pages,然后点击”Launch automatic page generator”,如图:
hexo测试主页
3 . 配置SSH秘钥
这个方面教程因为我个人的github安装路径问题,所以这里不介绍,网上有很多教程,大家配置秘钥的时候一定要找到自己github安装的路径最后一定要验证下自己是否设置成功。
将本地的Hexo文件更新到github库中
这里要讲下Hexo文件可以不再github目录下,这个没有必要要求。
(1)、点击刚才的创建好的Github Pages,找到”Clone or download”,选择”Clone with HTTPS”下的 URL,如图:
hexo测试主页
(2)、打开你在电脑上创建的Hexo文件夹,用记事本或者 sublime txt打开_config.yml文件
hexo测试主页

(3)、在配置文件下做如下修改,保存
hexo测试主页

(4)、在Hexo文件夹下执行命令

1
2
3
hexo clean
hexo generator
hexo d

执行完,有的会让你输入github的账号和密码,我在执行操作的时候没有要求输入账号和密码,就等了一会,执行完毕,这个时候访问之前创建的:(你的github用户名).github.io就可以访问了。

结束语

感谢几位大神的博客指导,我在他们的肩膀上成功了搭建了自己的博客,当然也出现了一些问题,
这些问题希望对其他人有帮助。
网址一:大神博客地址
网址二:大神博客地址

到目前为止只是搭建了这么一个博客,还有很多要学习的,建议大家去官网了解下hexo,这对你后续的给博客添加一些功能有帮助。

文章目录
  1. 1. 摘要
  2. 2. 准备
  3. 3. HEXO安装
  4. 4. Github Pages设置以及将博客部署到Github Pages
  5. 5. 结束语
文章目录
  1. 1. 摘要
  2. 2. 准备
  3. 3. HEXO安装
  4. 4. Github Pages设置以及将博客部署到Github Pages
  5. 5. 结束语
,