用子目录的制作费

Question

我正在写书。这些章节将写在Markdown（.MD）中，然后使用Pandoc转换为HTML和PDF（通过乳胶）版本。每章都有一些相关的Python脚本，这些脚本会生成一些图像，并且需要在构建本章之前运行。我正在尝试编写一个将所有章节汇编为这两种格式的makefile。

目前，该项目的结构如下：

project
  |--- makefile
  |--- chapters
    | --- chapter1
      | --- main.md
      | --- genimage.py
      | --- genanotherimage.py
    | --- chapter2
      |--- main.md
      |--- otherimage.py
    | --- output
      | --- html
        | --- chapter1.html
        | --- chapter2.html
      | --- pdf
        | --- chapter1.pdf
        | --- chapter2.pdf

我想键入“ MAKE Chapter1”（或类似），并刷新输出/HTML/Chapter1.html和Output/PDF/PDF/Chapther 1.pdf，重新运行所有内容。 PY脚本在相应的目录中是否已更改。理想情况下，我将有一个规则可以并行处理所有章节，而不是每个章节的规则。 （实际命令生成html/pdf是“ pandoc -o output/html/chapch1.html章节1/main.md”等等。）

我对Make and Meking并不十分熟悉，到目前为止，我的尝试一直没有成功。我无法设法在有多个文件要更新的地方实现目标，也没有设法使用模式来处理每个章节。如果这使事情变得更容易，我很乐意重组。

使用makefile是否可以使用此工作流程？我很高兴任何提示开始。我很茫然，甚至只知道在手册中查找的正确事物将非常有帮助。

Answer 1

以下基于您显示的项目树并假设 GNU make。它还假设您必须从项目的顶级目录运行 pandoc 和 python 脚本。模式规则可能会有所帮助：

CHAPTERS := $(notdir $(wildcard chapters/chapter*))
.PHONY: all $(CHAPTERS)

all: $(CHAPTERS)

$(CHAPTERS): %: chapters/output/html/%.html chapters/output/pdf/%.pdf

chapters/output/html/%.html chapters/output/pdf/%.pdf: chapters/%/main.md
    for python_script in $(wildcard $(<D)/*.py); do ./$python_script; done
    mkdir -p chapters/output/html chapters/output/pdf
    pandoc -o chapters/output/html/$*.html <other-options> 
lt;
    pandoc -o chapters/output/pdf/$*.pdf <other-options> 
lt;

主要的微妙之处在于，当 GNU make 遇到具有多个目标的模式规则时，它会认为配方的一次执行会构建所有目标。在我们的例子中，HTML 和 PDF 输出是通过相同的配方执行生成的。

注意：使用最新版本的 GNU make 规则与分组目标 (&:) 执行相同的操作。

这并不是 100% 完美，因为如果您修改或添加 python 脚本，章节将不会被重建。如果您也需要这个，我们将需要更复杂的 GNU make 功能，例如 二次扩展或评估。

二次扩展示例：

CHAPTERS := $(notdir $(wildcard chapters/chapter*))
.PHONY: all $(CHAPTERS)

all: $(CHAPTERS)

$(CHAPTERS): %: chapters/output/html/%.html chapters/output/pdf/%.pdf

.SECONDEXPANSION:

chapters/output/html/%.html chapters/output/pdf/%.pdf: chapters/%/main.md $(wildcard chapters/$*/*.py)
    for python_script in $(wildcard $(<D)/*.py); do ./$python_script; done
    mkdir -p chapters/output/html chapters/output/pdf
    pandoc -o chapters/output/html/$*.html 
lt;
    pandoc -o chapters/output/pdf/$*.pdf 
lt;

要了解为什么 $$(wildcard Chapters/$$*/*.py) 中的 $$，请参阅 GNU make 手册。

eval 示例：

CHAPTERS := $(notdir $(wildcard chapters/chapter*))
.PHONY: all $(CHAPTERS)

all: $(CHAPTERS)

$(CHAPTERS): %: chapters/output/html/%.html chapters/output/pdf/%.pdf

# $1: chapter
define CHAPTER_RULE
PYTHON_SCRIPTS_$1 := $(wildcard chapters/$1/*.py)

chapters/output/html/$1.html chapters/output/pdf/$1.pdf: chapters/$1/main.md $(PYTHON_SCRIPTS_$1)
    for python_script in $(PYTHON_SCRIPTS_$1); do ./$$python_script; done
    mkdir -p chapters/output/html chapters/output/pdf
    pandoc -o chapters/output/html/$1.html $<
    pandoc -o chapters/output/pdf/$1.pdf $<
endef
$(foreach c,$(CHAPTERS),$(eval $(call CHAPTER_RULE,$c)))

要了解为什么 $$ 或 $$$$，请参阅 GNU make 手册。