Hexo + Github Pages快速搭建自己的博客


现在市面上的博客有许多,比如:博客园、简书、掘金等。虽然使用很人性化,发表内容也很方便,但终归不是自己的平台,经常会受限制。基于此,决定建立自己的博客。经过多方尝试,决定使用Hexo + Github Pages的方式,而这一切都是免费的。下面就带大家一起来搭建自己的博客。

Hexo 简介

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

只需要通过Markdown语法(Markdown快速上手教程[Markdown基础教程]),就可以写好自己的博客内容,然后通过简单的几个步骤就能够将生成的博客网页上传到 Github,大家就可以通过Github网址访问博客内容了。

安装部署

安装 Hexo 相当简单,只需要先安装下列应用程序即可:

  • Github账户

Github官网 上申请注册一个Github账户,并记住账户名邮箱

Github的账户名建议不要太复杂,但是又要能体现博客特点,方便别人访问并记住自己的博客。

新建public仓库

在Github的 Repository 页面建立一个public类型的个人仓库,仓库名称必须以**用户名.github.io**作为仓库名。

重要的事情说三遍:

public 类型的 用户名.github.io 名称的Github仓库

public 类型的 用户名.github.io 名称的Github仓库

public 类型的 用户名.github.io 名称的Github仓库

  • Git

Git官网上下载安装Git工具。

  1. Window下载并安装

  2. macOS:使用 Homebrew, MacPorts 或者下载并安装

  3. Linux(Debian,Ubuntu)sudo apt-get install git-core

  4. Linux(Fedora、RedHat、CentOS)sudo yum install git-core

我们已Windows系统为例。

安装成功后,将 Git 与 GitHub 账号绑定,右键打开 Git Bash,然后设置配置信息:

# 配置用户名和邮箱
git config --global user.name "github 用户名"
git config --global user.email "github 注册邮箱"

接着生成 ssh 密钥文件,输入如下命令后直接三次回车即可,一般不需要设置密码:

# 生成 ssh 密钥
ssh-keygen -t ed25519 -C "github 注册邮箱"

执行上述命令之后,一般在系统盘的当前用户目录下的.ssh目录下生成 id_rsaid_rsa.pub 两个文件,前者是我们私有的,而后者则是对外开放的。

然后打开 GitHub –> Settings –> SSH and GPG keys 页面,创建一个新的 SSH key,填写 TitleKeyTitle 可以随意,而 Key 的内容则是我们刚才复制的 id_rsa.pub 中的内容,最后点击 Add SSH key 即可。

  • Node.js

Node.js 为大多数平台提供了官方的 安装程序。对于中国大陆地区用户,可以前往 淘宝 Node.js 镜像 下载。

Windows 用户

使用 Node.js 官方安装程序时,请确保勾选 Add to PATH 选项(默认已勾选)

安装完成后,可以通过以下命令检查是否安装成功:

 node -v
 npm -v

由于下载包是从国外服务器,所以速度较慢,因此我们推荐用阿里的国内镜像进行设置:

npm config set registry https://registry.npm.taobao.org
  • Hexo

1、安装hexo-cli

hexo-cli是hexo的命令行工具,后续工作的很多操作都会用到此工具。

npm i hexo-cli -g

2、初始化

在指定目录新建自己的博客目录(此目录要保证持久稳定),然后切换到此目录。用如下命令进行初始化并安装必备组件:

hexo init .
npm install

初始化后,目录结构如下:

.
├── _config.yml   # 网站配置信息
├── package.json  # 应用程序信息
├── scaffolds     # 模板文件夹
├── source        # 用户资源
|   ├── _drafts   # 
|   └── _posts    # 
└── themes        # 主题文件夹

3、启动

输入如下命令,建立博客名,生成静态网页,启动本地服务器。

# 新建博客名称
hexo new "博客名"
# 生成静态网页
hexo g
# 启动本地服务器
hexo s

在浏览器中打开:http://localhost:4000 即可打开Hexo博客主页。

更多的Hexo操作及知识,请参考:Hexo中文文档

4、安装Hexo的Git插件

在博客目录下,安装 hexo-deployer-git 插件,这是Hexo与Github交互的插件。

npm install hexo-deployer-git --save

5、配置博客repo

在博客根目录中的修改站点配置文件 _config.yml

deploy:
  type: git
  repo: https://github.com/账户名/账户名.github.io

6、部署到Github

完成上述步骤之后,使用如下命令,就能将博客本地的内容推送到远程 GitHub 仓库了。

hexo clean  # 清除之前的内容
hexo g      # 重新生成静态文件
hexo d      # 上传到github

7、访问Github博客

在浏览器中访问:

https://用户名.github.io

比如我的博客网址:

左手烟火右手清欢(https://icnz.github.io/)


文章作者: 左手烟火右手清欢
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 左手烟火右手清欢 !
  目录