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