如何使用Github Pages和Hexo搭建自己独立博客

- 前言

首先感谢您能访问我的博客:TRHX’Blog

这是一篇有关如何使用 Github PagesHexo 搭建属于自己独立博客的详尽教程,本人是软件工程专业本科生,目前只学习了C和C++编程语言,对网站开发的有关知识几乎为零,这也是我搭建好自己的博客之后写的第一篇博客,刚开始搭建博客的时候自己也是网上各种百度,由于自己属于小白那种,历经了千辛万苦才弄好,所以借这个机会写一篇小白真正能看懂的博客搭建教程,教你一步一步走向成功的彼岸!

推荐文章:《我为什么写博客》  《为什么你应该(从现在开始就)写博客》

- 入门

Github Pages

Github Pages可以被认为是用户编写的、托管在github上的静态网页。使用Github Pages可以为你提供一个免费的服务器,免去了自己搭建服务器和写数据库的麻烦。此外还可以绑定自己的域名。

Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

话不多说,步入正题

- 安装Node.js

点击此处访问官网,按需下载相应版本,默认安装可以了

注:本人在安装过程中出现了Warning 1909,无法创建快捷方式,这种情况很少出现,如果在安装过程中也有这种情况请参考百度文库(win10系统实测可行):《Win7 安装程序快捷方式报错 警告1909,无法创建快捷方式》

- 安装Git

点击此处访问官网,按需下载相应版本,默认安装即可

参考资料:《如何在windows下安装GIT》

Git相关教程:《Pro Git(中文版)》

- 检验软件是否安装成功

同时按下Win键和R键打开运行窗口,输入“cmd” ,然后输入以下命令,有相应版本信息显示则安装成功,若不正确可以卸载软件重新安装,此外若安装成功,在桌面右键鼠标,可以看到菜单里多了Git GUI HereGit Bash Here两个选项,第一个是图形界面的Git操作,另一个是命令行

git –version

node -v

npm -v


- Hexo安装

选择一个磁盘,新建一个文件夹,自己重命名文件夹(如:我的文件夹为:E\TRHX_Blog),博客相关文件将储存在此文件夹下,在该文件夹下右键鼠标,点击 Git Bash Here,输入以下npm命令即可安装,如图所示即为安装成功

$ npm install hexo-cli -g          //安装hexo

$ npm install hexo-deployer-git –save   //安装hexo部署到git page的deployer

- Hexo初始化配置

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

$ hexo init


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

- 本地查看效果

执行以下命令,执行完即可登录 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上

一、注册Github账户:点击此处访问Github官网,点击Sign Up注册账户

二、创建项目代码库:点击 New repository 开始创建,步骤及注意事项见图:

三、配置SSH密钥:只有配置好ssh密钥后,我们才可以通过git操作实现本地代码库与Github代码库同步,在你第一次新建的文件夹里面 Git Bash Here 输入以下命令:

$ ssh-keygen -t rsa -C “your email@example.com
        //引号里面填写你的邮箱地址,比如我的是tanrenhou@126.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

四、在GitHub账户中添加你的公钥

1.登陆GitHub,进入你的账户设置:

2.点击SSH and GPG Keys:

3.选择New SSH key:

3.粘贴密钥:

五、测试

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

$ ssh -T git@github.com

之后会显示:

输入yes后会显示:

此时表示设置正确

六、配置Git个人信息

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

$ git config –global user.name “此处填你的用户名”

$ git config –global user.email “此处填你的邮箱”

到此为止SSH Key配置成功,本机已成功连接到github

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

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

二、鼠标移到 Clone or download 按钮,选择Use SSH

三、一键复制地址

四、打开你创建的Hexo文件夹(如我的路径是:E:\TRHX_Blog\Hexo),右键用记事本(或者Notepad++)打开该文件夹下的_config.yml文件

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

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

$ hexo g

$ hexo d

或者直接执行

$ hexo g -d

执行完之后会让你输入你的github的账号和密码

如果此时报以下错误,说明你的deployer没有安装成功

ERROR Deployer not found: git

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

npm install hexo-deployer-git –save

再执行hexo g -d,你的博客就会部署到Github上了

七、访问博客

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

- 如何在博客上发表文章

博客已经成功搭建了,但是我们该怎么写博客呢?

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

$ hexo n “文章标题”

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

二、用编辑器编写文章

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

推荐windows上使用 MarkdownPad2 编辑器,macOS 上使用 Mou 编辑器,Web 端上使用简书

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

$ hexo g

$ hexo d

或者将两个命令合二为一

$ hexo d -g

现在访问你的博客就可以看见写好的文章啦!

相关资料:《10款流行的Markdown编辑器,总有一款适合你》

     《献给写作者的 Markdown 新手指南》

     《认识与入门 Markdown》

     《markdown简明语法》

     《markdown基本语法》

     《Markdown 公式指导手册》
           

- 如何为博客更换自己喜欢的主题

但是默认的主题并不喜欢怎么办?

,