Problem with callouts in XML source block: probably user error

Hi all,

I'm busy tearing my hair out because I'm sure it's something I'm doing that's particularly dumb, but I can't see what it is.

Using asciidoctor 1.5.4 on ruby 2.3.1, when interpreting an XML source block using coderay as the syntax highlighter, converting to HTML 5, I see a beautifully syntax highlighted code block, but instead of looking like black circles with white numbers in them, my callouts just look like bold numbers in brackets.

Looking through the source, the generated html for the callout looks like (1)
Looking through generated correct-looking examples on the web, it would appear it should look like



If I change my generated html to match this, it looks correct, supporting that hypothesis. So anyone know what it is I'm missing to make the generated output correct? I was originally using the maven plugin with 1.5.3 but fell back to manual asciidoctor runs to try and eliminate maven plugin error, and I see the same with command-line 1.5.4.

The callout comment follows an xml line (so it's appended to a line, just in case that would cause a problem), the line looks like

                    <linkcss>true</linkcss> 

(yes, I was documenting my use of the maven plugin for posterity)

Thanks in advance to anyone for any help you can offer, I'm sure it's operator error because so many others are getting the correct results, I just don't know what it is I'm doing wrong.

If I'm not telling you enough please ask me for more detail :)

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/Problem-with-callouts-in-XML-source-block-probably-user-error-tp4685.html

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

Awesome, thanks Dan, problem solved. I was confused by the fact that the "icon fonts" section appears after the section on XML callouts which shows the "icon fonts" style display of the callout (and describes it as white on black) so thought icon fonts was another mechanism for achieving the same effect.

Would you mind if I submitted a very small PR to the XML Callouts section of the documentation to state explicitly that if icon fonts are not enabled then the callout rendering will appear different, or is the difference specific to HTML generation?

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/Problem-with-callouts-in-XML-source-block-probably-user-error-tp4685p4693.html

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

Thanks very much Dan, very small PR (but hopefully clear) submitted for the doc. It will probably only affect a very few readers but if it saves repetition of the same question then it's worthwhile.

Thanks again for your very quick and accurate response.

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/Problem-with-callouts-in-XML-source-block-probably-user-error-tp4685p4697.html

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