目录

Hugo 操作纪要-个人向

基本使用

hugo 命令

一般的 hugo 命令包括 命令参数 两项,作为个人博主日常主要使用 生成新内容本地运行 两个命令,具体的使用方法如下:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
使用方法:
  hugo
  hugo [flags]
  hugo [command]
  hugo [command] [flags]

节选的 command:
  new         为你的站点创建新的内容
  server      一个高性能的 web 服务器

节选的 flags:
  -D, --buildDrafts                包括被标记为 draft 的文章
  -E, --buildExpired               包括已过期的文章
  -F, --buildFuture                包括将在未来发布的文章

举几个栗子:
  hugo -D                          生成静态文件并包括 draft 为 true 的文章
  hugo new post/new-content.md     新建一篇文章
  hugo new site mysite             新建一个称为 mysite 的站点
  hugo server -E                   启动服务器并包括已过期的文章

更多的 hugo 命令可以参考 官方文档

目录结构

  1. 站点目录结构
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
~/blog $ tree -L 1
.                   # 对比             Hexo
├── archetypes/     # 文章模板          scaffolds/
├── content/        # 文章目录          source/_posts/
├── data/           # Hugo 数据文件     source/_data/
├── layouts/        # 布局模板
├── public/         # 生成的静态文件     public/
├── resources/      # Hugo 缓存
├── static/         # 网站的静态文件     source/
├── themes/         # 主题目录          themes/
└── config.toml     # 配置文件          _config.yml
  1. 主题目录结构
1
2
3
4
5
6
~/blog/themes/divine $ tree -L 1
.
├── archetypes/
├── images/
├── layouts/
└── static/

站点目录下的文件可以覆盖主题目录下的相应文件——这意味着可以在不修改主题文件的前提下方便地定制主题。在 Hugo 中,如果想要定制主题,只需在站点目录下新建相应的文件即可。这是非常利于主题的维护的,只需使用 Git 的 submodule 的方式安装 Hugo 的主题,然后更新时只需直接在站点根目录下敲一条命令回车即可,非常方便!

文章设置

文章模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
categories: Diary, Reading, Studying
tags:
    - x
    - xx
    - xxx
type: "home"
toc: false
mathjax: false
codes: [bash, diff, markdown, python, r]
comments: false
vertical: false
image: true
draft: false