Theme error: UndefinedError("'style' is undefined")

[kuripart]

Problem

Getting following error when building a Sphinx project:

#14 2.108 Theme error:
#14 2.108 An error happened in rendering the page about.
#14 2.108 Reason: UndefinedError("'style' is undefined")

conf.py includes the following:

# -- Options for HTML output -------------------------------------------------

# The theme to use for HTML and HTML Help pages.  See the documentation for
# a list of builtin themes.
#
html_theme = 'sphinx_rtd_theme'

# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']

Setting html_style doesn't fix the issue as well.

Reproducible Project

Please give a link to a public reproducible project or provide an example of the Restructured Text that gives an issue.

Place RST code here (if any).

Error Logs/Results

#14 2.108 Theme error:
#14 2.108 An error happened in rendering the page about.
#14 2.108 Reason: UndefinedError("'style' is undefined")

Expected Results

Setting any other html_theme eg: 'bizstyle' works as expected.

Environment Info

• Python Version: 3.9
• Sphinx Version: 7.0.0
• RTD Theme Version: 1.2.0

Happy to share the Dockerfile and Pipifile setting if the info provided is not enough.

[dvzrv]

Hi! I am running into the same issue trying to build libcamera's documentation on Arch Linux.
This is with sphinx 7.0.0 and sphinx_rtd_theme 1.2.0 on Python 3.11.

[benjaoming]

Hi! Thanks for stopping by and reporting this!

Do you have an open source repo that produces this error?

There's no variables or properties in the theme's Python code called style, so I wondered if it could be related to Jinja2 template code and found this:

sphinx_rtd_theme/sphinx_rtd_theme/layout.html

Lines 27 to 30 in 03a86b8

	{%- if sphinx_version_info < (4, 0) -%}
	<link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
	<link rel="stylesheet" href="{{ pathto('_static/pygments.css', 1) }}" type="text/css" />
	{%- endif %}

As you can see, this code is guarded to only be used on old versions of Sphinx. But could the variable substitution still be causing the error?

[alerque]

The libcamera named by David as an example failure above has its repo here and is open source.

[benjaoming]

Thanks! I'm wondering why some Sphinx 7 builds work fine. For instance, this build doesn't produce the error:

https://readthedocs.org/projects/test-builds/builds/20357244/

[dvzrv]

@polyzen found a fix for the libcamera issue ❤️
https://paste.xinu.at/JfsPm/

[dvzrv]

It turned out to be not sphinx_rtd_theme related (just the use of a removed keyword). Sorry for the noise!

[benjaoming]

Thanks for sharing @dvzrv 👍