关于个人博客的建成

为什么选择Hugo #

Hugo是由Go语言实现的，无需搭建复杂的运行环境，几行命令行就能快速生产一个静态网站。 官网提供了多种风格的免费主题，还有优秀网站展示，满足了个人的自定义需求。

如何搭建 #

就像前面所说，只需要几行命令行就能够搭建出一个属于自己的博客。

安装Hugo #

首先得安装Hugo(git下载)。 Mac可直接使用brew install hugo安装。 windows系统安装完Hugo后需要配置环境变量，在命令行中输入hugo version来测试是否安装成功。

生成站点 #

输入命令行

hugo new [网站名称] [本地存放目录地址]

Mac就在想要创建博客的根目录下输入指令

hugo new site [名称]

就可在你想要的目录中生成网站文件。

创建文章 #

hugo new post/first.md

输入以上命令行就可在post目录下生成一个名为first的markdown格式文件。 打开文件大概长这样：

---
date: "2015-10-25T08:36:54-07:00"
title: "first"
draft: true # draft为true表示当前文章是草稿
---

###文章正文在这

设置主题 #

在官网提供的主题中选择自己心仪的主题，一般点进主题页都会有下载和配置文档，万变不离其宗。 当前我使用的主题叫congo，使用的是git submodule方式下载的：

cd [网站文件根目录]
git init
git submodule add -b stable https://github.com/jpanther/congo.git themes/congo

命令行中的地址是主题在git上的地址，后面跟着的是主题存放目录和主题文件名。 当然还有其它的下载方式，可以参考congo文档。

本地运行 #

然后我们就可以本地启动服务进行调试了：

hugo server --theme=congo --buildDrafts

theme=congo是设置主题，buildDrafts是指生成草稿，还记得前面文章中有个参数draft: true吗？如果没有这个命令，是看不到草稿文章的，需要将draft设为false才能显示在博客上。 然后就可以在浏览器打开http://localhost:1313预览本地博客了。

关于这块有一个坑 #

由于主题文件都是通过git submodule添加进来的子模块，当我从git上clone博客项目后再hugo server本地运行会报错，这时能看到主题文件夹里是空的，因为主题文件不会自动下载下来，只要git submodule update --recursive重新下载主题就好了。

部署到服务器 #

作为一个程序员，能免费的东西绝不花钱。这里我们就能用github提供的免费服务器来部署我们的博客，首先得在github上建一个新的库，库的名称设为[github用户名(全小写)].github.io.git。 在网站存放的根目录执行命令：

hugo --theme=congo --baseUrl="https://[github用户名(全小写)].github.io/"

后面的地址就是访问在线博客的地址。 命令行运行后，根目录下会有个public文件夹，把这个文件夹里的内容推到刚刚创建的github库里就完成部署了。

cd public
git init
git remote add origin [github库的完整地址]
git add -.
git commit -m 'fist commit'
git push -u origin master

文章更新 #

后续需要更新博文时，输入hugo指令，博客项目文件夹里的新文章就会发布到public文件夹内，再将public推到git库里就OK了。