Snake's Home

Hexo小试牛刀

Hexo: 独立博客新玩法

首先Hexo是一款基于Node.js的静态博客,它是由台湾的一位大学生写出来的,支持很多主题和Markdown,很多人都在使用。

我的理解,按照MarkDown的语法规则,免费的将自己网页部署到代码托管网站上去。Hexo就是这样一套自动生成网页的框架。
对于喜欢写独立博客的来说,是一个福音。不需要域名,服务器,备案等,就可以拥有自己的网站。

我记得以前是用jeklly托管到github上,我弄过,但是没坚持下来。
当知道有Hexo的时候,也写过一些。但是由于众所周知的原因,github经常打不开,导致部署常常出错,所以也没有坚持下来。
前段时间发现上github速度又可以了,打算重新在弄弄,坚持写下去。

1. 本地搭建

几条命令:


$ npm install -g hexo
$ mkdir Hexo
$ cd Hexo
$ hexo init
$ npm install

这样就安装完成了,NodeJs的安装,网上有很多的资料。

2. Start Server

在/Hexo下执行

1
2
$ hexo server
[info] Hexo is running at http://localhost:4000/. Press Ctrl + c to stop.

在浏览器中打开 http://localhost:4000/, 你就可以看到生成的博客了。

3. Create a new post

在/Hexo下执行

1
2
$ hexo new "your article name"
[info] File Created at \Hexo\source\_posts\your-article-name.md

4. Generate static files

$ hexo generate

it will generate file at the folder \Hexo\public\

5. Edit files

如果要更改文件,到\Hexo\source_posts 用markdown 语法编辑一下。
如果要删除,到这个目录下删除不想要的文章。
然后更新

1
2
3
hexo g == hexo generate <!--生成-->
hexo s == hexo server <!--启动服务来预览-->
hexo d == hexo deploy <!--部署-->

6. Deploy to github

1.建立与你用户名对应的仓库,仓库名必须为[your_user_name.github.io]

2.SSH

请参照 hexo重置ssh

3.配置config.yml

部署到Github前需要配置_config.yml文件,首先找到下面的内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
#Deployment
##Docs: http://hexo.io/docs/deployment.html
deploy:
type:
```
然后将它们修改为

``` bash
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: github
repository: git@github.com:snake/snake.github.io.git
branch: master

NOTE1:

Repository:必须是SSH形式的url(git@github.com:snake/snake.github.io.git),而不能是HTTPS形式的url(https://github.com/snake/snake.github.io.git),否则会出现错误。

NOTE2:

如果你是为一个项目制作网站,那么需要把branch设置为gh-pages。

4. Deploy

1
$ hexo deploy

7. 测试

当部署完成后,在浏览器中打开http://snake.github.io/(https://snake.github.io/) ,正常显示网页,表明部署成功。

8. 总结:部署步骤

每次部署的步骤,可按以下三步来进行。

1
2
3
hexo clean
hexo generate
hexo deploy

9. 总结:本地调试

在执行下面的命令后,

1
2
$ hexo g #生成
$ hexo s #启动本地服务,进行文章预览调试

浏览器输入http://localhost:4000,
查看搭建效果。此后的每次变更_config.yml 文件或者新建文件都可以先用此命令调试,尤其是当你想调试新添加的主题时。

可以用简化的一条命令
hexo s -g

常用命令:

1
2
3
4
5
6
7
8
9
10
11
12
13
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

命令的简写为:
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy