Re: Valid ways of reference callouts
Posted by
mojavelinux on
URL: https://discuss.asciidoctor.org/Re-Valid-ways-of-reference-callouts-tp8055p8058.html
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
--