当你使用将标题添加到表格时,处理器会自动在标题前加上标签_Table <n>.,这里的<n>_是文档中所有已命名表格的基于1的索引。这个标签可以在文档级别或每个表格上进行修改。它也可以通过停用

使用table-caption修改标签

你可以通过文档属性`table-caption`来更改所有带标题表格的标签。 (不要让属性的名称误导你。这是在文档层面控制表格标题标签的属性。)

在文档头部,设置`table-caption`属性并赋予它你的自定义标签文本。

= 文档标题
:table-caption: 数据集 (1) (2)
  1. 设置文档属性 table-caption 并为其分配你希望出现在每个表格标题之前的文本。

  2. 不要在标签文本后输入数字。处理器会自动插入并递增数字。

向文档中添加两个带标题的表格和一个无标题的表格中,第一和第三个表格有标题,但第二个表格没有标题。

向文档中添加两个带标题的表格和一个无标题的表格
= 文档标题
:table-caption: 数据集

|===
.A table with a title
[cols="2,1"]
|Lots and lots of data |A little data

|834,734 |3
|3,999,271.5601 |5
|===

|===
|组别 |气候类型 |例子

|A
|热带
|斯瓦,斐济

|B
|干旱
|利马,秘鲁
|===

.另一张有标题的桌子
|===
|值 |结果 |备注

|空值 |一个谜 |见附录R
|===

因为`table-caption`被赋予了`Data Set`值,任何表格标题都应该以_Data Set <n>_标签开头。 从向文档中添加两个带标题的表格和一个无标题的表格来的三个表格如下所示。

.A table with a title [cols="2,1"]

Lots and lots of data

A little data

834,734

3

3,999,271.5601

5

组别 气候类型 例子

A

热带

斯瓦,斐济

B

干旱

利马,秘鲁

Data Set 1. 另一张有标题的桌子
结果 备注

空值

一个谜

见附录R

请注意,没有标题的表格没有获得标签,处理器在增加标签编号时也没有计算它。因此,第三个表格被指定了标签 Data Set 2.

使用caption修改单个表格的标签

你可以通过设置 caption 属性来自定义单个表格的标签。(不要被属性的名称误导。caption 属性仅设置标题的标签,而不是整个标题行)。使用 caption 时,将其指定为你想要显示的确切值(包括结尾的空格)。使用 caption 分配的标签不会自动增加编号,并且仅适用于它们设置的表格。

Caution
如果你想在标签和标题之间留出空间,你必须在caption属性的值后面添加一个空格。
使用caption修改标签
|===
[caption="表A. "] (1) (2)
.A table with a custom label
[cols="3*"]
|Null
|A mystery
|See Appendix R
|===

创建一个属性列表,直接放在表格标题的上方,并设置名为 caption 的属性,后面跟着等号(=),然后是一个值。 将这个值用双引号(")括起来。 否则处理器会去除所有尾随的空格,标题文本将紧跟在标签的最后一个字符之后开始。

使用caption修改标签表格如下所示。

[caption="表A. "] .一张有自定义标签的表格 [cols="3*"]

一个谜

参见附录R

如果您在文档中创建任何后续表格并且没有设置 caption,那么标题标签将恢复为分配给 table-caption 的值。

如果你希望表格的标题仅包含标题标签,请使用以下语法:

[caption=,title="{table-caption} {counter:table-number}"]
Unresolved directive in customize-title-label.adoc - include::example$table.adoc[tag=b-col-h]

或者,你可以这样写:

.{empty}
[caption="{table-caption} {counter:table-number}"]
Unresolved directive in customize-title-label.adoc - include::example$table.adoc[tag=b-col-h]