Hugo | Front Matter

Posted on Oct 12, 2022

什么是 Front Matter

是指 .md 文件最上面的这一部分内容

---
title: xxxxxx
date: 2022-10-10 09:39:50
type: tags
layout: tags=
---

每次执行 hugo new 命令新建文章时，Hugo 会从 ./archetypes 中寻找对应的 Front Matter 模板并自动添加到新建文件的最上方

Front Matter 里的参数定义了所在博文的外观、功能

常用 Front Matter 设置

没有兴趣客制化可以复制以下代码，添加进 ./archetypes/default.md 文件

---
# 使用时需删除注释和空行

# 创建和文件名相同的文章标题
title: "{{ replace .Name "-" " " | title }}"
description: ""
# 优化 URL
slug: "{{ replace .Name "-" " " | title }}"
author: ["Rubberduck"]
type: post/draft/page
date: {{ .Date }}
draft: false
# 随机匹配一张图片
image: https://picsum.photos/seed/picsum/800/600.webp?random={{ substr (md5 (.Date)) 4 8 }}
categories: ["Tutorials"]
tags: ["Hugo","tech"]
keywords: ["tutorials", "Hugo", "mac","tech"]
metaAlignment: center
coverMeta: in/out
coverSize: partial 
coverCaption: "文章cover图片描述"
isCJKLanguage: true
---

下面具体说明各项参数，

Front Matter 内容

参数	描述
title	标题，默认与文件名一致
date	默认为文件创建日期
type	文章类别，可选post/page/draft等等
slug	指定文章网址
update	文件更新日期
lastmod	文章最后更新日期
description	文章描述，会被抓去做SEO放在HTML的header中
categories	分类（不适用于分页）
tags	标签（不适用于分页）
hidden	是否隐藏文章，值为 true 时输入正确网址就可以查看
draft	是否为草稿，值为 true 时 Hugo 不编译这个文件
layout	指定文章使用的模板，不指定的话会使用根目录/_config.toml 中的默认配置 default_layout:post
comments	开启文章评论功能，默认为 true
permalink	覆盖文章网址
coverImage	设置文章封面图片
metaAlignment	设置文章title的位置
coverMeta	文章title放在封面图片中央还是外面
coverSize	封面图片大小

如果需要添加 Hugo 创建的 .md 文件的 Front Matter 模板没有的参数，可以编辑 archetypes 文件夹下的 default.md 文件

更多请参考官方文档 Hugo｜Front Matter

Hugo | Front Matter

什么是 Front Matter

常用 Front Matter 设置

Front Matter 内容

相关参考