外部文件中的源代码片段通常带有一个前导块缩进。这个前导块缩进在其原始上下文中是相关的。然而,一旦放入文档中,这个前导块缩进就不再需要了。
缩进属性
属性 indent
允许删除前导块的缩进并且,可选地,为包含原样内容的块(列表、文字、源码、诗歌等)设置新的块缩进。
-
当`indent`为0时,将去除前导块的缩进。
-
当
indent
大于 0 时,首先会去除代码块的初始缩进,然后内容会按照等于这个值的列数进行缩进。
如果设置了块或文档的 tabsize
属性,那么制表符也将被该属性指定的空格数替换,不管 indent
属性是否被设置。
例如,这个AsciiDoc源代码:
[source,ruby,indent=0]
----
def names
@name.split ' '
end
----
产生:
def names @name.split ' ' end
这个AsciiDoc源代码:
[source,ruby,indent=2]
----
def names
@name.split ' '
end
----
产生:
ruby def names @name.split ' ' end