Hexo是一个基于Nodejs快速简洁高效的博客框架,Hexo使用Markdown语法来编辑文章,只需要几秒钟的时间就可以成生静态的网页。整个系统就是一个博客系统。
环境的配置
1. Node.js
因为Hexo是一个基于Node.js的静态博客框架,因此需要先安装Node.js环境,下载地址:Node.js
2. Git
此处为Windows平台下的下载地址:Git或者:GitHub Desktop。
Mac及其他操作系统请参考Hexo官方提供的下载链接。
3. Hexo
按装好 Node.js 后,通过下面的命令安装Hexo
npm install -g hexo-cli
注:如果安装出现错误,可以切换到国内的镜像源,再试
npm config set registry="http://registry.cnpmjs.org"
npm install -g hexo-cli
初始化Hexo
创建一个新的文件夹(如E:\hexo),打开Git Bash (有些命令会用到git ssh,建议以下命令都在Git Bash
中执行)
hexo init
执行init命令初始化可以指定目录,例如:hexo init blog
;这一步是在hexo目录下建立网站所需要的所有文件,除了public文件夹(public文件是生成的静态网站)
下一步 安装所需依赖包
npm install
Hexo基本命令
1.创建博文
hexo new "My New Post"
hexo n “< blog name >”是创建一篇新的博客,执行该命令之后在 /source/_posts/ 目录下产生< blog name >.md文件;
参考: Hexo Writing & Markdown 语法说明
2.启动服务器
hexo server
访问网址 http://localhost:4000/ 即可看到刚刚建立的博客
参考: Server
3.生成静态网页
hexo generate
参考: Generating
4.部署
hexo deploy
上传你的博客到服务器,参考: Deployment
以上命令都有缩写方式,如下
hexo new = hexo n #创建新博客
hexo generate = hexo g #生成静态网页
hexo server = hexo s #启动服务器
hexo delopy = hexo d #部署
部署Hexo到Github
1.创建仓库
打开github,注册或登录github的账户,在github上创建一个仓库 yourname.github.io
(yourname为你注册的用户名)
2.生成ssh 密钥
ssh-keygen -t rsa -C "<your github's email>"
一路按回车键即可,如果设置了密码请记住。 注意:-C
是大写
这一步在~/.ssh/下生成了两个文件id_rsa 和 id_rsa.pub (Windows 在C:\Users\用户名\.ssh
目录下)
3.在Github上添加SSH密钥
打开上述的id_rsa.pub 文件,复制其内容,在 https://github.com/settings/keys 下 New SSH key
,Title随便填写,作为你的电脑的一个记号。
可以输入下面的命令,测试设置是否成功
$ ssh -T git@github.com
4.配置_config.yml
编辑E:\hexo 下的_config.yml,修改 deploy 部分
deploy:
type: git
repo: ssh://git@github.com/yourname/yourname.github.io ##这个是你的仓库地址,yourname.github.io有空格
branch: master
5.设置用户信息
Git 会根据用户的名字和邮箱来记录提交。GitHub 也是用这些信息来做权限的处理,输入下面的代码进行个人信息的设置,把名称和邮箱替换成你自己的,名字必须是你的真名,而不是GitHub的昵称。
$ git config --global user.name "yourname" #用户名
$ git config --global user.email "yourname@gmail.com" #填写自己的邮箱
6.完成部署
hexo g
hexo d
部署报错:
1.检查依赖包 hexo-deployer-git 是否安装,如果没有
npm install hexo-deployer-git --save
2.检查命令行工具是否支持 git ssh 命令;建议Git Bash环境执行命令
7.绑定个人域名
1.在仓库根目录下添加一个CNAME文件,没有后缀名;内容为所绑定的域名
2.域名解析:如果解析顶级域名创建A记录到 192.30.252.153
;如果为二级域名,创建CNAME到 yourname.github.com.
其中cname为你的github用户名
更多参考: Hexo中文文档