如何编写支持多章节的Makefile，实现Markdown书籍转HTML/PDF并自动执行前置Python脚本

当然可以实现！而且你的项目结构完全没问题，用Makefile的模式规则就能一次性搞定所有章节的自动化编译，不用重复写规则。我给你整理一个完整的实现方案，还有入门提示帮你理解原理：

完整Makefile示例 #

直接把这段代码放到你的project/makefile里就能用：

# 定义工具变量，后续修改工具路径更方便
PANDOC := pandoc

# 自动获取所有章节目录（chapters下的子目录），新增章节无需手动修改
CHAPTERS := $(notdir $(wildcard chapters/*))

# 生成所有HTML和PDF的目标文件路径
HTML_TARGETS := $(addprefix output/html/,$(addsuffix .html,$(CHAPTERS)))
PDF_TARGETS := $(addprefix output/pdf/,$(addsuffix .pdf,$(CHAPTERS)))

# 声明伪目标，避免和同名文件冲突
.PHONY: all $(CHAPTERS) clean

# 默认目标：一键生成所有章节的HTML和PDF
all: $(HTML_TARGETS) $(PDF_TARGETS)

# 单个章节目标：执行`make chapter1`就会生成对应章节的HTML和PDF
$(CHAPTERS): output/html/%.html output/pdf/%.pdf

# 生成HTML的通用规则（匹配所有章节）
output/html/%.html: chapters/%/main.md
	# 先执行当前章节下所有Python脚本，确保图片已更新
	@cd chapters/$* && for script in *.py; do \
		if [ -f $$script ]; then python $$script; fi \
	done
	# 调用pandoc生成HTML文件
	$(PANDOC) -o $@ $<

# 生成PDF的通用规则（匹配所有章节）
output/pdf/%.pdf: chapters/%/main.md
	# 同样先执行章节内的Python脚本（保证单独执行PDF生成时图片也是最新的）
	@cd chapters/$* && for script in *.py; do \
		if [ -f $$script ]; then python $$script; fi \
	done
	# 调用pandoc生成PDF（需要提前安装LaTeX环境，比如TeX Live）
	$(PANDOC) -o $@ $<

# 清理所有生成的文件
clean:
	rm -f output/html/*.html output/pdf/*.pdf

关键逻辑解释 #

1. 动态识别章节：
   用wildcard chapters/*自动抓取所有章节目录，新增章节时不用修改Makefile，它会自动纳入编译范围。

2. 模式规则的核心作用：
   代码里的%是通配符，比如output/html/%.html会匹配所有章节的HTML输出文件，chapters/%/main.md对应章节的源文件。自动变量$@代表当前目标文件，$<代表依赖的源文件，$*代表匹配到的章节名（比如chapter1），这让规则能通用所有章节，不用为每个章节单独写代码。

3. 自动触发Python脚本：
   每个编译规则里都会先切换到章节目录，遍历执行所有.py脚本。如果想让脚本修改后强制触发重新编译，可以在Makefile里加一行依赖声明：

   chapters/%/main.md: chapters/%/*.py
   

   这样只要章节下的任何Python脚本修改，对应的main.md就会被标记为过时，触发重新执行脚本和编译。

4. 灵活的执行命令：

   • 执行make all：生成所有章节的HTML和PDF
   • 执行make chapter1：只更新chapter1的HTML和PDF
   • 执行make clean：清理所有生成的文件

入门学习提示 #

如果你想深入理解这些逻辑，建议重点看Makefile手册的这几个核心部分：

• 模式规则（Pattern Rules）：这是实现批量处理的核心，学会用%匹配目标和依赖
• 自动变量（Automatic Variables）：比如$@、$<、$*这些变量，能让规则更通用简洁
• 内置函数（Built-in Functions）：wildcard（查找文件）、addprefix/addsuffix（修改路径）这类函数能帮你动态生成文件列表
• 伪目标（Phony Targets）：理解为什么要声明伪目标，避免和实际文件重名导致的执行异常
• 依赖关系（Dependencies）：学会定义文件间的依赖，让Makefile自动判断哪些内容需要重新生成

内容的提问来源于stack exchange，提问作者John L