前言:

既然本文是极简笔记,那将不会把来龙去脉说个清楚,只记录下最关键和常用的步骤,详细文档请参阅官方文档Hugo中文文档

注:另可参阅博主:CoderZh的博文使用hugo搭建个人博客站点。原文地址:https://blog.coderzh.com/2015/08/29/hugo/

首先还是要先简单介绍下Hugo是什么,我们看看官方文档的介绍。

Hugo is a fast and modern static site generator written in Go, and designed to make website creation fun again.

简而言之,Hugo是一个用Go语言写的静态网站生成器,对于像生成静态博客网站这样的任务(也是最主要的任务),Hugo十分高效和快速,而且优雅(在我看来)。不像其他静态网站生成器在使用之前需要安装一大堆的包,配置各种文件,Hugo只需要一个二进制文件(hugo.exe,在Windows下的话),和一个网站的主题(后文会提到它的作用)。这是我十分欣赏的一点,就像官方文档介绍的一样,make website creation fun again,对于博客写作,更应该关注于写作本身,而不是将心力耗费在各种配置,调整文件上。(想起了水平不行时强行用Django自己学习写博客系统,汗`)话不多说,开始搭建。

第一步:安装

  1. 二进制安装

可以在Hugo Release下载对应操作系统版本的Hugo二进制文件。对于Ubuntu(14.04+)用户

1
2
   $ sudo apt-get install hugo
   $ hugo version # 查看版本 output v0.25.1
  1. 源码安装(参阅官方文档)或中文文档),在此不做介绍。

第二步:生成站点

以生成博客站点example-hugo-blog为例,生成到路径/path/to/example-hugo-blog/

1
2
 $ hugo new site /path/to/example-hugo-blog
 $ cd example-hugo-blog # 这个目录就是博客站点的目录

目录结构:

1
2
3
4
5
6
7
8
9
.
├── archetypes
├── content
├── data
├── layouts
├── static
└── themes

6 directories

各个目录主要作用参照官方文档,目前我们只需要关注两个目录,content(网站内容)和themes(网站主题)。

第三步:创建一些文章

在content目录下新建一个about.md页面(第一个页面总是关于自己的介绍嘛:),BTW,Hugo的默认写作格式是markdown,关于markdown的介绍,有空我会再写一篇博文。

1
2
3
# ~/example-hugo-blog/
$ hugo new about.md # 默认新建在content目录下 或者
$ hugo new path_you_want/about.md # 会新建content/path_you_want/about.md

新生成的页面默认内容与archetypes/default.md文件相同:

1
2
3
4
5
---
title: "About"
date: 2017-11-28T15:14:14+08:00
draft: true
---

“—”扩起来的内容是md文件的元数据,由Hugo自动生成。定义了关于这个页面要显示那些信息,如何渲染成html文件等等。以“—”分隔开是YAML格式,其他格式如以“+++”分隔的TOML格式详细内容见官方文档。接下来我们新建第一篇博文,为了统一管理,均放置在content/post/目录下。

1
$ hugo new post/first.md

使用任何你喜欢的编辑器编辑first.md文件,输入一些内容,保存。

安装皮肤主题

Hugo默认是不带皮肤的,需要自行下载使用,否则使用hugo server查看网站情况时会是一片白茫茫大雪真干净。在官方的皮肤列表选择一个下载使用。或者你也可以使用自己编写的主题,文档参阅这里

1
2
$ cd themes
$ git clone https://github.com/digitalcraftsman/hugo-cactus-theme.git

运行站点

1
2
# ~/example-hugo-blog
$ hugo server --theme=hugo-cactus-theme --buildDrafts

在浏览器地址栏打开localhost:1313,That’s all !Hugo搭建个人博客先告一段落,关于Hugo的部署有空我会再写一篇博文:2018.5.28 更新,请参看这里)Now,enjoy writing~