asciidoc：FAILED：配置文件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出现的地方。一般搜索仅在4年前在一个Google网上论坛上引发了一次讨论，但OP并没有费心分享此修复程序。有什么建议吗？

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

Answer 1

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

您也可以使用Asciidoctor进行构建。它没有configure选项，但是您可以像USE_ASCIIDOCTOR=1 make all doc一样调用make来设置标志。请注意，您至少需要Git 2.24才能使所有与Asciidoctor 2兼容的功能。