Skip to content →

Hexo+Github搭建博客

Hexo是由Node.js驱动的一款快速简单且功能强大的博客框架,支持MarkDown语法编写文章,可生成静态网页托管在GitHub或其他网站。本文将讲述搭建Hexo博客的整个流程。

一. 安装Node.js

在Windows环境下安装Node.js非常简单,仅须到nodejs.org下载安装文件,双击运行,一路Next即可,一般不需要自己配置环境变量。

二. 安装Git

在Windows环境下安装Git也也同样是一路Next,安装文件可到Git for windows下载。

  • Git基本操作
  • git init     新建一个仓库
  • git clone    将远程仓库复制到本地
  • git pull    抓取远程仓库所有分支的更新并合并到本地
  • git add .    跟踪修改过的所有文件
  • git commit   提交修改
  • git push    推送更新到远程仓库

三. 安装Hexo

1. 安装Hexo

右键桌面任意位置,打开Git Bash,执行命令:

npm install -g hexo

如果出现错误,可能是因为被墙,执行以下命令将镜像源换成国内的,然后再重复安装操作。

npm config set registry="http://registry.cnpmjs.org"

2. 创建Hexo目录

根据自己的喜好创建目录,例如D:\Hexo,在目录下生成搭建网站所需要的文件,方法是在该目录下右键打开Git Bash,执行命令:

hexo init

Hexo目录下文件信息:

_config.yml     全局配置文件
package.json    应用数据文件,包含版本和组件信息
scaffolds      模版文件夹
source        文章和资源文件夹,最好定期备份
themes        主题文件夹

3. 安装Hexo插件

在Hexo目录下继续执行命令:

npm install

上述操作只会安装几个基本插件,个人建议将下面的插件都安装完:

npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install [email protected] --save
npm install [email protected] --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save

四. 搭建本地博客

在Hexo目录下执行命令:

hexo generate
hexo server

至此,本地博客系统已经搭建完成,可在浏览器访问http://localhost:4000查看效果。

Hexo基本操作
  • hexo g = hexo generate   生成静态博客,对博客系统修改后需通过该命令来重新生成
  • hexo n = hexo new      创建一篇新的博客
  • hexo s = hexo server     在本地开启博客系统
  • hexo d = hexo delopy     上传本地博客到服务器

五. 创建远程仓库

1. 注册Github账户

如果没有Github账户,可以访问https://github.com/,注册一个新账户。

2. 创建仓库

登陆Github,创建一个Repository,其中Repository Name和用户名相同。比如我的用户名为liwz11,那么liwz11.github.io就是我的仓库名称。

六. 配置SSH

1. 配置用户

Git会根据用户的姓名和邮箱来对每次提交进行记录,GitHub也是用这些信息来做权限处理。执行以下命令进行用户设置,把姓名和邮箱替换成你自己的,这里的姓名是随意的,邮箱是你的联系邮箱。

git config --global user.name "your name"
git config --global user.email "your email address"

2. 配置SSH

在本地修改内容之后,可以直接通过git操作将其同步到远程的Github,这归功于Github的SSH密钥。执行以下命令生成SSH密钥:

ssh-keygen -t rsa -C "your email address"

首先会提示设置密钥文件的存储路径,直接回车默认即可。接着,会提示输入密码并确认。完成之后,会在~/.ssh/目录下生成id_rsa和id_rsa.pub文件,运行如下命令,将公钥复制到系统粘贴板clipboard中。

clip < ~/.ssh/id_rsa.pub

接着,登陆GitHub,进入Account Settings > SSH and GPG Keys,点击New SSH key,粘贴刚才复制的密钥,添加即可。

3. 测试

执行如下命令看看是否成功,如果之前配置SSH密钥时设置了密码,会提示输入密码。

ssh -T [email protected]

至此,本机已成功连接到Github。

七. 将本地博客部署到Github

1. 配置_config.yml

编辑Hexo目录下的_config.yml文件,修改Deployment部分如下:

deploy:
 type: git
 repository: [email protected]:liwz11/liwz11.github.io.git
 branch: master

注意,冒号之后必须有一个空格,将repository的内容替换成你的仓库地址,可以登陆Github进入刚才创建的仓库中进行拷贝,我用的是SSH URL,仓库地址的一般格式为:

HTTPS URL: [email protected]:Github账号/Github账号.github.io.git
SSH   URL: https://github.com/Github账号/Github账号.github.com.git

2. 部署

在Hexo目录下执行命令:

hexo deploy

根据提示,需要输入刚才配置SSH时设置的密码,等待一会即可部署完成。

结束

至此,博客搭建成功,可通过浏览器访问,比如我的博客地址是liwz11.github.io。需要特别说明的是,本地博客系统的任何改动都需要重新执行 hexo g  hexo d 命令才能同步到Github,而且每次同步都会对远程博客系统完全覆盖。

Published in 未分类