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,而且每次同步都会对远程博客系统完全覆盖。