属性引用

属性引用标记了在文档转换时应插入属性值存储的信息的位置。这称为_引用一个属性_。用户定义的属性最常被引用,尽管一些内置的属性也可以在文档中使用,比如存储替换文本或数据的`author`和`localyear`。有关更多信息,请参见属性引用剖析

属性值

属性值是分配给属性的内置或用户定义的替换内容或行为。一旦分配给一个属性,这个值就会应用到文档中,无论是作为整体还是在引用该属性的任何地方。该值可以是空的、一个整数,或者一串字符。大多数内置属性有一个限定的允许值范围,而用户定义的属性只接受字符串。有关详细信息,请查阅内置文档属性参考表。另请参阅default attribute value默认属性值。

内置属性

内置属性是预定义的,它们的名称是保留的。AsciiDoc 处理器在处理文档时会自动设置许多内置属性并分配默认值。然而,这些内置属性可以被取消设置,或者它们的默认值可以被覆盖。更多关于使用内置属性的信息,请参见 设置内置文档属性属性列表

字符替换属性

字符替换属性是内置的文档属性,可以在您不希望某个字符(如插入符号 (^) 或竖线 (|))被解释为 AsciiDoc 语法时使用。字符替换属性参考列出了这些内置属性及其值。

默认属性值

许多内建属性都有一个默认值。这个默认值是一个内置的值,用于当属性被设置但其值留空时。

集合

当一个属性被 设置 时,它就会被“激活”。必须设置属性,以便其值能应用于文档或元素。如何设置属性取决于它是何种类型的属性以及它正在被设置的位置。有关设置属性的更多信息,请参见设置内置文档属性设置用户定义的文档属性,以及属性列表

取消设置

当一个属性被_取消设置_时,它会被“关闭”。取消设置后,该属性的行为或值将不会应用于文档或元素。只有在文档加载或转换时自动设置的属性,或者用户明确设置的属性,如果用户希望关闭这些属性,才需要被取消设置。更多信息请参见取消设置文档属性取消设置命名属性

用户定义属性

用户定义的属性是由您创建、设置并赋值的自定义属性。存在一些用户定义的属性名称和值的限制