MyST-Parser icon indicating copy to clipboard operation
MyST-Parser copied to clipboard

Amonitions `class` option value: space- or comma-separated list?

Open dbitouze opened this issue 2 years ago • 1 comments

Describe the gap in the current documentation

The “Admonition types” section reads:

These admonitions take no argument, but may be specified with options:

class: A space-separated list of CSS classes to add to the admonition.

but, in the syntax just below, the value of this class option is a comma-separated list:

:::{tip}
:class: myclass1,myclass2
:name: a-tip-reference
Let's give readers a helpful hint!
:::

[Reference to my tip](#a-tip-reference)

Describe the solution you'd like

Make the wording and the syntax consistent.

dbitouze avatar Sep 13 '23 07:09 dbitouze

Yep just double checked and it should be space separated: https://docutils.sourceforge.io/docs/ref/rst/directives.html#class-1

chrisjsewell avatar Sep 13 '23 08:09 chrisjsewell