You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Unity SDK documentation fails to build on Sphinx 4+ #1989
The Unity SDK documentation does not build on a current Sphinx. sphinx-build aborts before
writing any HTML.
sphinx.errors.ThemeError: An error happened in rendering the page home.
Reason: TypeError("argument of type '_CascadingStyleSheet' is not a container or iterable")
Cause
Docs/source/_templates/layout.html uses the pre-Sphinx-4 CSS API:
From Sphinx 4 onward css_files holds _CascadingStyleSheet objects rather than strings, so the else branch passes an object to pathto(). AltTester® Desktop's equivalent template was already
modernised to use css_tag(); this one was not. The Unreal SDK is unaffected.
Why it matters
deploy-docs-to-live.yml uploads with rm: true, which clears the target directory before
the upload. A build producing zero pages after that step has already run would leave the published
Unity documentation empty.
docs/requirements.txt pins no versions, so which Sphinx a runner resolves is not controlled.
Activity
adrianbobis-blip commentedon Sep 18, 2026
Folded into the documentation update issues, which are the sub-issues of alttester/alttester-unreal-sdk#328:
The fix itself is unaffected and still open for review: