使用hexo+github搭建博客

嗯,搭建这个博客真的是历尽艰辛,所以第一篇博客记录一下我搭建的时候遇见了哪些问题,其实全程都是按网上的教程走的,(想想都是一把辛酸泪),只是最后给博客做加工美化的时候请教了一下大佬,在此特别感谢大佬帮小萌新操作,谢谢谢谢。

首先,搭建博客需要安装

1. git
下载地址https://git-scm.com/download/win

2. node.js下载地址https://nodejs.org/en/

3. hexo

前两个就不用说了,直接下载就行,安装好以后,打开CMD命令窗口,输入npm -v
,如果出现版本号,则说明安装成功了并且环境变量也配置好了,如果是未知命令那就要配置一下环境变量。


安装hexo

安装hexo时要首先在本地磁盘建立一个Hexo文件夹用于存储本地文件

1

然后再这个文件夹里点击右键打开git命令框

2

在git命令框中安装Hexo(没有安装git的情况下,可以找网上用cmd窗口安装的教程,不过我没有试过)

安装hexo的命令是npm install -g hexo

3

打开cmd窗口,输入hexo -v,如果出现版本号则说明安装成功

4

然后初始化hexo init

5

初始化完成后启动服务启动服务(npm install –>hexo server –>hexo clean –>hexo generate –>hexo deploy)

6

7

8

9

最后进行本地测试。
++(注意访问本地页面的时候hexo server不可以按ctrl+c停止服务,否则会报404)++

如果页面没有报404但是进不去,可能是因为端口被占用了,用hexo s -p5000把端口改成5000,再访问一下,就可以进去了
10


注册github

11

12

13

找到我们的博客仓库,并拷贝仓库地址
14

找到我们博客根目录下的_config.yml修改目录的配置

15

修改deploy下的配置如下(注意冒号后有空格)

16

最后执行控制台命令
npm install hexo-deployer-git
安装部署插件
hexo d //部署到github

17

最后执行hexo clean –>hexo generate –>hexo deploy
你就可以看到你的博客了

记住,每次修改配置信息或者其他都必须要执行步骤hexo g 、hexo d,才可以使得配置信息生效。

根据自己的的系统自行选择下载安装,下载地址https://desktop.github.com/

下载安装好之后登陆你的github.
从你的仓库添加到本地

18

19

20

hexo new 新建一篇文章之后可以预览(localhost:4000)了

21

从本地访问成功后执行hexo d部署到github

22

这时再刷新 username.github.io 就可以看到你的博客了。

我在搭建博客过程中遇到的问题

  • 执行npm install -g hexo安装命令时出现错误

e1

然后我执行了npm cache clean –force强制清理了一下cache才安装成功

e2

这一步出错一般是提示权限错误,就是node_modules中某个文件无权限操作,要求使用root/admistrator用户运行命令。
这个问题的解决其实并非单纯的权限问题,当然首先用管理员用户运行命令试一下,linux用户可以在命令前加sudo,windows系统需要以管理员身份运行cmd终端窗口。
如果没有解决,因为本质是node.js安装模块的过程中出现的问题,可以试着用npm cache clean –force强制清理一下cache,然后重新运行npm install安装必要的模块

  • 初始化hexo init发生错误

e3

这个问题网上并没有提供解决的办法,可能是因为大家没有遇见过吧,然后我在寻找解决方法的时候注意到教程里有这样一句话
“首先新建一个文件夹,位置随意,然后 cd 到这个文件夹下,运行命令:hexo init”

然后我建了一个文件夹,cd到这个文件夹下,再运行这个命令,果然不假,进入了漫长的初始化生成过程

  • 进行本地测试时页面报错404

原因是执行了hexo s后又按了ctrl+c终止
attention:命令行里ctrl+c代表stop停止


附:hexo中几个常用命令

hexo generate (简写:hexo g)
生成静态文件,会在当前目录下生成一个新的叫做public的文件夹

hexo server (简写:hexo s) 启动本地web服务,用于博客的预览

hexo deploy (简写:hexo d) 部署博客到远端(比如github, heroku等平台)

$ hexo new “xxxx”(简写:hexo n) 新建文章

$ hexo new page “pageName” #新建页面

常用组合:

$ hexo s -g #生成预览

$ hexo d -g #生成部署