To define a link in Asciidoc markup we only have to type the URL followed by an optional text for the link in square brackets ([text link]
). With Asciidoctor we can add extra attributes that can be used when the content is generated. We have to set the document attribute :linkattrs:
to make sure Asciidoctor will process the attributes.
In the following sample Asciidoc markup we define links with attributes like window
and role
:
:linkattrs: http://mrhaki.blogspot.com[Messages from mrhaki, window="_blank"] // Because window=_blank is used often we can // use the shortcut ^. http://mrhaki.blogspot.com[Messages from mrhaki^, role="ext-link"]
The following HTML is generated when we use Asciidoctor with the HTML backend:
<div class="paragraph"> <p><a href="http://mrhaki.blogspot.com" target="_blank">Messages from mrhaki</a></p> </div> <div class="paragraph"> <p><a href="http://mrhaki.blogspot.com" class="ext-link" target="_blank">Messages from mrhaki</a></p> </div>
Code written with Asciidoctor 0.1.4.