Closed vsoch closed 1 year ago
If it is a version issue, then it would be useful to know what versions of python, sphinx, and sphinx-immaterial you are using. I suspect this is a Sphinx version problem, but I haven't looked into it yet.
It looks like Sphinx v7.2.0 changed the StandaloneHTMLBuilder.css_files
into a "private" member StandaloneHTMLBuilder._css_files
in https://github.com/sphinx-doc/sphinx/pull/11582.
ah so should I pin one version below that for the time being?
I haven't done any testing (to reproduce) yet. For now, you can try pinning to sphinx<7.2
. Please report back if that succeeds or not.
I can confirm that sphinx<7.2
works...
In testing my fixes, I've run into some other issues about sphinx v7.2+ that will have to also be addressed in the upcoming PR:
StandaloneHTMLBuilder.script_files
is now _js_files
. This line needs updating https://github.com/jbms/sphinx-immaterial/blob/9adb3f18bf759b287627b0dcaff7e1bd512ed0b6/sphinx_immaterial/__init__.py#L74 Similarly (& as reported in OP), This line needs updating https://github.com/jbms/sphinx-immaterial/blob/9adb3f18bf759b287627b0dcaff7e1bd512ed0b6/sphinx_immaterial/__init__.py#L90 to use the newer/renamed _css_files
member.sphinx.domains.python.type_to_xref()
has changed to use an additional positional arg. The monkeypatch will have to be adjusted in https://github.com/jbms/sphinx-immaterial/blob/9adb3f18bf759b287627b0dcaff7e1bd512ed0b6/sphinx_immaterial/apidoc/python/type_annotation_transforms.py#L349Sphinx.outdir
is now a pathlib.Path
obj. So, we need to compensate for this when generating the sitemap. https://github.com/jbms/sphinx-immaterial/blob/9adb3f18bf759b287627b0dcaff7e1bd512ed0b6/sphinx_immaterial/postprocess_html.py#L41The first error went away! But I think I might have hit the third error there?
writing output...
building [html]: targets for 23 source files that are out of date
updating environment: [new config] 23 added, 0 changed, 0 removed
Sphinx parallel build error:
TypeError: _monkey_patch_python_parse_arglist.<locals>.parse_arglist() takes from 1 to 2 positional arguments but 3 were given
make: *** [Makefile:20: html] Error 2
Error: Process completed with exit code 2.
Please use sphinx-immaterial>=0.11.6
for that fix.
okay my build worked - https://github.com/flux-framework/flux-restful-api/actions/runs/5898442163/job/15999539187 - thanks for the help! I'll watch this issue for next steps.
I have a working fix, but it needs to pass static analysis before we merge and release it. Thanks for reporting this and verifying the culprit was sphinx v7.2.0.
Thank you!!
Just published sphinx-immaterial v0.11.7 which includes the fix for this.
You and @jbms are really too notch maintainers. Every time I’ve opened an issue! This is a great project and I’ll try to keep spreading the good word!
This might be a version issue, but I just hit this:
Is it related to Python version or immaterial version? I'm not currently pinning anything. Thank you (and sorry for always opening bugs, I am terrible :laughing: )