多年以前,有一段时间我对 Asciidoc 很感兴趣,尝试用它起草写了一篇博客文章(为什么我说Rust是靠谱的编程语言),偏偏那是一篇很长的文章(大概有一万字),偏偏里面有大量的超级链接,大量的链接夹杂在文字中间,写的我都快吐了。当时也曾专门去找,想知道Asciidoc有没有类似Markdown的嵌入式链接写法([title][name]
[name]: url
),然而很遗憾,没找到(我觉得官方文档也要背一下锅)。结果就是,那是我第一篇也是唯一一篇用Asciidoc格式正式书写的文章。
今天偶然看到Asciidoc,又去它官方网站找了一遍,还真给找到了嵌入式链接写法,解开了我心中积压多年的一个疑团。下面引用官方文档。(杯具的是,我这里写的还是Markdown,因为优快云博客编辑器已经官方支持Markdown。)
28.1. Setting configuration entries
Attribute entries promote clarity and eliminate repetition
URLs and file names in AsciiDoc macros are often quite long — they break paragraph