Asciidoctor :: Discussion

Re: Valid ways of reference callouts

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

4 messages Options

mojavelinux

Re: Valid ways of reference callouts

Administrator

Callouts following a block can only be defined in a callout list (which is what you are seeing when it appears at the beginning of the line). See https://asciidoctor.org/docs/user-manual/#callouts

There's an open issue to allow callouts to be used in prose. See https://github.com/asciidoctor/asciidoctor/issues/3037

Cheers,

-Dan

On Tue, May 26, 2020 at 5:51 AM oddhack [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Can callouts in text following a block appear anywhere other than the very beginning of a line? I don't see anything in the user manual making the constraint, but while this works as expected:
<1> One
This doesn't render the callout icon:
One <1>
If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/Valid-ways-of-reference-callouts-tp8054.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

oddhack

Re: Valid ways of reference callouts

"There's an open issue to allow callouts to be used in prose. See https://github.com/asciidoctor/asciidoctor/issues/3037"

If I'm reading that right, what's being requested in that issue is callouts in the target (first use) in arbitrary places, not callouts in the annotation text in arbitrary places.

I still don't see anything in the text here that actually constrains where the callouts in the annotation appear - all it says is "The second use, which goes below the verbatim block, defines the annotation text."

mojavelinux

Re: Valid ways of reference callouts

Administrator

On Wed, May 27, 2020 at 1:52 AM oddhack [via Asciidoctor :: Discussion] <[hidden email]> wrote:

"There's an open issue to allow callouts to be used in prose. See https://github.com/asciidoctor/asciidoctor/issues/3037"

If I'm reading that right, what's being requested in that issue is callouts in the target (first use) in arbitrary places, not callouts in the annotation text in arbitrary places.

It would be one in the same. It's about allowing callouts to be used anywhere after the block (meaning in prose, otherwise stated as anywhere in a sentence). (Whether it's the first use or multiple uses is a point of debate in the issue, but still covered by it).

I still don't see anything in the text here that actually constrains where the callouts in the annotation appear - all it says is "The second use, which goes below the verbatim block, defines the annotation text."

Yes, that's the correct statement in the documentation. If you feel like it needs to be explained further, feel free to propose an expanded explanation.

Best Regards,

-Dan

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

mojavelinux

Re: Valid ways of reference callouts

Administrator

Oops! I linked to the wrong issue. I meant to link to this one:

https://github.com/asciidoctor/asciidoctor/issues/2537

-Dan

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux