建立自己的github.io
建立自己的github.io,这个跟创建普通的github仓库一样,只是仓库的名字叫xxx.github.io。
配置git账号
如果本地已安装SourceTree并已使用github账号下载过项目,则请忽略。
$ git config --global user.name "Your name"
$ git config --global user.email xxx@email.com
配置github账号的SSH key
如果本地已安装sourceTree并已使用github账号下载过项目,则请忽略。
生成ssh公钥
$ ssh-keygen -t rsa -c "xxx@xxx.com"
三次回车即可生成ssh key,对于存放目录,可以使用默认,也可在默认的基础上添加自定义目录。个人倾向于自定义目录。
查看public key,并把它添加到github公钥中
$ cat ~/.ssh/id_rsa.pub
将#号后的内容拷贝到 Github 公钥中并保存即可。
具体可参考Github官网的配置,或参考码云关于ssh key的配置
Hexo安装
安装Node.js
brew install node
由于hexo的运行,依赖于Node.js,所以在安装hexo前,请先安装Node.js。
安装Hexo
$ npm install -g hexo-cli
Hexo的具体安装可参见其官网。
hexo简单使用
创建工程
$ hexo init myblog
创建新工程,名字就叫 myblog 。
创建新工程后,里面会有一堆的文件。其中(_config.yml)文件为工程配置文件,这里面包含了整个工程的运行配置,我们待会会对其进行修改。
修改配置
对(_config.yml)文件进行修改,主要更改点为 title 、 author 、 url 等。
git绑定
修改(_config.yml)中的 deploy ,将 type 更改为 git ,同时补充 repository 和 branch 信息, branch 为 master 。
与 github.io 这个仓库进行绑定,工程发布后,会将运行文件提交到 github.io 上,这样就可以通过 github.io 来访问博客了。
创建博文
$ hexo new myblog
新建一个名叫myblog的博文。
生成静态文件
$ hexo generate
该命令可简写为
$ hexo g
此命令执行后,会在工程里生成一个public文件夹,这个文件夹里的文件,包含了整个静态网站运行的所有文件。这些文件,会在我们部署网站的时候,提交到我们创建的github.io仓库里。
本地预览
$ hexo server
可简写为
$ hexo s
启动本地服务环境后,可在浏览器中输入http://localhost:4000/预览工程的运行。
部署网站
$ hexo deploy
可简写为
$ hexo d
若前面已配置过_config.yml中的Deployment,则执行部署后,会将public里的内容提交到我们的github.io中。大约5~10分钟,就可以通过github.io访问到自己的静态网站了。
清理缓存
$ hexo clean
在某些情况下(尤其是更改主题后),肯能出现站点运行异常,可执行此命令。
需要注意的是:若清空了缓存,则站点需要重新生成静态文件并发布。
hexo更换主题
修改主题
我们只需要在hexo的主题官网上挑选一个自己喜欢的主题,然后将其克隆到工程的thmes目录下,修改工程配置文件_config.yml,将theme修改成theme目录下的主题即可。
主题配置
hexo的主题配置,可参见其主题使用文档。
使用hexo写博客
创建博文
$ hexo new myblog
生成静态文件并发布
$ hexo g -d











网友评论