Asciidoctor：在 pdf 中存储 git 提交哈希

Question

我想使用

使用 asciidoctor 从 .adoc 文件生成 PDF

asciidoctor-pdf Doku.adoc

如何将当前的 git sha1-hash 打印到 PDF 中？

Answer 1

使用DocumentAttributes

asciidoctor-pdf -acommitHash=$(git rev-parse HEAD) Doku.adoc

您现在可以在文档中使用文档属性 commitHash，方法是编写：

{commitHash}

使用ifdef测试是否设置了变量。

ifdef::commitHash[]
{commitHash}
endif::[]

如果未从 CLI 定义任何属性，您也可以将默认值定义为回退

:commit: Unknown
Version: {commit}

命令行-a将覆盖文档内部声明。