linux - 在自定义手册页中包含来自外部文件或 shell 命令的变量？

Question

我正在编写一些自定义 man 页面，我想包括可能经常更改的内容，例如编写 man 页面的日期。

例如，一个在 git repo 中，每当对其进行更改时，我想更新 man 页面的日期无需手动操作。

是否有可能在 *roff 文件或 markdown 文件中 #include 或调用 shell 变量，然后使用 pandoc 来“编译” man 页面？

我知道这是一个奇怪的问题，但我还没有遇到过类似的问题。

请注意，这不同于简单地在 $MANPATH 中包含一个手册页以供 man 调用。

I.E.，我想使用类似的东西:

.TH foo 10 "$(git log -n1 | grep Date | tail -c 31)""$(git branch | grep "*")"

代替每次都必须手动更改日期和分支机构/负责人名称。无论这是在 markdown 中并提供给 pandoc 或其他东西，还是仅在 roff 文件本身中，我都可以接受。

Answer 1

考虑使用文档生成器语言(如 asciidoc)编写 man 页面的内容，它具有大多数所需的功能。 asciidoc 格式可以包含外部输入文件，并根据需要即时更改各种内容。

要包含 shell 脚本，请参阅 Substitutions inside literals in Asciidoc .

或者可以使用 shell 脚本生成配置文件，然后包含该文件。

如果这个答案目前有点模糊，请提前致歉，因为它更像是一个软件推荐(没有任何实际代码)而不是一个真正的答案。