使用table-caption修改标签
你可以通过文档属性`table-caption`来更改所有带标题表格的标签。 (不要让属性的名称误导你。这是在文档层面控制表格标题标签的属性。)
在文档头部,设置`table-caption`属性并赋予它你的自定义标签文本。
= 文档标题
:table-caption: 数据集 (1) (2)
-
设置文档属性
table-caption
并为其分配你希望出现在每个表格标题之前的文本。 -
不要在标签文本后输入数字。处理器会自动插入并递增数字。
在向文档中添加两个带标题的表格和一个无标题的表格中,第一和第三个表格有标题,但第二个表格没有标题。
= 文档标题
: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 |
干旱 |
利马,秘鲁 |
值 | 结果 | 备注 |
---|---|---|
空值 |
一个谜 |
见附录R |
请注意,没有标题的表格没有获得标签,处理器在增加标签编号时也没有计算它。因此,第三个表格被指定了标签 Data Set 2.
使用caption修改单个表格的标签
你可以通过设置 caption
属性来自定义单个表格的标签。(不要被属性的名称误导。caption 属性仅设置标题的标签,而不是整个标题行)。使用 caption
时,将其指定为你想要显示的确切值(包括结尾的空格)。使用 caption
分配的标签不会自动增加编号,并且仅适用于它们设置的表格。
Caution
|
如果你想在标签和标题之间留出空间,你必须在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]