"Important" admonition has "info" as label

[ArtFlag]

Have you read the Contributing Guidelines on issues?

• I have read the Contributing Guidelines on issues.

Description

Hi!

I noticed that with beta.22, the admonition of type important is gone. Could we add docs on how to recreate such admonition type and make it available on every docs page by default?

Example:

:::important
Something
:::

and not

:::info Important
Something
:::

I'm happy to send a PR if someone knows how to do it!

Self-service

• I'd be willing to address this documentation request myself.

[Josh-Cena]

I'm tempted to say this is a bug and we should preserve the original tag name.

[Josh-Cena]

(I'd like to get @slorber's confirmation that it's something worth working on... IIRC the resolution last time was that these things weren't documented in the first place.)

[slorber]

So what I understand is that, now when using the undocumented :::important then you have the wrong label but the right level/color?

Expected:

Actual:

---

It would be quite easy to restore the label using swizzle now that the admonitions are mapped to a real theme components.

But everything is in one file so this requires ejecting a large API surface: we should probably split it to make it more convenient to swizzle.

But I'd also be ok if we added a retro-compatible label to the previously supported (but undocumented) admonition "aliases"

[societymartingale]

Is there any documentation on how to swizzle an admonition label or svg?

[ArtFlag]

not at the time I opened this issue, but I'd be happy to contribute if someone shows me how to do it 👍

[Josh-Cena]

@ArtFlag Our admonition logic is entirely here: https://github.com/facebook/docusaurus/blob/main/packages/docusaurus-theme-classic/src/theme/Admonition/index.tsx

It's a bit tricky, because you still want to keep it as an alias so we don't duplicate the SVG/class name. At the same time, we need to add four new translated labels. For the initial version, you can do it however you want—we can discuss about the actual implementation later.

Remember, you can also do this in userland through ejecting Admonition. If you get it to work in your own code, you can make it work in our codebase as well!