You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

28 lines
1.1 KiB

4 years ago
////
Included in:
- user-manual: callouts: Callouts don't get caught in copy
////
In versions prior to Asciidoctor 0.1.4, when a reader visiting an HTML page generated by Asciidoctor selected source code from a listing that contained callouts and copied it, the callout numbers would get caught up in the copied text.
If the reader pasted that code and tried to run it, likely the extra characters from the callouts would cause compile or runtime errors.
Asciidoctor uses CSS to prevent callouts from being selected.
On the other side of the coin, you don't want the callout annotations or CSS messing up your raw source code either.
You can tuck your callouts neatly behind line comments.
Asciidoctor will recognize the line comments characters in front of a callout number, optionally offset by a space, and remove them when converting the document.
Here are the line comments that are supported:
[source,subs=specialcharacters]
....
include::ex-callout.adoc[tag=b-nonselect]
....
Here's how it looks when rendered:
====
include::ex-callout.adoc[tag=b-nonselect]
====