Asciidoctor :: Discussion

Number callouts in GitHub

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

3 messages Options

mjobanek

Number callouts in GitHub

Hi,
is there a way to use number callouts in code snippets in GitHub READMEs? I was trying to find a way, but I still don't see the icons there.
I have added the ":icons: font" to the doc and it looks fine in my Goland IDE, but when I push it to GH, then instead of having icons I see only the comments with numbers:
for
// <1>
I see:
// (1)
but in IDE I see the icon.

Do you have any idea what I am doing wrong?

mojavelinux

Re: Number callouts in GitHub

Administrator

No, there is not. GitHub does not honor the icons=font setting because it does not provide or allow for the required CSS. In general, AsciiDoc rendering on GitHub is limited for this reason. You should not expect it to look perfect because it will never be. You should only expect it to give you a reasonable preview of the document. That's all.

Best Regards,

-Dan

On Wed, Jan 27, 2021 at 4:31 AM mjobanek [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi,
is there a way to use number callouts in code snippets in GitHub READMEs? I was trying to find a way, but I still don't see the icons there.
I have added the ":icons: font" to the doc and it looks fine in my Goland IDE, but when I push it to GH, then instead of having icons I see only the comments with numbers:
for
// <1>
I see:
// (1)
but in IDE I see the icon.

Do you have any idea what I am doing wrong?

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/Number-callouts-in-GitHub-tp8459.html

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

Dan Allen (he, him, his) | @mojavelinux | https://twitter.com/mojavelinux

msc

Re: Number callouts in GitHub

In reply to this post by mjobanek

> On Jan 27, 2021, at 8:31 PM, mjobanek [via Asciidoctor :: Discussion] <[hidden email]> wrote:
>
> Hi,
> is there a way to use number callouts in code snippets in GitHub READMEs? I was trying to find a way, but I still don't see the icons there.
> I have added the ":icons: font" to the doc and it looks fine in my Goland IDE, but when I push it to GH, then instead of having icons I see only the comments with numbers:
> for
> // <1>
> I see:
> // (1)
> but in IDE I see the icon.
>
> Do you have any idea what I am doing wrong?
>

Nothing! Welcome to the wonderful world of GH's Asciidoc preview with many limitations imposed in the name of security.

Regards

-Mark.