NotePublic/Software/Applications/Hugo/Hugo_使用说明.md

# Hugo 使用说明

Hugo 是由 Go 语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署。对比 Hexo，Hugo 仅需一个二进制文件（hugo.exe）即可实现网站生成的生成。而且就如它官网介绍：The world’s fastest framework for building websites。Hugo 是目前最快的网站构建框架。凭借其惊人的速度和灵活性，解决了环境依赖、性能较差的问题，还有使用简单、部署方便等诸多优点，通过 LiveReload 实时刷新，极大的优化文章的写作体验。Hugo 使建站再次变得有趣。

## 目录结构介绍

* archetypes：包括内容类型，在创建新内容时自动生成内容的配置
* content：网站内容，全部使用 markdown 格式
* layouts：网站模板文件，决定内容如何呈现
* static：图片、css、js 等静态资源
* themes：存放主题
* config.toml：网站的主配置文件

## 常用参数介绍

| Options                        | Description    |
|--------------------------------|----------------|
| --bind="127.0.0.1"             | 服务监听 IP 地址 |
| -p, --port=1313                | 服务监听端口 |
| -w, --watch[=true]             | 监听站点目录，发现文件变更自动编译 |
| -D, --buildDrafts              | 包括被标记为 draft 的文章 |
| -E, --buildExpired             | 包括已过期的文章 |
| -F, --buildFuture              | 包括将在未来发布的文章 |
| -b, --baseURL="www.datals.com" | 服务监听域名 |
| --log[=false]                  | 开启日志 |
| --logFile="/var/log/hugo.log"  | log 输出路径 |
| -t, --theme=""                 | 指定主题 |
| -v, --verbose[=false]          | 输出详细信息 |

## 创建站点

```bash
hugo new site <site name>
```

## 创新新文章

```bash
hugo new <dir and file name>
```

## 发布站点

```bash
hugo --buildDrafts --buildExpired --buildFuture
```