Bug 2221979 - serd fails to build with Sphinx 7.x
Summary: serd fails to build with Sphinx 7.x
Keywords:
Status: CLOSED NEXTRELEASE
Alias: None
Product: Fedora
Classification: Fedora
Component: serd
Version: 39
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Guido Aulisi
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks: 2188968
TreeView+ depends on / blocked
 
Reported: 2023-07-11 12:10 UTC by Karolina Surma
Modified: 2024-07-22 11:31 UTC (History)
3 users (show)

Fixed In Version: serd-0.30.16-3.fc40
Clone Of:
Environment:
Last Closed: 2024-07-22 11:31:41 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Karolina Surma 2023-07-11 12:10:18 UTC
serd fails to build with Sphinx 7.x in Fedora 39 (currently Rawhide).

The issue detected:
```
+ sphinx-build -b html docs
<snip>
Theme error:
An error happened in rendering the page ....
Reason: UndefinedError("'style' is undefined")
```

Sphinx 7 has removed the `style` key for HTML templates (see: https://github.com/sphinx-doc/sphinx/pull/11381).
This can indicate an issue with the Sphinx theme the package uses rather than the package itself.

It should be possible to fix this by replacing the usage of `style` with `styles[-1] in `theme/layout.html`:
-    <link rel="stylesheet" href="{ pathto('_static/' + style, 1) }" type="text/css" />
+    <link rel="stylesheet" href="{ pathto('_static/' + styles[-1], 1) }" type="text/css" />

Please note it may not be the best solution in your specific case.

For the logs from testing build attempts, see:
https://copr.fedorainfracloud.org/coprs/ksurma/doc-stack/package/serd/

You can test you package in mock running:

$ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/doc-stack/fedora-rawhide-x86_64/ --no-clean your.src.rpm
$ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/doc-stack/fedora-rawhide-x86_64/ shell

We'd like to include Sphinx 7 in Fedora 39.
Let us know here if you have any questions. Thank you!

Comment 1 Fedora Release Engineering 2023-08-16 07:19:16 UTC
This bug appears to have been reported against 'rawhide' during the Fedora Linux 39 development cycle.
Changing version to 39.

Comment 2 Nils Philippsen 2024-07-22 11:31:41 UTC
Fixed in serd-0.30.16-3.fc40.


Note You need to log in before you can comment on or make changes to this bug.