修订属性可以通过修订行设置并赋值。

修订线是什么?

"The revision line is the line directly after the author line in the document header. When the content on this line is structured correctly, the processor assigns the content to the built-in revnumber, revdate and revremark attributes." 的中文翻译是:“修订行是文件头部作者行之后的行。当这行上的内容结构正确时,处理器会将内容分配给内置的 revnumberrevdaterevremark 属性。”

我什么时候可以使用修订线?

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

  1. 文档头部必须包含一个文档标题和一个作者行。

  2. 修订信息必须输入在作者行直接下方的行上。

  3. 修订线必须以修订号开始。

  4. 修订号码必须至少包含一个数字,但数字不必是版本中的第一个字符。

  5. 修订行中的值必须按照特定的顺序摆放,并使用正确的语法进行分隔。

修订线结构
= 文件标题
作者 <电子邮件> 修订号,修订日期:修订备注

使用修订线时,修订日期和备注是可选的。

  • 当修订行仅包含修订号时,需在数字前加上“v”。

  • 当修订行包含版本和日期时,用逗号(,)分隔版本号和日期。版本号前的`v`前缀是可选的。

  • 7.5: A new analysis` 当修订行包含版本号和备注时,用冒号 (:) 将版本号和备注分开。版本号前的 v 前缀是可选的。

  • 7.5, 1-29-2020: A new analysis` 当修订行包含版本号、日期和备注时,用逗号(,)分隔版本号和日期,用冒号(:)分隔日期和备注。版本号前的 v 前缀是可选的。

使用修订行分配修订信息

修订行包括版本、日期和备注中的修订行包含修订号、日期和备注。

修订行包括版本、日期和备注
= 《无畏编年史》
Kismet Lee <.> 2.9,2021年10月31日:秋季化身 (1) (2) (3)
  1. 作者行必须直接在修订行的上方。

  2. 修订线必须以修订号开头。

  3. 日期与版本之间用逗号(,)分隔。日期可以包含字母、数字、符号和属性引用。

  4. 备注与日期之间用冒号(:)分隔。

当应用默认样式表时,修订信息将显示在与作者信息同一行上。请注意,修订号码前面有一个单词 版本 。这个标签是由处理器自动添加的。可以通过 version-label 属性修改或关闭这个标签。

附带版本号、修订日期和修订备注的署名栏

让我们再来看一条修订线。在修订线包含版本前缀、属性引用和Unicode字符中,版本以一个字母开始,日期是对属性`docdate`的引用,并且备注中有一个Unicode字形。

修订线包含版本前缀、属性引用和Unicode字符
Unresolved directive in revision-line.adoc - include::example$revision-line-with-version-prefix.adoc[]

结果显示在下面。

来源栏带有从docdate派生出来的日期,以及带有一个Unicode字符的备注

LPR 被从版本中移除是因为在修订版本行中,修订号之前的任何字母或符号都会被去掉。要在修订号前显示字母或符号,可以通过设置属性条目来设置 revnumber,详见设置 revnumber 使用属性条目