如何:用括号编号制作参考书目并按编号引用它们

Howto: Make bibliography with bracket numbers and referencing them by numbers

Asciidoctor 中的基本参考书目使用名称,但不使用自动编号。

我想要一份参考书目及其用法,例如:

They say, this is a title[1] and it's pretty nice[2].

[1] This is my title bla
    bla bla bla bla and 
    more text, 2005
[2] lalalalalalalalalala
    blabla, 2005 - 2006

我的解决方案产生以下输出:

输出

代码

他们说,这是一个标题<>而且很不错<>。

== References
[[references]]
[cols="1d,98"]
|===

| [[ref_title, &#91;{counter:bibliNr}&#93;]] <<ref_title>>
| My first reference dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd

| [[ref_nice, &#91;{counter:bibliNr}&#93;]] <<ref_nice>>
| My second reference, 2004 - 2009

|===

说明

  • [cols="1d,98"]:表示第一列的宽度为 1%,第二列的宽度为 98%。 d 意味着,宏和东西实际上被执行了。这对于计数器是必需的。
  • &#91;&#93;分别等于[]。至少要用&#93;。否则解释器会混淆所有括号。
  • {counter:bibliNr}:这是计数器的语法。 Details here
  • [[ref_title, &#91;{counter:bibliNr}&#93;]] <<ref_title>>:第一部分(括号内)定义实际引用并确定计数器编号。 <<ref_title>> 只是第一部分的 link。所以它显示了数字