hugo+github博客搭建教程！
QQ图片20190412232609.png
什么是hugo
Hugo是由Go语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署。对比Hexo，Hugo仅需一个二进制文件（hugo.exe）即可实现网站生成的生成。而且就如它官网介绍：The world’s fastest framework for building websites。Hugo是目前最快的网站构建框架。凭借其惊人的速度和灵活性，解决了环境依赖、性能较差的问题，还有使用简单、部署方便等诸多优点，通过 LiveReload 实时刷新，极大的优化文章的写作体验。Hugo使建站再次变得有趣。
hugo能做什么
hugo是静态网站生成器，能够作为一些展示类网站的解决方案。比如个人博客、产品介绍、个人作品展示、文档介绍、公司官网等等。再加上Github Pages的功能，就能不花一分钱建一个自己的网站了。
开始使用hugo！
下载安装hugo
我们为了简便快速当然选择hugo的二进制安装方式，源码安装有机会再去学习。
去hugo的官方github仓库下载对应的操作系统版本的Hugo二进制文件:
image
博主以windows64位操作系统为例，下载对应的Windows-64bit.zip。
image
下载完成后解压缩得到如上文件。
Mac下直接使用Homebrew安装：(其他步骤同理略)
brew install hugo
hugo环境变量配置
上一步操作，可以看到我们把hugo.exe解压到了D:\hugo下面。所以hugo命令只能在该目录下才能识别。但是我们想要把博客目录建到其他目录下，这就需要配置环境变量。
此电脑->右键->点击属性：
image
再点击高级系统设置：
image
点击环境变量
image
在系统变量中找到path，再点击编辑
image
点击新建，填入hugo解压的文件目录，比如博主解压在
D:\hugo就填的是D:\hugo
image
注意：win10以下系统界面不一样，比如win7，直接在path最前或最后加入地址就行，注意用英文
;分号分割开，不会的小白可以问度娘。配置好后点击确定，然后打开cmd命令行程序就可以在任意位置使用hugo命令了。
hugo新建博客
win+R键打开运行框，输入cmd打开命令行。
image
使用如下命令
hugo new site /path/to/site
比如hugo new site E:/hugo/hojunBlog就在E盘hugo文件夹下新建了一个叫hojunBlog的hugo站点。
image
hugo新建页面和文章
新建一个links页面：
hugo new links.md
links.md 自动生成到了 content/links.md，内容如下
---
title: "Links"
date: 2019-04-11T23:35:53+08:00
draft: true
---
创建第一篇文章，放到 post 目录，方便之后生成聚合页面。
hugo new post/myfirst.md
links.md 自动生成到了 content/post/myfirst.md，内容如下:(注意这里需要把draft删除掉，不然正式生产的时候不会生成文章，因为draft是草稿)
---
title: "Myfirst"
date: 2019-04-13T23:23:34+08:00
draft: true
---
hugo安装主题
新建文章后不要着急，还需要安装hugo主题才行。去官方主题列表themes.gohugo.io里去挑选自己想要的主题。
image
。我们这里以icarus主题为例来安装主题。github仓库地址github.com/digitalcraftsman/hugo-icarus-theme
image
根据文档clone主题
在Hugo站点运行的文件夹中
cd themes
git clone https://github.com/digitalcraftsman/hugo-icarus-theme.git
配置主题
找到icarus主题下的hojunBlog\themes\hugo-icarus-theme\exampleSite\config.toml复制其内容到根目录下的hojunBlog\config.toml中，接着修改根目录下的配置文件部分内容如下：
baseurl = "https://yourname.github.io"
languageCode = "en-us"
title = "Icarus"
# Enable comments by entering your Disqus shortname
disqusShortname = "spf13"
# Enable Google Analytics by entering your tracking code
googleAnalytics = ""
# Define the number of posts per page
paginate = 10
footnotereturnlinkcontents = "↩"
theme = "hugo-icarus-theme"
# Comment the themesDir option if you use this theme in production
themesDir = "./themes/"
其中重要的是baseurl、theme、themesDir的配置，其他的配置可以之后慢慢设置。baseurl需要改成你的github pages的仓库名，theme、themesDir改成主题目录名和主题路径（上图填的是相对路径）。
其他配置可以参考icarus主题的文档，这里就不做介绍了。
使用命令来预览、发布主题
在根目录（比如这里是hojunBlog下）执行：
hugo server
image
然后打开浏览器，输入
localhost:1313就可以看到自己的博客了！（注意之前说的文章里的draft: true要删掉哦）
image
接着就是要发布主题到github上了，注册github，新建yourname.github.io的仓库，配置SSH，复制仓库的github pages地址到之前说的配置的baseurl中(就是https://yourname.github.io)，这些步骤不会的可以去查看博主的hexo的github配置教程，是一样的。
最后然后使用命令：
hugo
就可以发布到github上，通过https://yourname.github.io访问你的博客了！
The End
hugo搭建博客教程就到这里了，欢迎大家加入
Hugo&Hexo博客群（技术交群聊二维码.png
