Skip to content

MyST unusable with current Sphinx dev HEAD (future 8.3.0) #1042

Description

@jfbu

What version of myst-parser are you using?

4.0.1

What version dependencies are you using?

Sphinx 8.3.0+/ead64dfda

What operating system are you using?

Mac

Describe the Bug

This index.md

---
myst:
  html_meta:
    keywords: Bug
---

# FOO documentation

leads to KeyError: 'writer' when attempting to exercise the Sphinx HTML builder.

I am opening this to be sure Sphinx upstream situation at sphinx-doc/sphinx#13713 is monitored prior to Sphinx 8.3.0 release.

Expected Behavior

No response

To Reproduce

No response

Activity

  1. added
    bugSomething isn't working
    on Jul 29, 2025
  2. AA-Turner commented on Nov 27, 2025

    @AA-Turner
    Contributor

    cc @chrisjsewell as Sphinx 9 is coming up. Do you think it's possible to resolve this on the MYST side?

    A

  3. chrisjsewell commented on Nov 28, 2025

    @chrisjsewell
    Member

    Heya, I guess there is no longer an 8.3 being released and you are skipping straight to v9?

    This is less problematic, as the package is already currently bound to sphinx<9.

    I'm on holiday for the next week, so probably won't be able to look until after then (also at breaking changes in the newest docutils)

  4. linked a pull request that will close this issue⬆️ Support Sphinx v9 #1076on Dec 15, 2025
  5. chrisjsewell commented on Dec 15, 2025

    @chrisjsewell
    Member
  6. jfbu commented on Dec 30, 2025

    @jfbu
    Author

    Probably we can close this, as @AA-Turner added a workaround patch to Sphinx in time for Sphinx 9.0 release, and the 8.3.0 referred-to in the original title did not come into existence, Sphinx having jumped to 9.0.

    And #1076, #1077 appear to be the places for discussion of Sphinx v9 compatibility.

  7. jfbu commented on Dec 30, 2025

    @jfbu
    Author

    Hmm, sorry, actually the patch by @AA-Turner is for 9.1.0, it was not there in 9.0.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions