HEXO+Github博客搭建

搭建这个博客的时候看了网上的一些教程也踩了一些坑。所以把自己搭建博客中的收获分享出来,加深自己的记忆的同时,也希望能帮到和我遇到相同问题的胖友。说明:以下内容都是基于Windows的~

环境配置

安装node

Node的安装很简单,百度一下在官网就能下载,一路next。

安装git

为了把本地的hexo内容传到github上去。因此,同样你需要申请一个github账号。

安装hexo

可以到hexo官网上了解详细的命令行,不过安装命令行只需要

1
npm install hexo-cli -g

如果想要检验hexo是否安装成功,可以使用

1
hexo -v

查看安装情况。

初始化

这一步是为了初始化hexo博客的相关代码,依次输入以下命令。

1
2
3
hexo init <folderName> //folderName可以自定义,如myBlog
cd <folderName>
npm install

执行完这一步你就可以在你的folderName这个目录下看到许多的文件,接下来就是执行命令在本地查看博客页面。

本地运行

输入下面的命令行

1
hexo server

默认的端口号是4000,但是我的在4000上面就跑不起来,所以可以运行一下命令,自己定义端口号。

1
hexo server -p myPort //myPot的值可以自定义,如5000

然后你就可以在浏览器端运行了,展示出来的页面是默认主题。

更换主题

更换主题

这一步建议在部署之前执行,hexo官网中有很多主题,你可以挑选一个你喜欢的然后进入github按照他的安装说明一步一步执行,不同的主题部署方法会有不同。当然你也可以自己修改代码自定义你喜欢的样式。

部署

创建仓库

首先你需要申请一个github账号,其次你需要新建一个仓库,名字可定义为:yourName.github.io

完成对仓库的设置

在网上看到很多朋友遇到最多的问题就是,部署完成后打开链接结果一直显示404。为了避免这种情况发生,你需要在github中完成相应的设置。

FastStoneEditor2

FastStoneEditor1

这样你就可以放心地完成接下来的部署了。

配置部署文件

1
2
3
4
deploy: //注意':'后面要有空格
type: git
repository: https://github.com/leopardpan/leopardpan.github.io.git
branch: master

其中repo项是之前Github上创建好的仓库的地址,可以通过如下图所示的方式得到:

FastStoneEditor3

执行如下命令才能使用git部署

1
npm install hexo-deployer-git --save

部署博客

1
2
hexo generate
hexo deploy

这时候我们的博客已经部署到网上了,我们可以在浏览器地址输入栏输入我们的网址即可,如我的博客是:https://four27.github.io/

之后你可以根据需要修改博客中的相应信息以及博客主题。

写文章

写文章

1
hexo new "postName" #新建文章

运行后可在本地的source /posts目录下看到新建的文章,用markdown编辑器打开进行编辑保存。

部署到giithub上

每次写完文章,如想将文章部署到github上可依次完成以下命令。

1
2
3
hexo clean
hexo generate
hexo deploy

一些常用命令

1
2
3
4
5
6
7
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help #查看帮助
hexo version #查看Hexo的版本