使用hexo+github搭建免费个人博客

1.前言

---

github pages介绍：

1.一般多用于托管个人的静态网站

2.省去了购买服务器、域名等等一系列复杂的操作

github pages好处：

1.全是静态文件，访问速度快

2.免费方便，不用花一分钱就可以搭建一个自由的个人博客，不需要服务器不需要后台

3.数据绝对安全，基于github的版本管理，想恢复到哪个历史版本都行

4.博客内容可以轻松打包、转移、发布到其它平台

5.等

2.准备工作

---

1.注册一个github账号（已有不用）

2.安装了node.js、npm，并了解相关基础知识；

3.安装了git for windows（或者其它git客户端）

3.开始搭建github博客

---

3.1github中创建仓库

仓库名为用户名.github.io（必须与用户名一致），网站访问地址是 http://用户名.github.io 了创建成功后，默认会在你这个仓库里生成一些示例页面，以后你的网站所有代码都是放在这个仓库里。

4.配置SSH key

---

配置原因：因为提交代码肯定要拥有你的github权限才可以，但是直接使用用户名和密码太不安全了，所以我们使用ssh key来解决本地和服务器的连接问题

用git bash执行如下命令：

1.$ cd~/.ssh#检查本机已存在的ssh密钥 

（如果提示：No such file or directory 说明你是第一次使用git。）

2.$ ssh-keygen -t rsa -C "邮件地址"

（然后连续3次回车，最终会生成一个文件在用户目录下，打开用户目录，到.ssh\id_rsa.pub文件，记事本打开并复制里面的内容，打开你的github主页，进入个人设置 -> SSH and GPG keys -> New SSH key：）

（id_rsa和id_rsa.pub,分别表示私钥和公钥文件, 私钥文件自己使用, 公钥文件需要上传到Github上.）

3.测试是否成功

$ ssh [email protected]# 注意邮箱地址不用改

（如果提示Are you sure you want to continue connecting (yes/no)?，输入yes，然后会看到：Hi QzzBL You’ve successfully authenticated, but GitHub does not provide shell access.）

说明SSH已配置成功！

4.继续配置设置用户信息：

$ git config --global user.name "liuxianan"// 你的github用户名，非昵称

$ git config --global user.email "[email protected]"// 填写你的github注册邮箱

5.hexo写博客

---

5.1 安装

$ npm install-g hexo

5.2 初始化

$ cd/f/Workspaces/hexo/

$ hexo init

5.3

$ hexo g# 生成（静态页面）

$ hexo s# 启动服务（开启本地预览服务，打开浏览器访问 http://localhost:4000 即可看到内容）

（执行以上命令之后，hexo就会在public文件夹生成相关html文件，这些文件将来都是要提交到github去的：）

6.上传到github

---

首先，ssh key肯定要配置好。

其次，配置_config.yml中有关deploy的部分：

正确写法：

deploy:  type: git  repository:[email protected]:liuxianan/liuxianan.github.io.git  

branch: master

错误写法：

deploy:  type: github  repository:https://github.com/liuxianan/liuxianan.github.io.git

branch: master

（后面一种写法是hexo2.x的写法，现在已经不行了，无论是哪种写法，此时直接执行hexo d的话一般会报如下错误：

Deployer not found: github 或者 Deployer not found: git

原因是还需要安装一个插件：

npm install hexo-deployer-git --save   （hexo-deployer-git 会存在于node_modules文件夹中）

）

打开你的git bash，输入hexo d就会将本次有改动的代码全部提交

7.常见hexo命令及上传步骤

---

常见命令

hexo new "postName" #新建文章

hexo new page "pageName" #新建页面

hexo generate #生成静态页面至public目录

hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）

hexo deploy #部署到GitHub

hexo help  # 查看帮助

hexo version  #查看Hexo的版本

hexo new page 'postName'命令和hexo new 'postName'有区别：

hexo new page "my-second-blog"

生成如下：

最终部署时生成：hexo\public\my-second-blog\index.html，但是它不会作为文章出现在博文目录。

缩写：

hexo n == hexo new

hexo g == hexo generate（此三步骤完成上传）

hexo s == hexo server

hexo d == hexo deploy

组合命令：

hexo s -g #生成并本地预览

hexo d -g #生成并上传

8.个人安装时问题

---

1.访问username.github.io时出现404错误（可能与没有分支 git init 等安装分支）

2.主题修改本地可看，github上看不了

3.等等

9.参考文章

---

http://blog.haoji.me/build-blog-website-by-hexo-github.html?from=xa

https://www.jianshu.com/p/380290deb8f0

https://blog.csdn.net/zxy987872674/article/details/72491066