使用hexo在github搭建博客超详细

搭建github博客

1.搭建准备

1.1 创建github账号

传送门：待写

1.2 git安装

传送门：待写

1.3 node.js安装以及npm环境安装

传送门：待写

1.搭建github仓库

2.安装hexo

2.1下载hexo

在电脑任意盘创建一个文件夹，我这里是创建在D盘名字为blog
win+R打开cmd或者在文件夹路径输入cmd

进入到黑窗口后执行
npm install -g hexo-cli
下载并安装到本地仓库
下载完成如下图

2.2 初始化hexo

进入cmd
方法如上个步骤进入
执行hexo init blog
等待初始化完成
完成如下图

出现INFO Start blogging with Hexo!代表成功
但是会在增加一个叫blog的文件夹，里面是blog的所有文件
如图所示

2.3 启动blog

启动blog需要进入到源码文件的文件夹也就是D:blog\blog
(注意你hexo初始化在哪个文件夹就是那个文件夹下面)
出现这个说明目录错了，因为此时目录是D:blog
所以我需要在进去到D:blog\blog,原因是因为默认会在生成一个blog文件夹所以目录需要在进入一层
使用hexo generate或者hexo g（g是generate的缩写）会自动生成默认带helloworld的页面，等会启动起来的效果就是这个默认页面
这个是成功的表现

然后执行hexo server或者hexo s(s是server缩写)

启动成功
接下来直接去浏览器复制上面的 http://localhost:4000去访问就可以看到效果了。
效果如下

搭建成功

3.配置博客（注意yml的配置文件每一行‘:’后面需要空格）

用文本编辑器打开D:blog\blo文件夹下的_config.yml修改配置
注意yml的配置文件每一行‘:’后面需要空格

重要的事情说三遍

• 注意yml的配置文件每一行‘:’后面需要空格

• 注意yml的配置文件每一行‘:’后面需要空格

• 注意yml的配置文件每一行‘:’后面需要空格

我们只修改一些地方

# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
# Site #站点信息
title:  #标题
subtitle:  #副标题
description:  #站点描述，给搜索引擎看的
author:  #作者
email:  #电子邮箱
language: zh-CN #语言

默认为

修改为

3.1 修改内容标题

title: 海湾之家
subtitle: '我是测试'
description: 'hexo搭建博客，测试用例'
keywords:
author: Backbay2
email: [e-mail]
language: zh-CN

修改之后Ctrl+c 结束进程 并且重新执行 hexo server

在进行访问http://localhost:4000/

3.2发布到github

3.2.1 生成ssh秘钥

使用你的邮箱号：ssh-****** -t rsa -C “你的邮箱号”
例如我的操作：ssh-****** -t rsa -C "[e-mail]"
成功如下图
然后在文件夹用户目录下可以找到id_rsa.pub文件，使用编辑器打开，ctrl+a全选复制

3.2.3 添加秘钥

打开github登录页面，登录上去在右上角图标点击下三角找到Setting设置

然后在找到SSH adn GPG keys 右边会有个 new SSH keys，如果未出现就是仓库还没创建好，一般创建需要一些时间的，可能半个小时左右，每个人情况都不一样。

将复制的ssh填入

完成如下，并且会有一封邮件发到你的注册邮箱

3.2.3 修改发布配置

需要发布到github所以需要配置一下deploy 只需要将图下的仓库名字xxxx改成你的github仓库名就可以了
repository：[e-mail]:xxxx/xxxx.github.io.git 如图所示
或者去github打开项目里面就有https的链接跟ssh的链接

deploy:
  type: git
  repository: [e-mail]:backbay2-yzg/backbay2-yzg.github.io.git
  branch: master

3.2.4 发布

1.先Ctrl+c 停止执行hexo
2.执行 hexo d出现错误 Deloyer not found: git,原因缺少组件
3.于是在执行npm install hexo-deployer-git --save，安装组件,
步骤如图

4.安装完成再试一次hexo d ，这次可以执行了。
如果出现Permission denied (publickey)请使用git bash shell 进入到D:\blog\blog去执行hexo d

如图部署到github成功

4.创建文章

使用hexo new "文章名"创建新的文章
文章路径在窗口有

编辑文章我使用的是Typora

好啦到此创建就成功了。
部署需要重新执行
hexo g 生成网页
hexo d 部署
结果如下：

如果不行请检查githubpages功能是否开起来
进入github->进入项目
找到如图所示的setting

进入Setting界面
往下拉找到GithubPages,出现红框的内容代表开通成功，可用这个网址访问博客

到此就可以了，想要更多内容，可以去官网https://hexo.io/查看文档