我需要帮助减少 makefile 中的依赖项

Question

我创建了一个生成文件来生成一个简单的网页。 makefile 背后的想法是这样的：

• 我们正在编译一个网页，index.html
• index.html 需要一个必须编译的 stylus css main.sty
• 页面中使用了许多示例
  • 例如 one 的代码位于 lib/examples/one
  • 每个示例包含三个部分
    • 标记（.jade 模板文件）
    • 一些代码（.coffee 脚本文件）
    • 描述（.md markdown 文件）
• 构建脚本必须将每个示例渲染到单个 html 文件中
  • 使用Jade、Pygments、Markdown生成三个html文件
  • 使用 example.jade 模板将它们合并到一个示例文件中
    • example.jade 必须复制到正确的构建示例目录，因为模板语言只能进行相对导入。因此，为了导入 example/one/code.html，我们必须将模板复制到 example/one 并让它包含 code.html .
  • 完成后，每个示例 x 将编译为 tbuild/examples/x.html
• lib/index.jade 模板将移动到 >build （这样它就可以包含示例文件）
• 然后使用 Jade 将 index.jade 模板编译为 html

这是一个小小的简化，但更容易理解这边走。简化之处在于，每个示例中实际上有两个标记文件（left.html 和 right.html），并且代码文件都通过 pygments 运行和用作一个脚本，因此 code.html 和 code.coffee 都需要将其放入构建中。

现在，makefile 看起来像这样：

LIB = lib
BUILD = build
LIBEX = $(LIB)/examples
BUILDEX = $(BUILD)/examples
EXAMPLES = $(addsuffix .html,$(addprefix $(BUILDEX)/,$(shell ls $(LIBEX) | grep -v '.jade')))

all: $(BUILD)/main.css index.html

index.html: $(BUILD)/index.jade $(EXAMPLES)
    jade < $< --path $< > $@

$(BUILD)/index.jade: $(LIB)/index.jade
    mkdir -p $(@D)
    cp $< $@

$(BUILD)/main.css: $(LIB)/main.sty
    mkdir -p $(@D)
    stylus -u nib < $< > $@

$(BUILDEX)/%.html: $(BUILDEX)/%/template.jade $(BUILDEX)/%/left.html $(BUILDEX)/%/right.html $(BUILDEX)/%/code.html $(BUILDEX)/%/code.coffee $(BUILDEX)/%/text.html
    jade < $< --path $< > $@

$(BUILDEX)/%/template.jade: $(LIBEX)/template.jade
    mkdir -p $(@D)
    cp $< $@

$(BUILDEX)/%/left.html: $(LIBEX)/%/left.jade
    jade < $< --path $< > $@

$(BUILDEX)/%/right.html: $(LIBEX)/%/right.jade
    jade < $< --path $< > $@

$(BUILDEX)/%/code.html: $(LIBEX)/%/code.coffee
    pygmentize -f html -o $@ $<

$(BUILDEX)/%/code.coffee: $(LIBEX)/%/code.coffee
    mkdir -p $(@D)
    cp $< $@

$(BUILDEX)/%/text.html: $(LIBEX)/%/text.md
    markdown < $< > $@

clean:
    rm index.html -f
    rm $(BUILD) -rf

但问题是当我触摸“lib/examples/intro/code.coffee”并重新运行 make 时，我得到以下内容：

mkdir -p build/examples/intro
cp lib/examples/template.jade build/examples/intro/template.jade
jade < lib/examples/intro/left.jade --path lib/examples/intro/left.jade > build/examples/intro/left.html
jade < lib/examples/intro/right.jade --path lib/examples/intro/right.jade > build/examples/intro/right.html
pygmentize -f html -o build/examples/intro/code.html lib/examples/intro/code.coffee
mkdir -p build/examples/intro
cp lib/examples/intro/code.coffee build/examples/intro/code.coffee
markdown < lib/examples/intro/text.md > build/examples/intro/text.html
jade < build/examples/intro/template.jade --path build/examples/intro/template.jade > build/examples/intro.html
jade < build/index.jade --path build/index.jade > index.html
rm build/examples/intro/right.html build/examples/intro/code.coffee build/examples/intro/code.html build/examples/intro/left.html build/examples/intro/text.html build/examples/intro/template.jade

这可行， 这比重新生成示例所需要做的要多得多。我所希望的更像是这样的：

mkdir -p build/examples/intro
pygmentize -f html -o build/examples/intro/code.html lib/examples/intro/code.coffee
cp lib/examples/intro/code.coffee build/examples/intro/code.coffee
jade < build/examples/intro/template.jade --path build/examples/intro/template.jade > build/examples/intro.html
jade < build/index.jade --path build/index.jade > index.html

换句话说，我要问的是：

1. 当我更改一些小内容时，我需要做什么才能使 makefile 不会重建太多？
   • 在上面的示例中，当我触摸 code.coffee 时，left.html、right.html 和 text.html 都会被重建。我怎样才能防止这种情况发生？
2. 为什么 make 将 rm 命令放在输出的末尾？这似乎可能会导致一些不必要的重建。

感谢您从头到尾阅读这个问题！我知道我的 make-fu 有所欠缺，因此非常欢迎任何关于如何清理 makefile 并减少冗余的提示！

Answer 1

这个构建系统太大太复杂，无法轻松重现 - 我讨厌发布我没有测试过的解决方案 - 但尝试添加这一行：

.SECONDARY:

编辑：
我无法重现您所描述的行为，但我可以提供一些指导。

.SECONDARY: 是一条规则；它可以放在 makefile 中的任何位置。基本上，如果 Make 检测到一系列隐式规则 A->B->C，其中 A 是存在的文件，C 是目标，则它认为 B 是中间文件并且工作完成后将删除它。 .SECONDARY: 规则阻止删除。

您可以组合具有相同命令的规则。这：

foo: bar
    do something 
lt; $@

baz: quartz
    do something 
lt; $@

quince: geef
    do something 
lt; $@

可以重写为：

foo: bar

baz: quartz

quince: geef

foo baz quince:
    do something 
lt; $@

这将删除 makefile 中的大量冗余，也许会让事情变得更清晰。

Answer 2

就像@Beta提到的那样，您在这里遇到了中间文件的麻烦。

Makefile 中未明确提及，而是通过模式规则（带有 % 的规则）推断出的每个文件都是中间文件，并在 make 运行后立即删除。然后在下一次运行时重新制作。

这就是“问题”的核心： left.html 和 right.html 文件立即被删除。 Beta 已经提到将它们声明为 .SECONDARY 可以解决此问题，例如 make 手册告诉你。

通过在 Makefile 中的任何位置（实际上：任何地方）声明没有任何先决条件的目标 .SECONDARY，您可以将所有目标声明为辅助目标 - 因此，不会自动删除。

Answer 3

您还可以对非文件目标使用 PHONY 以提高性能。就像all 和clean 一样。请参阅此处了解更多信息： 目的是什么makefile 中的 .PHONY？