Asciidoc 在创建 adoc 文件时插入 Gitlab 构建器变量?

Asciidoc inserting Gitlab builder variables when creating the adoc file?

大家好,一直在阅读 GitlabA​​sciidoc 网站上的各种文档,我不知道是否有办法自动填充在 Gitlab 中创建的变量,该变量包含在它创建的 asciidoc 中?例如,如果我将代码推送到我的分支,它会启动 Gitlab 构建器。我想把 author 变量和我的名字放在一起,当构建器生成的 asciidoc 时,我可以只把 {author} 用于自动填写我的名字?

不是 100% 确定我理解它的确切工作原理,我们将不胜感激任何帮助。

谢谢

如果您的 Gitlab 构建器显式调用 asciidoctor,您可以使用 -a 标志定义属性。例如:

asciidoctor -a author="My Name" contents.adoc

同样的方法可以添加环境变量:

asciidoctor -a author="My Name" -a path=$PATH contents.adoc

请参阅 CLI Options page 以了解您可以在 asciidoctor 调用期间指定的其他选项。

如果构建器调用其他用于构建的操作,而您无法访问这些操作,那么这将不起作用。

请注意,定义页面作者通常是通过在页面标题之后(第一个空行之前)立即包含姓名(和电子邮件地址)来处理的。有关详细信息,请参阅 Using the Author Line page

例如:

= Document
Author name

标准 Asciidoctor 主题自动在页面标题后立即显示页面作者。

对于包含在文档中或指定为页面属性的其他属性,您需要在页面标记中包含 {attribute_name} 才能看到它们。