什么是Hugo

引用一下Hugo官网的描述

The world’s fastest framework for building websites.

Hugo是一个非常受欢迎的、开源的静态网站生成工具,它速度快,扩展性强。

更多关于Hugo的介绍,请参考Hugo的官网

Hugo的安装

Hugo速度快,而且不用依赖一大堆东西,一个二进制文件就可以搞定。

Github下载

我们可以直接从Github Release页面下载对应的二进制文件,然后把它放在系统环境PATH目录里即可使用。这个支持任何平台,根据自己的平台选择相应的二进制包即可。

Mac平台

Mac下Hugo提供了homebrew安装的方式,非常简便。

1
brew install hugo

Debian and Ubuntu平台

1
sudo apt-get install hugo

Windows平台

Windows下Hugo提供了Chocolatey方式的安装,通过如下命令即可。

1
choco install hugo -confirm

验证安装

安转完成后,打开终端,输入如下命令进行验证是否安装成功。

1
hugo version

如果没问题的话,会输出Hugo的版本号等一些信息。

Hugo的使用

创建站点

1
hugo new site blog

创建文章

创建about页面

1
hugo new about.md

about.md自动生成到content目录下。

创建一篇文章

1
hugo new posts/first.md

添加主题

Hugo默认不带主题,需要在主题网站 选择喜欢的主题,然后点击下载链接从GitHub下载到themes目录中。

1
git clone https://github.com/rujews/maupassant-hugo themes/maupassant

然后在Hugo的配置文件里config.toml(yaml, json)中进行如下配置,即可使用。

1
theme = "maupassant"

运行Hugo

在站点根目录下执行Hugo命令进行调试:

1
hugo server --theme=maupassant --buildDrafts

(注明:如果在config.toml中配置指定主题可以省略–theme参数。)

浏览器里打开http://localhost:1313就可查看新创建的站点了。

部署

将博客部署在GitHub Pages上,首先在GitHub上创建一个Repository,命名为qoant.github.io

在站点根目录执行Hugo命令生成最终页面:

1
hugo --theme=maupassant --baseUrl="https://qoanty.github.io/"

如果一切顺利,所有静态页面都会生成到public目录,将pubilc目录里所有文件push到创建的Repository的master分支。

1
2
3
4
5
6
cd public
git init
git remote add origin https://github.com/qoanty/qoanty.github.io.git
git add -A
git commit -m "first commit"
git push -u origin master

浏览器里访问https://qoanty.github.io/