Login  Register

Re: Multiple anchors/ids for description list item (glossary pluralization)

Posted by habamax on May 22, 2020; 3:04pm
URL: https://discuss.asciidoctor.org/Multiple-anchors-ids-for-description-list-item-glossary-pluralization-tp8036p8039.html


Why wouldn't you use [[term, terms]] and use <<term>> to show urls as
terms?
Because it does entirely the wrong thing? If I say

<<term>>, <<terms>>

[[term,terms]]term:: A term

then the rendered result is

[term], term

of which the first link is broken, and the second is not pluralized.


Well, that is how asciidoctor works I believe. You have defined one anchor named [[term]] and can not link to it with <<terms>> because there is no such anchor defined.

I don't think it is possible to do in a general way (there are a lot of languages you have to take into account). As for english you will have to extend asciidoctor with ruby to make it happen. I am not sure it is feasible, but you, of course can try.


I would stop at a single [[term]] or [[terms]] depending on frequency use in your text and use either <<term, terms>> or <<terms, term>> for the rest of urls.

On the other hand it should be possible to use multiple anchors on the same place as described in manual:https://asciidoctor.org/docs/user-manual/#multiple-anchors

But it looks like it is broken and there should be issue registerd on asciidoctor github.

== [[term]][[terms]] As in manual example

link to <<term>> and another one to <<terms>>

are rendered as [term] and [terms] which according to manual should not happen.

Even more funny it works differently with exported PDF -- rendered with the same issue but links to table of contents.