跳转至

Makefile 指南

这个 Makefile 为 Hugo 网站开发提供了便捷的命令。

快速开始

启动开发环境

# 方式1：启动 Hugo 服务器（会自动在后台启动文件服务器）
make server

# 方式2：启动完整开发环境（前台运行）
make dev

make server 会：

  • 在后台启动文件打开服务器（端口 8089）
  • 在前台启动 Hugo 开发服务器

make dev 会：

  • 并行启动 Hugo 服务器和文件服务器（都在前台运行）

查看所有可用命令

make help

主要命令

开发相关

  • make server - 启动 Hugo 服务器（自动后台启动文件服务器）
  • make dev - 启动完整开发环境（前台并行运行）
  • make stop - 停止所有服务
  • make status - 查看服务运行状态

构建相关

  • make build - 构建生产版本
  • make clean - 清理构建文件

PDF 导出相关

# 导出指定图书为 PDF
make pdf BOOK=content/zh/book/envoy-handbook

# 查看缓存信息
make cache-info BOOK=content/zh/book/envoy-handbook

# 清理缓存（默认清理 30 天前的）
make clean-cache BOOK=content/zh/book/envoy-handbook

# 清理指定天数前的缓存
make clean-cache BOOK=content/zh/book/envoy-handbook DAYS=7

系统检查

  • make check-deps - 检查所有依赖是否已安装
  • make install - 检查基本依赖

自动功能

  • IP 地址检测：自动获取本机 IP 地址用于 Hugo 服务器
  • 并行启动：make dev 会并行启动 Hugo 和文件服务器
  • 彩色输出：命令输出带有颜色标识，便于阅读
  • 错误处理：包含基本的错误检查和提示

注意事项

  1. 确保端口 1313 和 8089 没有被其他程序占用
  2. 文件服务器用于在网页中点击链接直接打开本地文件
  3. make server 推荐用于日常开发，会自动在后台启动文件服务器
  4. make dev 适合调试，可以看到两个服务的完整输出
  5. 使用 Ctrl+C 可以停止服务，建议使用 make stop 确保完全停止
  6. PDF 导出功能需要安装 Pandoc 和 XeLaTeX