RTEMS / Documentation / Documentation

Go to Issues or Merge Requests


Issues

135 - Theme error building docs on 5 branch (opened)

Id

135

State

opened

Type

ISSUE

Author

Chris Johns

Created

2026-02-20T04:31:52.290Z

Updated

2026-02-20T14:38:41.886Z

Milestone

5.4

Labels

doc::sphinx

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/issues/135

Merges

0

Documentation does not build with the packages used on main . The error is:

Theme error:
An error happened in rendering the page index.
Reason: UndefinedError("'style' is undefined")

The 6 branch builds but that has a different theme.

Author: Chris Johns

2026-02-20T04:31:52.433Z

added rtems#14 as parent epic

Author: Chris Johns

2026-02-20T04:31:52.514Z

set status to To do

Author: Kinsey Moore

2026-02-20T14:33:01.359Z

Apparently modern versions of sphinx (7 or greater) have dropped the usage of “style” as it is now a keyword, so documentation must be updated. I have a potential fix, but I don’t have the ability to test on historical systems that would have used the original syntax to see if it still works.

Author: Kinsey Moore

2026-02-20T14:38:41.862Z

There is an additional issue if running on python 3.12 or later in that the “imp” module is gone, so I need to find a workaround for that, too.

Author: Kinsey Moore

2026-02-20T15:15:58.355Z

mentioned in merge request !221

Merge Requests

221 - Update docs build for modern systems

Id

221

State

merged

Merged by

Chris Johns

Merged at

2026-02-20T20:04:28.500Z

Assignee(s)

Kinsey Moore

Reviewer(s)

Chris Johns

Created

2026-02-20T15:15:52.813Z

Updated

2026-02-20T20:04:30.175Z

Milestone

5.4

Labels

doc::sphinx

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/221

Commit

081a3018dd1638de978c80a0b6680eeefa563d78

Summary

common/…theme_rtems/layout.html: Update theme for modern Sphinx

Old themes tend to use “style” and this is now a reserved keyword. Use styles[-1], instead.

Updates #135

common/waf.py: Backport importlib compatibility

This backports usage of importlib from main with the ability to continue functioning on python 2.x with the ‘imp’ module.

Closes #135

Generative AI

Author: Kinsey Moore

2026-02-20T15:15:52.949Z

requested review from @chris

Author: Kinsey Moore

2026-02-20T15:15:52.970Z

assigned to @opticron

Author: Chris Johns

2026-02-20T20:04:24.737Z

approved this merge request