Hi Warren
On 03/08/10 14:04, Warren Block wrote:
Why do anchor links without a caption show the anchor ID rather than the
caption defined with the anchor?
In other words, I can define an anchor with a caption, but then that
caption is not used, at least with HTML.
Example:
Create an anchor link that shows '[anchor1]', not 'Example
Anchor'. Here goes: <<anchor1>>
The anchor itself is here:
[[anchor1,Example Anchor]]
The text at the anchor.
It seems a little counterintuitive. If the caption from the anchor
section is used, it can be reader-friendly (with spaces and such). And
changing the default caption would only have to be done in one place, at
the anchor.
The problem is that HTML does not have the equivalent of the DocBook xreflabel
attribute for anchors. Similarly the AsciiDoc xreftext attribute sets the
xreflabel on block elements but is only useful if you're going the DocBook route.
There is a passing reference to this in the User Guide:
http://www.methods.co.nz/asciidoc/userguide.html#X30
See also:
http://www.methods.co.nz/asciidoc/userguide.html#X41
Cheers, Stuart
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/asciidoc?hl=en.
