Hugo+PaperMod使用教程
📚 Hugo + PaperMod 完整使用手册 目录 完整目录结构详解 Content 文件夹管理最佳实践 文章分类系统详解（分类/标签/系列） Hugo 所有常用命令速查表 完整写文章工作流（带例子） PaperMod 高级功能配置 常见问题与解决方案 1. 完整目录结构详解 📂 你的博客文件夹结构（每个文件夹的作用） your-blog/ ├── 📁 archetypes/ # 文章模板（新建文章时自动套用） │ └── default.md # 默认文章模板 ├── 📁 assets/ # 资源文件（CSS/JS，Hugo会自动处理） ├── 📁 content/ # ✅ 最重要！所有文章都在这里 ├── 📁 data/ # 自定义数据文件（YAML/JSON） ├── 📁 layouts/ # 自定义模板（覆盖主题） ├── 📁 static/ # ✅ 静态资源（图片/文件，直接复制到网站） │ ├── 📁 images/ # 放所有文章图片 │ └── favicon.ico # 网站图标 ├── 📁 themes/ # 主题文件夹（PaperMod在这里） ├── 📁 public/ # 构建后的网站（自动生成，不用管） ├── 📁 resources/ # Hugo缓存（自动生成） ├── ⚙️ hugo.toml # ✅ 主配置文件 └── ⚙️ .gitignore # Git忽略文件 2. Content 文件夹管理最佳实践 🎯 推荐的文章组织结构（按年/月/分类） content/ ├── 📁 posts/ # ✅ 所有博客文章（必须叫这个名字） │ ├── 📁 2026/ # 按年份分文件夹 │ │ ├── 📁 06/ # 按月份分文件夹 │ │ │ ├── 第一篇文章.md # 你的文章 │ │ │ └── 第二篇文章.md │ │ └── 📁 07/ │ │ └── 第三篇文章.md │ └── _index.md # 文章列表页的说明（可选） ├── 📁 categories/ # 分类页面（自动生成） ├── 📁 tags/ # 标签页面（自动生成） ├── about.md # 关于页面 ├── archives.md # 归档页面 └── search.md # 搜索页面 ✅ 简单版（新手推荐） content/ ├── 📁 posts/ │ ├── openclaw部署指南.md │ ├── hugo搭建教程.md │ └── ai工具对比.md ├── about.md ├── archives.md └── search.md 3. 文章分类系统详解 🎯 Hugo 有 3 种分类方式，灵活组合使用 分类方式 用途 例子 Categories（分类） 大的分类，一篇文章一个 技术、随笔、教程 Tags（标签） 灵活标记，一篇文章多个 OpenClaw、Hugo、AI Series（系列） 系列文章，连载用 OpenClaw 从入门到精通 📝 完整的文章 Front Matter 模板（复制即用） 每篇文章开头都要有这个： ...