Support for AsciiDoc admonition paragraphs

[DanielSWolf]

Admonitions are a great AsciiDoc feature that allows you to highlight some text in a meaningful way. They are meant to look something like this:

Instead, GitBook renders them like this, which is rather useless:

It shouldn't be hard to get these admonitions to look better:

• Hide the table borders (except for the middle line)
• Assign a fixed width to the left cell
• Instead of writing "Note", "Tip", etc., use these unicode characters in a large text size:
  • NOTE: ℹ (INFORMATION SOURCE)
  • TIP: 💡 (ELECTRIC LIGHT BULB)
  • IMPORTANT: ☝ (WHITE UP POINTING INDEX)
  • WARNING: ⚠ (WARNING SIGN)
  • CAUTION: ⚡ (HIGH VOLTAGE SIGN)

[erixtekila]

That may be of interest https://github.com/erixtekila/gitbook-plugin-richquotes

[nagim]

Or this: https://plugins.gitbook.com/plugin/callouts

[DanielSWolf]

Thanks, that looks interesting. Still, given that admonition paragraphs are part of the AsciiDoc standard, I'd have hoped that they work out of the box.

[msavy]

@DanielSWolf As it looks like the fixes for this issue aren't going to be merged any time soon, I've created the asciidoc-admonition-icons GitBook plugin to restore the Asciidoc(tor) admonition paragraph icons.

Its default styling is almost identical to the standard Asciidoctor theme, with some minor colour changes to better match the GitBook style.

You can, of course, override the glyphs and styling in configuration. Check out the docs for more on that.

• GitBook plugin page: https://plugins.gitbook.com/plugin/asciidoc-admonition-icons
• GitHub repo: https://github.com/msavy/gitbook-plugin-asciidoc-admonition-icons/