The mkdocs-material implementation allows for collapsible blocks, a pretty cool feature that allows for example to hide the answer to a question, which is invaluable for teaching material.

Would it be possible to add it to mdbook-admonish?

1. Standard quotes are not turned into smart quotes inside the blocks even with the mdbook option turned on.

2. Also, it would be nice to be able to style the title text... in other words, specify the title text also as MarkDown...

3. Also, inlined HTML tags are not recognized:

4. Code blocks inside admonish blocks must be wrapped with ~~~ otherwise they conflict with the admonish closing tag

5. Also, symbols inside fenced code blocks inside admonish blocks are not recognized:

This Pull Request adds collapsible admonition support, as described in https://github.com/tommilligan/mdbook-admonish/issues/18.

In its current state, this implementation has 2 shortcomings that I'm not sure how to overcome:

1. The CSS could be modified to make the arrow look slightly better.
2. The links to the admonition titles interfere with the open/close interaction. Clicking on the title doesn't open the box, which is counter-intuitive.

UPDATE

the best feature for me in mkdocs-material is the way that uses the tabs to groups codes

• is it supported by mdbook-admonish ?
• if not, is there any way to use this feature?

Hi 👋, just wanted to say that I really like this library and thank you for making it!

Issue

However, I have noticed one thing though with the Header Bar in the given code blocks, they seem to overflow and not line up.

Example

	```admonish <admonition type>
	[insert text]
	```

Results in:

It's like one or two pixels off so not entirely noticeable but definitely visible. I was wondering if this was an issue with the library or something potentially on the client-side? I've not changed any CSS within the generated CSS file.

Diagnostic Info

Operating System: Windows 11 Rust: v1.58.1 mdbook: v0.4.18 mdbook-admonish: 1.5.0

Hello Tom Milligan @tommilligan,

thank you very much for your great work.

Is there any way to use the exe file without mdbook-admonish install? I can`t / am not allowed to install anything on my computer.

Thanks for your time and sorry for asking my question here, I didn`t find any forum or similar unfortunately.

Many greetings rufus42

Following discussion here: https://github.com/tommilligan/mdbook-admonish/pull/16#issuecomment-1109179755

This PR:

• adds clickable anchor links from admonition titles
• adds a mechanism for forcing the user to upgrade their installed CSS files, to allow rollout of breaking changes
  • adds notes to README, that breaking CSS changes may be rolled out on minor version bumps

Closes #15

I investigated whether there was an easy 'click to link to this admonition', but it's not clear to me what the UX of this should be, so that's open if anyone wants to work on it.

Many other mdbook preprocessors provide prebuilt binaries. This helps to enable the use of preprocessors in automation scenarios.

For example I'm interested in using mdbook-admonish with the actions-mdbook github action. It currently requires prebuilt binaries, more details here: https://github.com/peaceiris/actions-mdbook/issues/426#issuecomment-1102752476

Would you be willing to provide prebuilt binaries for mdbook-admonish?

It looks like you could probably just modify the existing actions workflow that mdboom-mermaid uses: https://github.com/badboy/mdbook-mermaid/blob/main/.github/workflows/deploy.yml

Hi, I found it hard to install it (This is my first mdbook), maybe there should be a section talking about that?

cargo install mdbook-admonish

Then

mdbook-admonish install

Isn't something that a new user would know. I needed to check the source code of this repo to figure it out

I'm not sure how it could fail given that it used to succeed — I thought the role of --locked was to prevent this. But it generates this for me on a 1.64 compiler:

error[E0597]: `local_ctx` does not live long enough
   --> /Users/maximilian/.cargo/registry/src/github.com-1ecc6299db9ec823/mdbook-0.4.18/src/renderer/html_handlebars/helpers/navigation.rs:154:25
    |
154 |             t.render(r, &local_ctx, &mut local_rc, out)
    |                         ^^^^^^^^^^ borrowed value does not live long enough
155 |         })?;
    |         -
    |         |
    |         `local_ctx` dropped here while still borrowed
    |         borrow might be used here, when `local_rc` is dropped and runs the destructor for type `handlebars::RenderContext<'_, '_>`
    |
    = note: values in a scope are dropped in the opposite order they are defined

For more information about this error, try `rustc --explain E0597`.
error: could not compile `mdbook` due to previous error
warning: build failed, waiting for other jobs to finish...
    Building [=======================> ] 240/243: toml_edit
error: failed to compile `mdbook-admonish v1.7.0`, intermediate artifacts can be found at `/var/folders/q2/jxfwc8mn3gvf0cs0mqk83thm0000gn/T/cargo-installm1zcJW`

(There's a warning about using a yanked dependency, but again, I thought it could still use it)

Running cargo install --path . --locked on main works — would it be possible if we could release a new version? And FYI the original command works without --locked.