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将覆盖文档内部声明。