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

# Hugo 使用说明

- [Hugo 使用说明](#hugo-使用说明)
  - [1. 目录结构介绍](#1-目录结构介绍)
  - [2. 常用参数介绍](#2-常用参数介绍)
  - [3. 创建站点](#3-创建站点)
  - [4. 创新新文章](#4-创新新文章)
  - [5. 发布站点](#5-发布站点)
  - [6. 支持百度搜索](#6-支持百度搜索)

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

## 1. 目录结构介绍

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

## 2. 常用参数介绍

| 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]          | 输出详细信息 |

## 3. 创建站点

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

## 4. 创新新文章

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

## 5. 发布站点

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

## 6. 支持百度搜索

进入 [Baidu 搜索资源平台](https://ziyuan.baidu.com)->用户中心->站点管理->添加网站。

选择 HTML 文件验证，将下载到的 baidu_verify_code-xxxxx.html 文件放置到 \<Hugo>/public 目录下即可。