外部文件中的源代码片段通常带有一个前导块缩进。这个前导块缩进在其原始上下文中是相关的。然而,一旦放入文档中,这个前导块缩进就不再需要了。

缩进属性

属性 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