Hugo

Hugo 命令使用指南 Hugo 是基于 Go 语言开发的静态站点生成器，所有核心能力都可以通过命令行完成调用。本指南按使用场景分类，覆盖从项目初始化、本地开发、内容管理到生产构建的全流程命令，并附带参数说明、使用示例和最佳实践。 一、基础命令：帮助与版本查询 1. hugo help 查看 Hugo 所有命令的总览，也可以在任意子命令后加 --help 查看该命令的详细参数。 # 查看所有命令总览 hugo help # 查看 server 子命令的详细参数 hugo server --help # 简写 hugo server -h 2. hugo version 查看当前安装的 Hugo 版本、操作系统架构、Go 版本信息，常用于排查兼容性问题。 hugo version # 输出示例：hugo v0.128.0+extended linux/amd64 BuildDate=... 注意：带 extended 标识为扩展版，支持 Sass/SCSS 编译；多数主题需要扩展版才能正常构建。 3. hugo env 打印完整的 Hugo 运行环境信息，包括版本、配置路径、环境变量、模块缓存路径等，排查构建问题时常用。 hugo env 二、项目初始化与主题管理 1. hugo new site 创建一个全新的 Hugo 站点项目，生成标准的目录结构。 ...

📚 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 模板（复制即用） 每篇文章开头都要有这个： ...

🚀 Windows部署博客 总览：要安装 3 个软件，按顺序来 ✅ Git（版本控制） ✅ VS Code（写文章用的编辑器） ✅ Hugo（博客框架） 总共下载安装不超过 10 分钟！ 🔧 第一步：安装 Git（第一个软件） 1. 下载 打开浏览器，复制这个地址： https://git-scm.com/download/win 点击 Click here to download 自动下载 2. 安装 双击下载的 Git-2.xx.x-64-bit.exe 每一页按下面选，其他全部默认 Next： 安装页面 选择 ✅ 选择编辑器 👉 下拉选 Use Visual Studio Code as Git’s default editor ✅ 其他所有页面 直接点 Next ✅ 最后一页 点 Install 3. 验证安装成功 按 Win + R → 输入 cmd → 回车，输入： git --version ✅ 显示 git version 2.xx.x.windows.1 就对了！ ...