James McKinney

I created https://github.com/sphinx-doc/sphinx/issues/8852, but I assume the issue will only be fixed in Sphinx>=4, which myst-parser doesn't presently support. **Update:** Nevermind, they're accepting non-breaking PRs for 3.x.

Sphinx merged by PR in its 3.x branch to fix the heading level jump: https://github.com/sphinx-doc/sphinx/pull/8853 The maintainer suggests an approach in https://github.com/sphinx-doc/sphinx/issues/8852. I think we can close the issue here,...

Same as #215?

Same as #215?

I personally just use Sphinx's [extlinks](https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html) extension, which I assume is essentially what @chrisjsewell is referring to as new Sphinx roles. Sure, you might prefer the syntax to be `[hyperlink...

Mysteriously, the anchors_plugin receives the source string (English text) for the regular `#` heading, but the translated string for the admonition's title. This might help a person more knowledgeable with...

Huh, I wasn’t aware of the gettext_additional_targets option, so I only added support for the targets that are translatable by default. I’ll try to have a look.

I'm able to reproduce.

Right, so this is the same issue as https://github.com/sphinx-doc/sphinx/issues/8852 For literal-block, Sphinx's Locale transform turns the text to translate into: ``` :: text to translate ``` When MyST Parser then...

There are also the following options for `gettext_additional_targets`: * `index`: I don't know how to test this. Sphinx's own tests (`test_additional_targets_should_be_translated` in `test_intl.py`) don't seem to have a case for...