Hello EWEN

Hexo安装与部署到Github pages

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/keysNew SSH key,Title随便填写,作为你的电脑的一个记号。

add new ssh key

可以输入下面的命令,测试设置是否成功

$ 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中文文档