文档属性——内置的、布尔型的和自定义的——可以在文档头部和文档正文中取消设置。

在头部取消设置一个文档属性

文档属性可以通过在属性名称之前(首选)或之后直接添加感叹号(!)来取消设置。就像在文档头部设置属性一样,属性条目必须单独占据一行。不要给条目添加值。

= 标题
:!name: <.> :name!: (1)
  1. 当一个属性的名称前加上 ! 符号时(推荐做法),该属性将会被取消设置。

  2. 当属性名后面附加了一个`!`时,该属性被取消设置。

我们使用一个属性条目来关闭内置的布尔属性,名为`sectids`。AsciiDoc处理器在处理时会自动设置`sectids`,除非你取消设置它。`sectids`属性为每个部分生成一个ID,来源于该部分的标题。

取消设置布尔属性
= 文档标题
:!sectids: (1)
  1. 在新的一行,输入一个冒号(:),紧跟一个感叹号(!),属性名称,然后再输入一个冒号(:)。在关闭的冒号之后,按下kbd:[Enter]键。属性现在被取消设置,它的行为将不会被应用到文档中。

一旦属性被取消设置,它的行为就会被停用。当`sectids`被取消设置时,AsciiDoc处理器在处理时将不会从节标题生成ID。

让我们取消内置属性`example-caption`的设置。当您使用示例块时,这是一个由AsciiDoc处理器自动设置并默认赋值为`Example`的属性。

取消设置一个自动声明的属性
= 标题
:!example-caption: (1)
  1. 示例块不会被标记和编号,例如,示例1,因为控制该行为的属性在前导`!`中没有设置。

在正文中取消设置文档属性

自定义文档属性和一些内置文档属性可以在文档正文中使用属性条目和感叹号(!)来关闭,如前一节所述。例如,假设你在文档的页眉中设置了部分编号属性;但是,你不希望文档中间的两个部分被编号。为了禁用这两个部分的编号,你需要在你不希望编号的第一个部分之前取消设置`sectnums`,然后在你希望编号重新开始时再次设置它。

= 标题
:sectnums: (1)

== 章节标题

:!sectnums: (2)
== 章节标题

=== 章节标题

:sectnums: (3)
== 章节标题
  1. 在文档头部设置`sectnums`属性,以激活整个文档的章节编号。

  2. 通过在属性名前加上`!来取消设置`sectnums。`!`可以放在属性名的前面或后面。属性条目必须放在单独的一行上。在取消设置该属性的所有下面部分都不会被编号。

  3. "`sectnums` 已被设置,所有后续的章节将会被编号。"