当你发现自己重复输入相同的文本,或者经常需要更新的文本时,考虑创建你自己的属性。

用户定义的属性名称和值

用户定义的属性必须有一个名称和明确赋值。

属性名必须:

  • 至少要有一个字符长度。

  • 起始于一个字词字符(A-Z, a-z, 0-9, 或者 _),并且

  • 仅包含单词字符和连字符。

名字不能包含点或空格。

尽管在属性名称中允许使用大写字符,但在存储前名称会被转换为小写。例如,`URL`和`Url`会被当作`url`处理。一个最佳实践是只使用小写字母并避免以数字开头的名称。

属性值能够:

  • 可以是任何内联内容,并且

  • 包含换行符,但前提是使用了显式行继续符号+)。

创建一个自定义属性和值

属性条目的一个主要用途是将频繁使用的文本和URL提升到文档的顶部。

创建一个用户定义的属性和值
:disclaimer: 不要触摸野生的沃尔佩廷格斯。如果你让它们进入你的系统,我们对任何头发、巧克力或紫色袜子的丢失不负责任。
:url-repo: https://github.com/asciidoctor/asciidoctor
  1. 长数值可以通过反斜杠(\)进行软换行

现在,你可以在整个文档中引用这些属性