"author line 是唯一可以为文档分配多个作者以在署名栏展示的方式。此外,只有 HTML 5 和 Docbook 转换器能够转换有多个作者的文档。"
多作者语法
每位作者的信息用分号(;
)结束。
多位作者的署名行结构
= 文件标题
姓名 中间名 姓氏 <电子邮件>; 姓名 中间名 姓氏 <电子邮件>
在每个作者的姓氏或可选的电子邮件后面直接输入一个分号(;
),后跟一个空格,然后输入下一个作者的信息。
转义尾随的字符引用
如果作者名字的一段以字符引用结尾(例如,®
),你必须对其进行转义以避免处理。一种转义方式是添加一个尾随的属性引用(例如,{empty}
)。如果字符引用出现在最后一个作者名字段的末尾,你可以使用第二个分号来代替。
一个更好的转义字符引用的方法是将它替换为属性引用(例如,{reg}
)。
即使字符引用已经转义,作者名的各个片段也不会被处理。相反,整个名字将被赋予`author`和`firstname`属性。这一限制将来可能会被取消。
在作者栏列出多位作者
在一个有三个作者和两个电子邮件地址的作者行中的作者行列出了三位作者的信息。每位作者的信息之间用分号(;
)分隔。请注意,作者_B. Steppenwolf_没有电子邮件地址,因此分号位于他们名字的末尾。
一个有三个作者和两个电子邮件地址的作者行
Unresolved directive in multiple-authors.adoc - include::example$multiple-authors.adoc[tag=header]
一个有三个作者和两个电子邮件地址的作者行的结果如下所示。
每位作者的信息也可以在文档中使用他们各自的内置属性进行引用。
如果作者名以字符引用结尾,你可以通过添加一个尾随属性引用来保留字符引用中的分号:
AsciiDoc®{empty} 工作组;另一位作者
另一种解决方案涉及将字符引用移动到一个属性中,并使用属性引用进行插入:
:reg: ®; AsciiDoc{reg} WG; 另一位作者
尽管字符引用被转义了,作者姓名的部分也不会被处理。