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-made-simple

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

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

# 清理指定天数前的缓存
make clean-cache BOOK=content/zh/book/envoy-made-simple 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