什么是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二进制文件:

hugo_*.**.*_Windows-32bit.zip  12.7 MB (32位)
hugo_*.**.*_Windows-64bit.zip  13.8 MB (64位)

• 注意:*号是版本号

博主以windows64位操作系统为例，下载对应的Windows-64bit.zip，下载完成后解压缩得到文件。

hugo.exe    22.67 MB
LICENSE     0.01 MB
README.md   0.01 MB

苹果Mac下直接使用Homebrew安装：(其他步骤同理略)

brew install hugo

Hugo环境变量配置

上一步操作，可以看到我们把hugo.exe解压到了D:\hugo下面。所以hugo命令只能在该目录下才能识别。但是我们想要把博客目录建到其他目录下，这就需要配置环境变量。

此电脑-> 右键-> 点击属性-> 再点击高级系统设置-> 点击环境变量-> 在系统变量中找到path-> 再点击编辑

点击新建，填入hugo解压的文件目录，比如博主解压在D:\hugo就填的是D:\hugo就可以了。

注意：win10以下系统界面不一样，比如win7，直接在path最前或最后加入地址就行，注意用英文;分号分割开，不会的小白可以问度娘。 配置好后点击确定，然后打开cmd命令行程序就可以在任意位置使用hugo命令了。

Hugo新建博客

使用 win+R 键打开运行框，输入cmd打开命令行。

使用如下命令:

hugo new site /path/to/site

比如hugo new site E:/hugo/hojunBlog就在E盘hugo文件夹下新建了一个叫hojunBlog的hugo站点。

Hugo新建页面和文章 新建一个links页面：

hugo new links.md

links.md 自动生成到了content/links.md内容如下

---
title: "Links"
date: 2020-09-02T23:35:53+08:00
draft: true
---

创建第一篇文章，放到post目录，方便之后生成聚合页面。

   hugo new post/myfirst.md

links.md 自动生成到了content/post/myfirst.md内容如下:(注意这里需要把draft删除掉，不然正式生产的时候不会生成文章，因为draft是草稿)

---
title: "Myfirst"
date: 2020-09-02T23:23:34+08:00
draft: true
---

Hugo安装主题

新建文章后不要着急，还需要安装hugo主题才行。去官方主题列表 themes.gohugo.io 里去挑选自己想要的主题。

我们这里以icarus主题为例来安装主题。github仓库地址 github.com/digitalcraftsman/hugo-icarus-theme

根据文档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

然后打开浏览器，输入localhost:1313就可以看到自己的博客了！（注意之前说的文章里的draft: true要删掉哦）

接着就是要发布主题到github上了，注册github，新建yourname.github.io的仓库，配置SSH，复制仓库的github pages地址到之前说的配置的baseurl中(就是yourname.github.io)，这些步骤不会的可以去百度找教程，这里就不熬述了。

最后然后使用命令：

hugo

就可以发布到github上，通过 https://yakeing.github.io 访问你的博客了！ 当然如果你有自己域名还可以自定义域名.

The End

hugo 搭建博客教程就到这里了，欢迎大家加入.