Hugo

本文介绍在 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）的区别： ...

在搭建个人博客时，很多人会将博客的框架代码（如 Hugo/Hexo）、主题文件和文章的 Markdown 文件混在一个 GitHub 仓库里。这虽然简单，但随着文章越来越多，你的写作环境会被各种前端配置文件干扰；而且，如果你想写一些不公开的私密草稿，公开的仓库也无法满足需求。 为了获得最纯粹的写作体验，我采用了**「代码与内容分离」**的架构。今天这篇文章，就来详细聊聊如何基于 Hugo + PaperMod 主题，配合 Cloudflare Pages 部署这样一个现代化的博客。 架构概览：双仓库联动 我的博客由两个 GitHub 仓库组成： 引擎仓库 (公开)：PaperMod-Blog-Cloudflare 角色：博客的“打印机”与“骨架”。 内容：包含 Hugo 的配置文件、PaperMod 主题、自定义 CSS 等。没有实质性的文章内容。 内容仓库 (私有)：blog-content 角色：博客的“燃料”与“血肉”。 内容：纯净的 Markdown 文件和图片资源。 优势：设置为 Private（私有），确保草稿和私密笔记的安全。我平时只需要在这个文件夹里用 Obsidian 或 Typora 写作即可。 这两个仓库通过 Hugo Modules（Go Modules 底层）连接。当云端开始构建时，引擎会自动把内容仓库拉取过来，合并渲染成最终的网页。 部署痛点：Cloudflare 如何拉取私有内容？ 将公开的引擎仓库绑定到 Cloudflare Pages 非常简单，点几下鼠标即可。但核心难点在于：Cloudflare 在执行 hugo 构建命令时，如何绕过权限阻拦，成功拉取到私有的 blog-content 仓库？ 如果不做特殊处理，部署时 100% 会遇到如下报错： fatal: could not read Username for 'https://github.com': terminal prompts disabled Error: failed to load modules: failed to get ["github.com/monstercjz/blog-content@upgrade"] 这是因为 Cloudflare 的 CI/CD 环境没有图形界面，无法弹窗让你输入 GitHub 密码。 ...