hexo 简介,安装,部署

219 阅读2分钟

简介

hexo是使用node.js开发的一个快速、简洁、高效、开源的静态博客生成器,使用了MarkDown解析文章。我们可以用hexo在本地起好服务,托管到github就能通过github域名访问(免费,省事),当然也可以使用自定义的域名解析(花钱,高大上)。

本文可能对初学计算机的童鞋们不太友好,这里省去了node.js和git的安装及配置,包括设置Git用户信息,生成SSH key公钥,这里不再赘述,可以自行百度~

git仓库配置

我采用的是hexo + githubPages搭建,首先需要在GitHub上创建Github Pages服务,具体步骤如下图:

hexo-deploy.png 点击之后仓库名一定要填 用户名.github.io 的格式(形如zhangzheyi1.github.io),不要填 用户名 的格式(形如zhangzheyi1),这里踩了好几次坑了,浪费了不少事件,因为现在我已经有这个仓库了,这个报错可以忽略掉,下面的readme记得点上❤,最后一步点创建

hexo-deploy2.png

hexo安装

$ npm install -g hexo-cli #全局安装hexo脚手架

初始化创建博客

1.创建站点根目录

首先需要初创建一个博客文件夹,注意这个文件夹的名字最好要和你刚才创建的GitHubPages的地址一致也就是your_github_name.github.io(形如zhangzheyi1.github.io)。这个文件夹以后也统称为站点根目录。

2.初始化站点根目录

$ mkdir <folder>  #创建站点根目录,形如(mkdir zhangzheyi1.github.io)
$ hexo init <folder>  #使用Hexo初始化站点根目录(hexo init zhangzheyi1.github.io)
$ cd <folder>  #进入到站点根目录(cd zhangzheyi1.github.io)
$ npm install  #安装npm所依赖的文件

等他安装好,在输入两条就能访问本地的博客了

$ hexo generate # 生成博客
$ hexo server # 本地预览

默认端口是4000,直接浏览器键入 http://localhost:4000 就可以访问了,现在是默认的主题

hexo-deploy3.png

3.修改配置文件

现在我们只能在本地预览,想在gitPage上预览还需要进行一些配置,找到根目录下的_confi.yml文件,拉到最下面我们看到的是以下code

deploy:
  type: ''

deploy就是部署的意思,这里部署的话需要填下信息,修改为以下代码就可以

deploy:
  type: git
  repo: git@github.com:zhangzheyi1/zhangzheyi1.github.io.git
  branch: master

repo就是仓库地址,这儿用的是SSH,找到刚才创建的仓库,把这个地址复制下来粘到repo里就可以了

hexo-deploy4.png

安装以下插件:

$ npm install hexo-deployer-git —save

执行以下命令发布本地博客到远程仓库:

$ hexo deploy

可能到这步登陆your_github_name.github.io,形如zhangzheyi1.github.io,有些同学还是没办法看到自己的博客,就是因为github的配置有点恶心人,当时我也在这儿不知道怎么搞,是因为默认的分支是main,而不是master,需要点击仓库的settings => pages 然后修改一下默认的分支就可以

hexo-deploy5.png

到这步基本上就ok了,网上发的好多博客都是很久以前写的,github的版本和hexo的配置文件都不一样,按照本篇文章应该可以完成,现在的博客只是一个默认主题,xdm想换主题的话可以在网上搜一下主题,本博客用的是Fluid主题,第一次发文,确实挺耗时间的,博客域名已经搞好了,文章地址在www.zhangzheyi1.com/2021/07/28/… 有兴趣的小伙伴可以上去看看,发个评论什么的,希望自己以后能坚持下去~