我的第一篇文章
欢迎来到我的博客 这是我的第一篇博客文章,使用 Hugo + PaperMod 主题搭建。 功能特性 支持中英双语 深色/浅色主题自动切换 响应式设计 全站搜索 代码示例 def hello_world(): print("Hello, World!") 总结 感谢访问我的博客!
欢迎来到我的博客 这是我的第一篇博客文章,使用 Hugo + PaperMod 主题搭建。 功能特性 支持中英双语 深色/浅色主题自动切换 响应式设计 全站搜索 代码示例 def hello_world(): print("Hello, World!") 总结 感谢访问我的博客!
本文介绍在 PaperMod 博客中撰写文章的注意事项。 文章页面字段-必填项 每篇文章开头的 front matter 必须包含以下字段: --- title: "文章标题" # 必填:文章标题 date: 2026-03-16 # 必填:发布日期 --- 文章页面字段-常用可选项 --- # ===== 基础信息 ===== title: "文章标题" # 必填:文章标题 date: 2026-03-16 # 必填:发布日期(YYYY-MM-DD) lastmod: 2026-03-17 # 最后修改日期 description: "文章简介" # 文章描述,用于 SEO 和社交媒体分享 author: "作者名" # 作者名,覆盖默认设置 keywords: ["关键词1", "关键词2"] # SEO 关键词 # ===== 分类与标签 ===== tags: ["标签1", "标签2"] # 标签,细粒度分类,可多个 categories: ["分类名"] # 分类,粗粒度分类,通常一个 series: ["系列名"] # 系列文章,用于关联多篇相关文章 # ===== 发布状态 ===== draft: false # false = 发布,true = 草稿(不显示) publishDate: 2026-03-16 # 发布日期(可用于定时发布) expiryDate: 2026-12-31 # 过期日期,过期后文章不显示 # ===== 排序与置顶 ===== weight: 1 # 排序权重,数字越小越靠前(用于置顶) pinned: true # PaperMod 特有:置顶文章 # ===== 封面图片 ===== cover: image: "images/cover.jpg" # 封面图片路径(相对 static 目录) alt: "图片描述" # 图片 alt 文本(无障碍访问) caption: "图片说明" # 图片下方说明文字 relative: false # true = 相对于文章目录,false = 相对于 static # ===== 功能开关(覆盖全局设置)===== ShowToc: true # 是否显示目录 TocOpen: true # 目录是否默认展开 ShowReadingTime: true # 是否显示阅读时间 ShowShareButtons: true # 是否显示分享按钮 ShowBreadCrumbs: true # 是否显示面包屑导航 ShowPostNavLinks: true # 是否显示上一篇/下一篇导航 ShowCodeCopyButtons: true # 是否显示代码复制按钮 ShowWordCount: true # 是否显示字数 comments: false # 是否启用评论 # ===== 其他设置 ===== slug: "custom-url" # 自定义 URL 别名(默认用文件名) url: "custom-path/" # 自定义完整 URL 路径 type: "posts" # 内容类型(默认根据目录自动判断) layout: "custom-layout" # 自定义布局模板 --- 标签与分类 标签(tags)和分类(categories)的区别: ...
本文介绍在 PaperMod 博客中撰写文章的注意事项。 文章页面字段-必填项 每篇文章开头的 front matter 必须包含以下字段: --- title: "文章标题" # 必填:文章标题 date: 2026-03-16 # 必填:发布日期 --- 文章页面字段-常用可选项 --- # ===== 基础信息 ===== title: "文章标题" # 必填:文章标题 date: 2026-03-16 # 必填:发布日期(YYYY-MM-DD) lastmod: 2026-03-17 # 最后修改日期 description: "文章简介" # 文章描述,用于 SEO 和社交媒体分享 author: "作者名" # 作者名,覆盖默认设置 keywords: ["关键词1", "关键词2"] # SEO 关键词 # ===== 分类与标签 ===== tags: ["标签1", "标签2"] # 标签,细粒度分类,可多个 categories: ["分类名"] # 分类,粗粒度分类,通常一个 series: ["系列名"] # 系列文章,用于关联多篇相关文章 # ===== 发布状态 ===== draft: false # false = 发布,true = 草稿(不显示) publishDate: 2026-03-16 # 发布日期(可用于定时发布) expiryDate: 2026-12-31 # 过期日期,过期后文章不显示 # ===== 排序与置顶 ===== weight: 1 # 排序权重,数字越小越靠前(用于置顶) pinned: true # PaperMod 特有:置顶文章 # ===== 封面图片 ===== cover: image: "images/cover.jpg" # 封面图片路径(相对 static 目录) alt: "图片描述" # 图片 alt 文本(无障碍访问) caption: "图片说明" # 图片下方说明文字 relative: false # true = 相对于文章目录,false = 相对于 static # ===== 功能开关(覆盖全局设置)===== ShowToc: true # 是否显示目录 TocOpen: true # 目录是否默认展开 ShowReadingTime: true # 是否显示阅读时间 ShowShareButtons: true # 是否显示分享按钮 ShowBreadCrumbs: true # 是否显示面包屑导航 ShowPostNavLinks: true # 是否显示上一篇/下一篇导航 ShowCodeCopyButtons: true # 是否显示代码复制按钮 ShowWordCount: true # 是否显示字数 comments: false # 是否启用评论 # ===== 其他设置 ===== slug: "custom-url" # 自定义 URL 别名(默认用文件名) url: "custom-path/" # 自定义完整 URL 路径 type: "posts" # 内容类型(默认根据目录自动判断) layout: "custom-layout" # 自定义布局模板 --- 标签与分类 标签(tags)和分类(categories)的区别: ...