作者属性可以通过作者行隐式设置并赋值。

作者是谁?

在文档头部,"author line"紧随文档标题行之后。当这一行的内容结构正确时,处理器会将内容分配给内置的`author`和`email`属性。

我什么时候可以使用作者线?

为了让处理器正确地检测到作者行,并将内容分配给正确的属性,必须满足以下所有标准:

  1. 标题必须包含一个文档标题

  2. 作者信息必须填写在文档标题下方紧接的那一行。

  3. 作者行必须以作者姓名开始。

  4. 作者栏中的内容必须按照特定的顺序排列,并使用正确的语法分隔。

单一作者的作者署名结构。
= 文件标题
名字 中间名 姓氏 <电子邮件>

作者的中间名是可选的。作者姓氏后面跟着的电子邮件或网址也是可选的。如果包括的话,电子邮件地址必须用一对尖括号(< >)括起来。

作者行也接受多个作者

分配一个作者和电子邮件

使用author行添加一个作者和电子邮件中,让我们通过作者行添加一个作者及其电子邮件地址。作者行必须放置在文档标题下方的直接一行,并以作者的名字开头。

使用author行添加一个作者和电子邮件
= "无畏编年史"
Kismet R. Lee <kismet@asciidoctor.org> (1) (2)
  1. 在文档标题下方的行输入作者的名字。

  2. 在一对角括号(< >)中输入作者的电子邮件或URL。

请记住,中间名和电子邮件是可选的。处理器会根据作者行的单词位置、单词数量和语法,将内容分配给内置属性。

当应用默认样式表时,作者信息将显示在作者署名处。在文档标题的正下方,作者署名 会显示作者信息和直接链接到revision-information.adoc[修订信息]。

作者和电子邮件信息显示在作者署名上
在作者行中使用属性引用

作者行并不意味着支持属性引用的任意放置。虽然属性引用会在作者行中被替换(作为头部替换组的一部分),但它们直到行解析之后才会被替代。这种排序有时会产生不希望的结果。最好是将作者行严格用作定义静态作者和电子邮件信息的简写。

如果您确实需要在作者或电子邮件值中使用属性引用,您应该使用属性条目显式地定义这些属性