需要环境
hexo是一个静态博客生成器，包括当前这个博客，很多博客也是由此构建，类似的构建工具
还有jekyll这里只做hexo教程。
由于hexo是基于node.js构建的，所以需要nodejs的运行环境。
网上已经有很多教程了，但是我还是自己写一下吧
安装node.js
mac 安装
- 使用brew
1 | brew install nodejs |
- 官网下载
windows 安装
- 官网下载安装包
安装完成后使用命令
1 | node -v |
查看是否有版本号即可指导是否安装ok
npm是nodejs的包管理软件。
安装hexo
hexo是用nodejs编写的静态博客生成器。具体使用教程在官网
下面我只讲解怎么简单使用
1 | npm install hexo-cli -g |
使用命令创建博客目录(myblog)
1 | hexo init myblog //这一步是初始化myblog |
此时访问 localhost:4000 即可查看到博客
编写文章
1 | hexo new aricleName //这里是文章名 |
之后会在sorece->_posts目录下看到这个文章的源文件。采用markdown编写。
hexo更多api以及使用方式请查看官方文档
配置github pages
github pages 仓库和普通仓库相同。只有名字不同。
例如
仓库名为 xxxx.github.io 这里xxxx最好是自己的github名字，且不唯一，这里我已经用过了，
所以提示重复。
之后创建仓库即可
上传到静态文件到github pages
首先需要安装hexo的git deployer插件，不然手动上传很麻烦
官方文档
hexo-deployer-git
按着官方文档安装配置即可。下面我会简要讲述安装配置过程。
1 | npm install hexo-deployer-git --save |
打开博客根目录下的 _config.yml 配置文件，填写
1 | deploy: |
这里repo应该填写刚刚创建的仓库的git地址。这里我用的ssh链接。如果没有配置ssh秘钥可以用https链接
branch填写默认的master分支
保存
生成静态文件
1 | hexo g //generator简写 |
上传到github pages
1 | hexo d //deploy简写 |
更多hexo api 见文档
更改博客主题 见主题
不同主题也有不同的配置。详情见不同主题自己的文档。
访问
浏览器输入刚刚仓库名 xxx.github.io 即可。
例如上面我的是 garychangcn.github.io
不过我这里用cname转到自己的域名了。