使用Github和Hexo搭建自己的博客

使用Github和Hexo搭建自己的博客

一、前言

这是一篇关于如何使用 Github Pages 和 Hexo 搭建小白独立博客的文章。里面有一些博主遇到的小问题，只要踏踏实实跟着教程走，自己的博客就在向你挥挥手哦！Github Pages可以被认为是用户编写的、托管在github上的静态网页。使用Github Pages可以为你提供一个免费的服务器，免去了自己搭建服务器和写数据库的麻烦。此外还可以绑定自己的域名。Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

此文章参考：https://blog.csdn.net/qq_36759224/article/details/82121420

二、下载NODE+GIT+HEXO

（1）下载node.js

官网下载网址：https://nodejs.org/en/download/ ，根据自己情况选择版本，默认设置即可。

（2）下载Git

下载地址：https://git-scm.com/download/win 默认下载。

检验Git是否安装成功：

（1）打开cmd，输入以下指令，有相应版本信息显示即安装成功。

git --version

node -v

npm -v

（2）若安装成功，在桌面右键鼠标，可以看到菜单多了Git GUI Here 和 Git Bash Here两个选项。第一个是图形界面的Git操作，第二个是命令行。

(3)安装Hexo

（1）选择一个磁盘，新建一个文件夹，自己重命名文件夹（如：我的文件夹为：Ｅ\KIKICHUANG-Q_Blog），博客相关文件将储存在此文件夹下。

（2）在该文件夹下右键鼠标，点击 Git Bash Here，输入以下 npm 命令即可安装。

第一个命令表示安装 hexo，第二个命令表示安装 hexo 部署到 git page 的 deployer，如图所示即为安装成功。

npm install hexo-cli -g npm install hexo-deployer-git --save

（3）初始化Hexo

在刚才新建的文件夹里面再次新建一个 Hexo 文件夹（如：我的文件夹为：E\TRHX_Blog\Hexo）,进入该 Hexo 文件夹右键鼠标，点击 Git Bash Here，输入以下命令，如图所示则安装成功。

hexo init

（4）检查

Hexo安装完成后，将会在指定文件夹中新建所需要的文件，Hexo 文件夹下的目录如下：

三、本地查看效果

执行以下命令，执行完即可登录 http://localhost:4000/ 查看效果

hexo generate hexo server

显示以下说明成功：

INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

登录 http://localhost:4000/ 查看效果：

四、将博客部署到GIthub Pages上

我们的本地博客就成功搭建了，但是现在我们只能通过本地连接查看博客，我们要做的是让其他人也能够访问我们的博客，这就需要我们将博客部署到Github Pages上。

（1）注册Github账户

官网：https://github.com/

点击sign up注册

（2）创建项目代码库

点击 New repository 开始创建，步骤及注意事项见下图：（万分注意：一定要以 ”你的用户名.github.io"格式命名！博主当时漏了.io导致不匹配，网站404，重新再在这一步修改了回来才解决，所以千万记得格式严谨！！！！！!）

（3）配置SSH密钥

在你第一次新建的文件夹里面（如：我的文件夹为：Ｅ\KIKICHUANG-Q_Blog） Git Bash Here 输入以下命令：

ssh-keygen -t rsa -C "your email@example.com"
//引号里面填写你的邮箱地址，比如我的是903822154@qq.com

之后会出现：

Generating public/private rsa key pair. Enter file in which to save the key (/c/Users/you/.ssh/id_rsa): //到这里可以直接回车将密钥按默认文件进行存储

然后：

Enter passphrase (empty for no passphrase):
//这里是要你输入密码，其实不需要输什么密码，直接回车就行
Enter same passphrase again:

//再回车

接下来会显示：

Your identification has been saved in /c/Users/you/.ssh/id_rsa. Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub. The key fingerprint is:
这里是各种字母数字组成的字符串，结尾是你的邮箱
The key's randomart image is:
这里也是各种字母数字符号组成的字符串

运行下列命令：（将公钥的内容复制到系统粘贴板上）

clip < ~/.ssh/id_rsa.pub

(5)在Github账户添加你的公钥

（1） 登陆 GitHub，进入 Settings：

（2)点击 SSH and GPG Keys：

(3)选择 New SSH key：

(4)粘贴密钥：

(5)测试

输入以下命令：注意：git@github.com不要做任何更改！

ssh -T git@github.com

之后：

YES之后：

则OK！

（6）配置 Git 个人信息

Git 会根据用户的名字和邮箱来记录提交，GitHub 也是用这些信息来做权限的处理，输入以下命令进行个人信息的设置，把名称和邮箱替换成你自己的，名字可以不是 GitHub 的昵称，但为了方便记忆，建议与 GitHub 一致。

  git config --global user.name "此处填你的用户名"  
  git config --global user.email  "此处填你的邮箱"

OK!！ Key 配置成功，本机已成功连接到 Github！

五、将本地的 Hexo 文件更新到 Github 的库中

① 登录 Github 打开自己的项目 your name.github.io

② 鼠标移到 Clone or download 按钮，选择Use SSH

③ 一键复制地址

④ 打开你创建的 Hexo 文件夹（如：E:\KIKICHUANG-Q\Hexo），右键用记事本（Notepad++或者VS code等都可以）打开该文件夹下的 _config.yml 文件

⑤ 按下图修改 _config.yml 文件并保存

这一步很关键！！！！！！！

保险起见可以复制以下的成功代码：

deploy:
type: git
repository:
branch: master

⑥ 在 Hexo 文件夹下分别执行以下命令

hexo g

hexo d

//或者直接

hexo g -d

执行完之后会让你输入你的 Github 的账号和密码，如果此时报以下错误，说明你的 deployer 没有安装成功。

ERROR Deployer not found: git

需要执行以下命令再安装一次：

npm install hexo-deployer-git --save

再执行 ：

hexo g

hexo d

你的博客就会部署到 Github 上了。

⑦ 访问博客

你的博客地址**：https://你的用户名.github.io，**比如我的是：https://KIKICHUANG-Q.github.io,现在每个人都可以通过此链接访问你的博客了。

六、在博客上发表文章

（1）新建一个空文章，输入以下命令，会在项目 \Hexo\source_posts 中生成 文章标题.md 文件，文章标题根据需要命名

hexo n "文章标题"

//或者：

直接在 \Hexo\source_posts 目录下右键鼠标新建文本文档，改后缀为 .md 即可，这种方法比较方便（推荐）

（1）用编辑器编写文章

md 全称 Markdown， Markdown 是 2004 年由 John Gruberis 设计和开发的纯文本格式的语法，非常的简单实用，常用的标记符号屈指可数，几分钟即可学会， .md 文件以使用支持 Markdown 语法的编辑器编辑，然后保存文件到 \Hexo\source_posts 文件夹下即可。

（3）当我们用编辑器写好文章后，可以使用以下命令将其推送到服务器上。

hexo g

hexo d

//或者

hexo d -g

Last：OKKK！现在访问你的专属博客即可见你写的文章啦！！！

七、美化

如果想让你的博客更加special的话，你可以登录Hexo官网，选择自己喜爱的主题进行更换，接下来就是慢慢码字学习的过程啦！