asciidoc:失败:缺少配置文件asciidoc.conf

Question

我正在尝试以没有root用户的身份构建git。

make configure
./configure --prefix=/home/tools/bin/git/$ver
make all doc

我得到了这个错误：

make[2]: `GIT-VERSION-FILE' is up to date.
make[2]: Leaving directory `/home/tools/bin/git/src/git-2.24.1'
    * new asciidoc flags
    ASCIIDOC git-archive.html
asciidoc: FAILED: configuration file asciidoc.conf missing
make[1]: *** [git-archive.html] Error 1
make[1]: Leaving directory `/home/tools/bin/git/src/git-2.24.1/Documentation'
make: *** [doc] Error 2

我已经安装了asciidoc，xmlto，makeinfo，docbook2X。我尝试向我能找到的所有asciidoc.conf实例添加绝对路径，但没有区别。四年前，通用搜索只在谷歌的一个小组上出现过一次讨论，但该组织并没有费心去分享这个解决方案。有什么建议吗？

asciidoctor似乎是另一种选择，但我不知道如何启用它。

Answer 1

您的AsciiDoc版本似乎配置错误，无法找到自己的配置文件。当构建它时，你需要告诉它在运行时应该在哪里找到那个文件，或者使用你的发行版的包。

你也可以使用Asciidoctor来构建。没有针对它的configure选项，但是您可以调用make like USE_ASCIIDOCTOR=1 make all doc来设置标志。请注意，您至少需要Git 2.24才能使所有内容与Asciidoctor 2一起工作，您似乎已经有了Asciidoctor 2。