如何为Asciidoc中的代码清单自动编号？全局属性设置咨询

当然可以！Asciidoc提供了专门的全局属性，能一键让所有代码清单自动编号，不用逐个设置。下面给你讲两种常用的方式，按需选择：

• 全局给所有可编号元素（含代码块）编号
  如果你希望文档里的代码块、示例、表格等所有支持编号的元素都自动编号，只需要在文档最顶部的属性块里加上:numbered:即可：

  = 我的博客标题
  :numbered:
  :toc:
  
  正文内容开始...
  

• 仅给代码清单单独自动编号
  要是只想给代码块编号，不想影响其他元素，可以用更精准的:listing-numbered:属性：

  = 我的技术博客
  :listing-numbered:
  
  // 第一个代码块
  [source,java]
  ----
  public class HelloWorld {
      public static void main(String[] args) {
          System.out.println("Hello!");
      }
  }
  ----
  
  // 第二个代码块
  [source,python]
  ----
  print("Hello from Python!")
  ----
  

  设置后，所有代码清单会自动生成“清单1”“清单2”这样的编号。

另外，如果你想自定义编号的前缀（比如改成更贴合中文的“代码示例”），可以搭配:listing-caption:属性一起用：

= 我的技术博客
:listing-numbered:
:listing-caption: 代码示例

这样代码块的编号就会变成“代码示例1”“代码示例2”，看起来更符合中文阅读习惯。

试试这些设置，应该就能轻松实现你要的全局代码清单自动编号啦！

内容的提问来源于stack exchange，提问作者Yakov Fain