As discussed in #428 , the myst plugin is not compatible with myst-parser > 0.17.2 (which is already more than one year old). The patch contained in this PR keeps the plugin backward compatible with older myst-parser versions, but also supports the new versions by using docutils.core's publish_string, as suggested in the docs.
In principle with the publish_string method it is possible to list the myst extensions one wants to enable. Here I am enabling them all but support for mathematical equations (which is handled directly by nikola). I have also decided to suppress warnings related to out-of-order document headings, and to have myst add anchors to headers (i.e. lines starting with one or more #) in order to support internal links.
As discussed in #428 , the myst plugin is not compatible with myst-parser > 0.17.2 (which is already more than one year old). The patch contained in this PR keeps the plugin backward compatible with older myst-parser versions, but also supports the new versions by using docutils.core's publish_string, as suggested in the docs.
In principle with the
publish_string
method it is possible to list the myst extensions one wants to enable. Here I am enabling them all but support for mathematical equations (which is handled directly by nikola). I have also decided to suppress warnings related to out-of-order document headings, and to have myst add anchors to headers (i.e. lines starting with one or more #) in order to support internal links.