这个是我用hugo+github搭建起个人blog写的第一篇文章,有点小兴奋。。。首先把搭建测过程写起来和大家分享一下吧。

首先,作为一个程序员,不拥有自己搭建的blog,而去用别人搭建好的去注册一下,我是无法接受的!!搭建个人blog需要两个东西:

1、静态网页生成器,有jekyll,hexo,hugo等,由于最近在玩go语言,所以就选择了hugo,其他的也没有深入了解,后面搭建起来,发现hugo还是比较简单。

2、github pages 这个是github提供的一个托管工作,相当好用。

静态页面生成器hugo

这个比较方便的静态页面生成器,首先需要安装,我的系统是centos 64位的.

现在换成了macos系统了。

install

1、直接下载二进制文件,这也是我说的方便的地方。

Hugo二进制下载地址:https://github.com/spf13/hugo/releases

2。使用macos系统后直接使用homebrew进行安装更新,这个就是一个类似于linux的yum的工具。

brew install hugo
brew upgrade hugo

use

下载下来后,首先要生成自己的站点:

`hugo new site mysite`--这边hugo的二进制文件不一定是这个名字,可以起个别名alias来用

这时会在mysite目录下生成一些目录和文件,这边简单的介绍一下

1、config.toml是网站的配置文件,这是它的作者GitHub联合创始人Tom Preston-Werner 觉得YAML不够优雅,捣鼓出来的一个新格式。如果你不喜欢这种格式,你可以将config.toml替换为YAML格式的config.yaml,或者json格式的config.json。hugo都支持。
2、content目录里放的是你写的markdown文章。
3、layouts目录里放的是网站的模板文件。
4、static目录里放的是一些图片、css、js等资源。

然后进入站点目录mysite,新建文档

`cd mysite`

`hugo new about.md`

这边新建一个md文件会出现在content目录下,一般这个about.md文件是一个关于本站的介绍或者blog个人介绍,在这边将一下md文件的编辑,其实就是MarkDown格式文件的编写,具体的格式可以参考本文的编辑,或者去网上去搜索一下就ok,这边我说几点,我经常记错

1、就是"+++"内的赋值用"=","---"内的用":"。

2、`###`后面必须有空格。

3、有空行才能换行。

一般我们写博文,会放在content/post下,正如我这边编写的第一篇文

`hugo new post/first.md`

然后用vim编辑器进行编辑,编辑好后,就可以将你编辑的文字生成静态网页了,当然你肯定需要一个模板,这样可以使你的网页根据美观,这边在讲一下模板的使用

模版

1、模板放在站点的themes下,一般木有这个文件夹,我们需要新增一个

`mkdir themes`

`cd themes`

2、模板可以到hugo官网上去找,那边可以showcase预览一下自己喜欢的,具体的安装方式也有介绍,就是用git clone把源码下到themes目录下就好

官网:https://gohugo.io/overview/introduction/

3、编辑模板的配置文件,这个视具体模板,可以参考我的配置https://github.com/kingjcy/

下面就是生成我们需要的静态网页了,也就是前端的html文件

`hugo --theme=hyde --baseUrl="http://kingjcy.github.io/"`

不出意外的话,应该在站点目录下生成一个public文件夹,这个就是我们需要的所有文件了,至此第一步已经完成了。可以看见直接编译是hugo,启动一个web服务是hugo server

使用

1、huo new XXXX生成文件是可以直接生成自己想要的内容的,取决于模版,默认是archetypes/default.md,可以对其进行修改,变成自己的样子。

2、使用图片,默认把图片放在media目录下

![](/media/worklife/baby/XXX.JPG)

github pages托管

这个就简单了,因为本身就是github提供现成的东西,首先新增一个repo,命名为:kingjcy.github.io (kingjcy替换为你的github用户名)。

然后将第一步的public加入git版本,上传到这个项目,就可以访问你的个人blog:http://kingjcy.github.io/

至于git版本控制和github直接的传输,这边就不多讲了,如果需要可以参考我的另外一篇博文《git和github的使用》。

这边简单列举一些过程

$ cd public
$ git init
$ git remote add origin https://github.com/kingjcy/kingjcy.github.io.git
$ git add -A
$ git commit -m "first commit"
$ git push -u origin master

终于搭建完了,欢迎指正,tks。