使用 make 翻译 reST 文件

Question

我在 help_pages/ 目录中有一堆文本文件，全部采用 reST 格式。我正在尝试向我的 GNU make Makefile 添加一些规则：

1. 运行 help_pages 目录（和子目录）中扩展名为“.rst”的每个文件' 通过一个输出有效 html 文件的应用程序（现在我只是使用 rst2html ）。
2. 将这些输出 html 文件复制到目标目录，从而重现 help_pages 目录中存在的目录结构。

因此，例如， help_pages/some/dir/foo.rst 首先会被翻译为 help_pages/some/dir/foo.html，然后复制到 public/help/some/dir/foo.html。

我花了一整天的时间试图学习 Makefile 的复杂之处，但最终我放弃了。这是我已经拥有的：

# Directory that the .rst files reside in:
HELP_DIR=help_pages
# use 'find' to locate all such files:
HELP_SRCS=$(shell find $(HELP_DIR) -name "*.rst")
# work out what path the intermediate files would be
HELP_TARGETS=$(HELP_SRCS:.rst=.html)

# do the translation.   
$(HELP_TARGETS): %.html: %.rst
        rst2html $< $@

help: $(HELP_TARGETS) 

.phony:
        help

这种工作原理 - .rst 文件被转换为 .html 文件，但我不知道如何将它们安装到最终的目标目录中。如果我将 cp 命令添加到主构建配方中，如果目标目录中不存在这些文件，则不会重新安装这些文件。

理想情况下，我想要一个目标来制作帮助文件，一个目标来安装它们，第三个目标（称为“帮助”）依赖于这两个文件。我想这会给我最大的灵活性。

谁能给我一些关于如何实现这一目标的提示？

干杯，

Answer 1

“我花了一整天的时间试图学习 Makefile 的复杂之处，但最终我放弃了。” 你不知道这有多有趣。

这应该可以做到：

HELP_DIR=help_pages
# use 'find' to locate all such files:
HELP_SRCS=$(shell find $(HELP_DIR) -name "*.rst")
# work out what path the intermediate files would be
HELP_TARGETS=$(HELP_SRCS:.rst=.html)
# and the destinations
HELP_INSTALL = $(patsubst help_pages%,public%,$(HELP_TARGETS))

# do the translation.
$(HELP_TARGETS): %.html: %.rst
    rst2html 
lt; $@          

# do the installation
$(HELP_INSTALL):public/%:help_pages/%
    cp 
lt; $@

.PHONY: help install

help: $(HELP_TARGETS)

install:$(HELP_INSTALL)

现在，如果您想做所有事情，只需 make install 即可。或者，如果您想创建 html 文件而不将其复制到 public/ 中，只需 make help 即可。您会发现依赖项可以正常工作。

Answer 2

make 使用目录分隔符对路径名进行“智能”处理，这使得编写跨不同目录执行操作的规则变得非常痛苦。

一种解决方法是将复制作为转换的副作用，例如添加一些内容作为第二个命令可能会起作用：

echo $@ | cpio -pdl public/html

顺便说一句，.PHONY 是大写的。