Login  Register

Re: asciidoctor cross reference formatting

Posted by mojavelinux on Oct 19, 2019; 12:33am
URL: https://discuss.asciidoctor.org/asciidoctor-cross-reference-formatting-tp7253p7256.html

For a paragraph, what text would you expect to be used? Is the reftext going to take the whole paragraph? The ID in square bracket is an indication that there's no reftext (explicit or implied). So it's kind of a placeholder until you fill it in.

Best,

-Dan

On Fri, Oct 18, 2019 at 6:31 PM instinctive [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Thanks so much for the reply. Indeed, this fixes the problem, and I'm
grateful that it suffices to specify the reftext at the anchor site and not
in every link reference.

However, I'm confused as to why the default behavior does not use
implied reftext, and why the default is square brackets. This default
behavior is not illuminated anywhere in the asciidoctor user manual
that I can find.

So now I must double every anchor:

[[anchor-foo,anchor-foo]]
[[anchor-bar,anchor-bar]]

Thanks again for the speedy reply, and your work on this great tool.


If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/asciidoctor-cross-reference-formatting-tp7253p7255.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