内容管理

了解如何在 FixIt 主题中快速，直观地创建和组织内容。

内容组织

以下是一些方便你清晰管理和生成文章的目录结构建议：

• 保持博客文章存放在 content/posts 目录，例如：content/posts/my-first-post.md
• 保持简单的静态页面存放在 content 目录，例如：content/about.md
• 本地资源组织

前置参数

Hugo 允许你在文章内容前面添加 yaml, toml 或者 json 格式的前置参数。

• title: 文章标题

• subtitle: 文章副标题

• date: 这篇文章创建的日期时间它通常是从文章的前置参数中的 date 字段获取的，但是也可以在 主题配置 中设置

• lastmod: 上次修改内容的日期时间

• draft: 如果设为 true, 除非 hugo 命令使用了 --buildDrafts/-D 参数，这篇文章不会被渲染

• authorAvatar: 是否启用文章作者头像

• author: 文章作者

• authorLink: 文章作者的链接

• authorEmail: 文章作者的邮箱

• description: 文章内容的描述

• keywords: 文章内容的关键词

• license: 这篇文章特殊的许可

• images: 页面图片，用于 Open Graph 和 Twitter Cards

• tags: 文章的标签

• categories: 文章所属的类别

• featuredImage: 文章的特色图片

• featuredImagePreview: 用在主页预览的文章特色图片

• hiddenFromHomePage: 如果设为 true, 这篇文章将不会显示在主页上

• hiddenFromSearch: 如果设为 true, 这篇文章将不会显示在搜索结果中

• twemoji: 如果设为 true, 这篇文章会使用 twemoji

• lightgallery: 和 主题配置 中的 params.page.lightgallery 部分相同

• ruby: 如果设为 true, 这篇文章会使用 上标注释扩展语法

• fraction: 如果设为 true, 这篇文章会使用 分数扩展语法

• fontawesome: 如果设为 true, 这篇文章会使用 Font Awesome 扩展语法

• linkToMarkdown: 如果设为 true, 内容的页脚将显示指向原始 Markdown 文件的链接

• rssFullText: 如果设为 true, 在 RSS 中将会显示全文内容

• pageStyle: 页面样式，详见 页面宽度

• gravatarForce: 强制使用 Gravatar 作为作者头像

• toc: 和 主题配置 中的 params.page.toc 部分相同

• expirationReminder: 和 主题配置 中的 params.page.expirationReminder 部分相同

• code: 和 主题配置 中的 params.page.code 部分相同

• edit: 和 主题配置 中的 params.page.edit 部分相同

• math: 和 主题配置 中的 params.page.math 部分相同

• mapbox: 和 主题配置 中的 params.page.mapbox 部分相同

• share: 和 主题配置 中的 params.page.share 部分相同

• comment: 和 主题配置 中的 params.page.comment 部分相同

• library: 和 主题配置 中的 params.page.library 部分相同

• seo: 和 主题配置 中的 params.page.seo 部分相同

• type: 页面渲染模板，详见 页面模板

• menu: 详见 添加内容到菜单

• password: 加密页面内容的密码，详见 内容加密

• message: 加密提示信息，详见 内容加密

• repost: 和 主题配置 中的 params.page.repost 部分相同

• autoBookmark: 和 主题配置 中的 params.page.autoBookmark 部分相同

• wordCount: 和 主题配置 中的 params.page.wordCount 部分相同

• readingTime: 和 主题配置 中的 params.page.readingTime 部分相同

• endFlag: 和 主题配置 中的 params.page.endFlag 部分相同

• reward: 和 主题配置 中的 params.page.reward 部分相同

• instantPage: 和 主题配置 中的 params.page.instantPage 部分相同

1
2
3
4
5

resources:
  - name: featured-image
    src: featured-image.jpg
  - name: featured-image-preview
    src: featured-image-preview.jpg

1
2

hugo new posts/foo.md
hugo new --kind post-bundle posts/bar/

这是一个前置参数例子：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

---
title: "我的第一篇文章"
subtitle: ""
date: 2020-03-04T15:58:26+08:00
lastmod: 2020-03-04T15:58:26+08:00
draft: true
author: ""
authorLink: ""
authorEmail: ""
description: ""
keywords: ""
license: ""
images: []

tags: []
categories: []
featuredImage: ""
featuredImagePreview: ""

hiddenFromHomePage: false
hiddenFromSearch: false
twemoji: false
lightgallery: true
ruby: true
fraction: true
fontawesome: true
linkToMarkdown: true
rssFullText: false
pageStyle: "normal"

toc:
  enable: true
  auto: true
expirationReminder:
  enable: false
  # ...
code:
  copy: true
  # ...
edit:
  enable: false
  # ...
math:
  enable: true
  # ...
mapbox:
  accessToken: ""
  # ...
share:
  enable: true
  # ...
comment:
  enable: true
  # ...
library:
  css:
    # someCSS = "some.css"
    # 位于 "assets/"
    # 或者
    # someCSS = "https://cdn.example.com/some.css"
  js:
    # someJS = "some.js"
    # 位于 "assets/"
    # 或者
    # someJS = "https://cdn.example.com/some.js"
seo:
  images: []
  # ...
---

内容摘要

FixIt 主题使用内容摘要在主页中显示大致文章信息。Hugo 支持生成文章的摘要。

自动摘要拆分

默认情况下，Hugo 自动将内容的前 70 个单词作为摘要。

你可以通过在网站配置中设置 summaryLength 来自定义摘要长度。

如果您要使用 CJK中文/日语/韩语 语言创建内容，并且想使用 Hugo 的自动摘要拆分功能，请在网站配置中将 hasCJKLanguage 设置为 true。

手动摘要拆分

另外，你也可以添加 <!--more--> 摘要分割符来拆分文章生成摘要。

摘要分隔符之前的内容将用作该文章的摘要。

前置参数摘要

你可能希望摘要不是文章开头的文字。在这种情况下，你可以在文章前置参数的 summary 变量中设置单独的摘要。

使用文章描述作为摘要

你可能希望将文章前置参数中的 description 变量的内容作为摘要。

你仍然需要在文章开头添加 <!--more--> 摘要分割符。将摘要分隔符之前的内容保留为空。然后 FixIt 主题会将你的文章描述作为摘要。

摘要选择的优先级顺序

由于可以通过多种方式指定摘要，因此了解顺序很有用。如下：

1. 如果文章中有 <!--more--> 摘要分隔符，但分隔符之前没有内容，则使用描述作为摘要。
2. 如果文章中有 <!--more--> 摘要分隔符，则将按照手动摘要拆分的方法获得摘要。
3. 如果文章前置参数中有摘要变量，那么将以该值作为摘要。
4. 按照自动摘要拆分方法。

页面模板

一般情况，你不需要设置 type 参数，因为 Hugo 和 FixIt 会帮你选择。但是 FixIt 主题提供了一些特殊的模板给用户使用。

友情链接

在前置参数中设置 type: friends，并在 yourSite/data/ 目录下创建 friends.yml，其内容格式如下：

1
2
3
4
5

# 朋友/站点信息例子
- nickname: 朋友名字
  avatar: 朋友头像
  url: 站点链接
  description: 对朋友或其站点的说明

1

hugo new friends/index.md

离线页面

详见 PWA 支持

在前置参数中设置 type: offline，并在 config.toml 中开启 enablePWA：

1
2
3
4

[params]
  # enable PWA
  # 开启 PWA 支持
  enablePWA = true

1

hugo new offline/index.md

内容加密

这部分内容在 内容加密页面 中介绍。

Markdown 语法

这部分内容在 Markdown 基本语法页面 和 Markdown 扩展语法页面 中介绍。

Shortcodes

这部分内容在 Shortcodes 页面 中介绍。