Skip to Main Menu

Hugo简易使用指南

Posted on

Hugo基于go语言的开源静态站点生成器，相比Jekyll更易用。Hugo提供内署服务器，内容可以运行在本地，也可以可以部署到GitHub,GitLab等上。支持MarkDown，可用于Blog、文档、公司站点写作。

安装与部署

安装部署相当简单，直接参照官网：

配置

站点配置

站点配置包含两部分：基本配置与主题配置。 打开站点根目录下文件config.toml，基本配置如下：

    baseURL = "https://example.org/"  # 部署到已有域名使用，本地不用
    languageCode = "en-us"
    title = "My New Hugo Site"  # 站点标题
    theme = "ananke" # 站点使用主题，或可以通过命令运行时，每次指定

主题配置，需参照各主题说明文档。

文章配置

通过Front Matter，配置每篇文章的元数据,放置文章MarkDown开头，配置样例如下：

---
title: "spf13-vim 3.0 release and new website"
description: "spf13-vim is a cross platform distribution of vim plugins and resources for Vim."
tags: [ ".vimrc", "plugins", "spf13-vim", "vim" ]
lastmod: 2015-12-23
date: "2012-04-06"
categories:
  - "Development"
  - "VIM"
slug: "spf13-vim-3-0-release-and-new-website"
---
  • date: 文章创建时间
  • description: 内容描述
  • draft: true|false, true时，正常不会展示，除非增加 -D选项
  • expiryDate: Date, 文章过期时间，超过将不展示，除非增加-E选项
  • lastmod：Date，最后修改时间
  • publishDate: Date, 发布时间，如果时间未到，将不会发布，除非增加-F选项
  • title：标题
  • categories，tags，内置分类与标签
  • slug：定制url，否则用标题与目录结构作为url
  • weight: 控制在列表中显示顺序

常用命令

常用命令如下，其它可以通过帮助查看：

 hugo --help
  • 生成站点：
 hugo new site "对应站点目录"
  • 添加主题：直接下载主题到站点themes目录
  • 生成内容：内容生成到站点public目录
 hugo [Flags]

常用Flags选项：

-D 包含草稿
-F 包含未来发布内容
-E 包含已过期内容

  • 启动本地服务：
 hugo server [Flags]

Flags与生成内容一样

其它

站点文章默认按目录结构组织，每个目录可以设置自己的目录页_index.md,Hugo展示目录页内容与目录中文章相关内容。content目录下_index.md为首页。样例如下：

---
title: 首页
menu: main
weight: -270
---
> 生活并不要求我们成为最好的，只求我们全力以赴。

对新手，最简单使用方式，了解基本概念后，然后找个主题示例，调整配置观察变化。