头信息 – Hugo Narrow

头信息

Frontmatter 是每个 Markdown 文件开头的 YAML 格式配置部分，使用两个 --- 包裹内容（数据格式不同，包裹的符号不同，推荐使用 YAML），用于设置文章的元数据和特定功能，在每篇文章中通过更改 Frontmatter 参数，可以实现对 hugo.yaml 相关参数的覆盖，更灵活的修改站点。不同的内容模板支持的 frontmatter 参数不同。

如果你不清楚什么是内容模板，请访问：内容模板。

默认内容模板

默认内容模板用于生成文章文件和未定义内容模板的其他内容。

基础配置

---
# 必填项
title: "文章标题"
date: 2025-06-13
# 可选项
description: "文章描述"
draft: false
categories: ["分类1", "分类2"]
tags: ["标签1", "标签2"]
slug: "custom-url"
---

如果你不在意 SEO，可以使用 ~/archetypes/default.md 文件中的配置自动生成 slug，会生成随机的 7 位字符串。

slug: {{ substr .File.UniqueID 0 7 }}

Note

访问 Hugo 文档了解更多 frontmatter 参数。

文章封面

通过下面的参数配置文章封面：

cover: ""

Hugo Narrow 文章封面存在回退机制：

cover 参数值
未设置 cover 参数
- 如果在 ~/data/placeholder_images.yaml 中设置 enabled: true，则使用随机封面列表
- 如果在 ~/data/placeholder_images.yaml 中设置 enabled: false，则自动生成随机占位图

固定封面

cover 值支持使用外部链接或本地资源，本地资源遵循 页面资源 > 全局资源 > 静态资源 的查找顺序。

如果你不清楚如何在 Hugo Narrow 中引入本地资源，请访问：本地资源

随机封面

未设置 cover 参数，并且~/data/placeholder_images.yaml 中设置 enabled: true，可在 ~/data/placeholder_images.yaml 中设置随机封面，配置如下：

enabled: true

# 图片URL列表（支持外部URL和本地路径）
images:
  # Picsum Photos
  #- "https://picsum.photos/800/600?random=1"
  #- "https://picsum.photos/800/600?random=2"
  #- "https://picsum.photos/800/600?random=3"
  #- "https://picsum.photos/800/600?random=4"
  #- "https://picsum.photos/800/600?random=5"
  #- "https://picsum.photos/800/600?random=6&blur=1"
  #- "https://picsum.photos/800/600?random=7&grayscale"
  # local images
  - "/images/placeholder/1.jpg"
  - "/images/placeholder/2.jpg"
  - "/images/placeholder/3.jpg"  
  - "/images/placeholder/4.jpg"
  - "/images/placeholder/5.jpg"
  - "/images/placeholder/6.jpg"
  - "/images/placeholder/7.jpg"
  - "/images/placeholder/8.jpg"

未设置 cover 参数，并且~/data/placeholder_images.yaml 中设置 enabled: false, Hugo Narrow 会自动生成几种图形的占位图，且适配不同主题配色。

其他配置

文章内容模板还支持其他配置，这些配置涉及到主题的一些功能，通常在 hugo.yaml 配置，但你也可以在头信息中修改覆盖。

# 公式
katex:
  enabled: true
  delimiters:
    - left: $$
      right: $$
      display: true
    - left: $
      right: $
      display: false

# 图表
mermaid:
  enabled: true

# 相关文章
showRelated: true

# 文章版权信息
post:
  license:
    show: true
    author: "Hugo Narrow"
    name: "CC BY-NC-SA 4.0"
    description: "This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. Please attribute the source, use non-commercially, and maintain the same license."
    url: "https://creativecommons.org/licenses/by-nc-sa/4.0/"
    displayName: "CC BY-NC-SA 4.0"

# Glightbox
lightbox:
  enabled: true
  loop: true
  width: 80vw
  height: 80vh
  touchNavigation: true
  draggable: true
  zoomable: true
  preload: true
  descPosition: bottom

# gallery
justified_gallery:
  enabled: true
  rowHeight: 300
  gutter: 30
  lastRow: center
  transitionDuration: 0.3s
  resizeDebounce: 100
  rowHeightTolerance: 0.25
  maxRowsCount: 999999
  calculateItemsHeight: false

项目内容模板

项目内容模板用于生成项目文件，基础的参数设置和默认内容模板一致，同时还存在特有的配置参数，下面是项目内容模板特有的头信息参数：

cover: "" # 和文章封面一致
featured: false
github: ""
demo: ""
website: ""
tech_stack:
  - Technology 1
  - Technology 2
status: "completed"  # Options: completed, in_progress, planning

内容模板 Markdown