Asciidoc 的嵌入式链接写法

多年以前，有一段时间我对 Asciidoc 很感兴趣，尝试用它起草写了一篇博客文章（为什么我说Rust是靠谱的编程语言），偏偏那是一篇很长的文章（大概有一万字），偏偏里面有大量的超级链接，大量的链接夹杂在文字中间，写的我都快吐了。当时也曾专门去找，想知道Asciidoc有没有类似Markdown的嵌入式链接写法（[title][name] [name]: url），然而很遗憾，没找到（我觉得官方文档也要背一下锅）。结果就是，那是我第一篇也是唯一一篇用Asciidoc格式正式书写的文章。

今天偶然看到Asciidoc，又去它官方网站找了一遍，还真给找到了嵌入式链接写法，解开了我心中积压多年的一个疑团。下面引用官方文档。（杯具的是，我这里写的还是Markdown，因为CSDN博客编辑器已经官方支持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 flow and readability suffers. The problem is compounded by redundancy if the same name is used repeatedly. Attribute entries can be used to make your documents easier to read and write, here are some examples:

:1:         http://freshmeat.net/projects/asciidoc/
:homepage:  http://asciidoc.org[AsciiDoc home page]
:new:       image:./images/smallnew.png[]
:footnote1: footnote:[A meaningless latin term]Using previously defined attributes: See the {1}[Freshmeat summary]
or the {homepage} for something new {new}. Lorem ispum {footnote1}.

Note:

The attribute entry definition must precede it’s usage.
You are not limited to URLs or file names, entire macro calls or arbitrary lines of text can be abbreviated.
Shared attributes entries could be grouped into a separate file and included in multiple documents.

Asciidoc 的嵌入式链接写法相关推荐

js 主动触发 a 标签 href 链接写法,
js 主动触发 a 标签 href 链接写法结构 <a href = "index.html"><input id="clickBtn" ty ...
LaTex建立参考文献链接
在LaTex生成的pdf文档中建立链接(如从正文到参考文献,从目录到相应内容,从图标号到对应图),有利于读者快速定位当前阅读的信息. 参考:http://www.tug.org/application ...
50种方法可以获得高质量的“SEO白帽”反向链接
50种方法可以获得高质量的"SEO白帽"反向链接获得"SEO白帽"SEO链接实际上只是部分关于链接本身.它也是为网站的观众和社区提供服务,以及与您建立真实关系 ...
php友情链接大于3换行,交换友情链接需要了解的一些常识和原则
对SEOER们来讲友情链接应该不是一个什么新鲜的事了,但是往往很多SEOER对网站交换友情链具体的作用以及需要注意的地方还不是很清楚,对此本文就交换友情链接需要注意的几点常识和交换友情链接需要知道的一 ...
HTML标签——锚点链接小学习（懒癌患者的摸索之路）
我是灼灼,一只初学Java的大一金渐层. 向往余秀华和狄兰·托马斯的疯狂,时常沉溺于将情感以诗相寄:追逐过王尔德.王小波的文字,后陷于毛姆和斯蒂芬·金不可自拔:热爱文学的浪潮,白日梦到底却总在现实里清 ...
《CSAPP》笔记——链接、异常控制流、虚拟内存
文章目录传送门链接基础链接器的意义编译器驱动程序静态链接 ELF目标文件格式可重定位目标文件符号和符号表链接过程符号解析解析规则静态链接库带有静态链接库的解析过程重定位重 ...
jquery-question
js中的一些问题事件 css jquery的动画 jq中的tmpl每个定义的具体列子 flex布局(弹性盒模型小型) 移动端 boorstrap 适配自适应响应式 viewport rem vh ...
HTML5+CSS3 非常全的笔记
文章目录 HTML5 vsco的使用常用标签图像标签超链接标签锚点链接特殊字符表格标签列表标签表单标签实战(注册页面) CSS3 书写规范 css选择器基础选择器标签选择器类选 ...
初学php时一些术语以及一些基础知识
2019独角兽企业重金招聘Python工程师标准>>> 1.你要把PHP.ini 里的 display_errors ? = ? On 才可以显示错误位置打开php短标记符 ...

Asciidoc 的嵌入式链接写法

28.1. Setting configuration entries

Asciidoc 的嵌入式链接写法相关推荐

最新文章

热门文章