博客部署

Astro 命令使用指南 本文基于 Astro 4.x 稳定版 整理，覆盖从项目创建、开发调试、生产构建到工具运维的全流程命令，包含参数详解、使用示例、场景速查与常见避坑指南。 一、前置说明 1. 命令执行方式 Astro 命令有两种执行方式： 项目内执行：通过 package.json 脚本调用（推荐），格式为 npm run <脚本名> 直接调用：通过包管理器执行原生 Astro 命令，格式为 npx astro <子命令>（pnpm/yarn/bun 对应写法见下文） 2. 传参规则 通过 npm run 执行脚本时，额外参数必须用 -- 分隔，否则参数会被 npm 自身捕获而非传给 Astro。 # 正确写法 npm run dev -- --port 3000 # 错误写法（参数不生效） npm run dev --port 3000 pnpm/yarn/bun 兼容上述写法，也支持直接传参（如 pnpm dev --port 3000）。 3. 不同包管理器命令对照表 功能 npm pnpm yarn bun 创建项目 npm create astro@latest pnpm create astro yarn create astro bun create astro 启动开发服务 npm run dev pnpm dev yarn dev bun dev 生产构建 npm run build pnpm build yarn build bun build 预览构建产物 npm run preview pnpm preview yarn preview bun preview 执行原生命令 npx astro <子命令> pnpm astro <子命令> yarn astro <子命令> bunx astro <子命令> 4. 全局通用参数 所有 Astro 子命令都支持以下基础参数： ...

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 就对了！ ...