Fork me on GitHub

使用hexo、github搭建个人博客

使用hexo配合github page可以快速搭建一个属于自己的静态博客,号称5分钟就可以快速入手。
Hexo 是一个快速、简洁且高效的博客框架。

hexo的安装

输入以下命令全局安装hexo

npm install -g hexo-cli

输入 hexo -v 查看hexo是否安装成功 出现以下表示安装成功。

hexo是否安装成功

找到合适的地方,用来生成hexo的模版,以下是我的存放地址。

hexo项目存放地址

执行 hexo init [name] name是文件夹名称,可随便起,这里我取名blog。

执行中….

稍后片刻,此刻你可以去冲杯咖啡沏杯茶

执行完成

出现 Start blogging with Hexo 字段表示初始化完成。

命令行中输入cd blog 进入到博客存放地址,接下来的命令,我们都需要在里面完成。

博客存放地址

接下来,我们用vs code将它打开(或者用其他的编辑器)。此时的目录结构图如下

目录结构

命令行输入 hexo s(hexo server的简写) 用来启动服务

报错的话,可以尝试执行 npm i 手动下载依赖的包,然后再启动服务

启动服务

在浏览器中 输入localhost:4000 进行访问

hexo访问地址

至此,我们本地博客就已经跑起来了,接下来,让我们修改下简单的配置。

hexo 配置文件和常用命令

目录下_config.yml是hexo的配置文件。

1
2
3
4
5
hexo s 启动服务
hexo clean 清空hexo的缓存
hexo g 重新生成静态文件
hexo d 发布到线上(请参考以下配置)
hexo d -g 发布线上之前先重新生成文件

关联hexo和github page

进入到我们的github,新建项目。

新建项目

输入我们的项目名和项目描述。然后点击Create repository按钮,创建我们的代码库。

项目名必须是自己的github名称.github.io 下图标红

项目名填写说明

创建好以后,我们会自动进入到从项目中。此时页面如下

项目界面

把标红的git地址复制下,我们采用ssh的git地址,并不采用https。如果用https的话,会有一些预料不到的问题,我们这里不做深入研究。

回到我们的hexo项目中, 此时在编辑器中打开hexo的配置文件_config.yml,在文件最下面找到deploy字段,修改成以下样子。
type 方式采用git
repo 就是我们的github的项目地址
branch 就是我们的分支

1
2
3
4
deploy:
type: git
repo: https://github.com/MrzhangSs/MrzhangSs.github.io.git
branch: master

修改好后配置文件后,我们回到命令行中,执行 npm i hexo-deployer-git -S 安装git发布博客时候的依赖包,

此时我们就完成了与github的关联。

我们执行 hexo d 命令

发布博客

hexo主题next的使用

本文作者:Orton Zhang

本文链接:http://ortonzhang.com/2017/10/15/hexo-github-blog/

版权声明:本博客所有文章除特别声明外,均采用CC BY-NC-SA 3.0 CN 许可协议。转载请注明出处!