[rtems-docs PATCH] sphinx/style: Fix building with the latest sphinx

[Joel Sherrill]

It is working for me on Rocky 9 with Sphinx 7.2.6 and a Texlive from this
summer.

The missing step was removing the older Sphinx version. Then I had to also
install PlantUML npm.

--joel

On Tue, Dec 19, 2023 at 3:45 PM Chris Johns <chrisj at rtems.org> wrote:

> On 20/12/2023 8:12 am, Joel Sherrill wrote:
> > I tried the patch on Rocky 9 with Python 3.9.14 and sphinx-build  5.3.0
> from a
> > pip local install.
> >
> > (rtemsdocs) [joel at localhost rtems-docs]$ ./waf distclean
> > Waf: The wscript in '/home/joel/rtems-work/rtems-docs' is unreadable
> > Traceback (most recent call last):
> >   File
> >
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.25-767522112be77f8585812fcfaa08e805/waflib/Scripting.py",
> line 102, in waf_entry_point
> >     set_main_module(wscript)
> >   File
> >
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.25-767522112be77f8585812fcfaa08e805/waflib/Scripting.py",
> line 142, in set_main_module
> >     Context.g_module=Context.load_module(file_path)
> >   File
> >
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.25-767522112be77f8585812fcfaa08e805/waflib/Context.py",
> line 362, in load_module
> >     exec(compile(code,path,'exec'),module.__dict__)
> >   File "/home/joel/rtems-work/rtems-docs/wscript", line 17, in <module>
> >     from common import waf as docs_waf
> >   File "/home/joel/rtems-work/rtems-docs/common/waf.py", line 17, in
> <module>
> >     import conf
> >   File "/home/joel/rtems-work/rtems-docs/common/conf.py", line 87, in
> <module>
> >     import sphinx_rtd_theme_rtems
> >   File
> >
> "/home/joel/rtems-work/rtems-docs/common/sphinx_rtd_theme_rtems/__init__.py",
> > line 9, in <module>
> >     import sphinx
> > ModuleNotFoundError: No module named 'sphinx'
> >
> > Any ideas what I might be missing?
>
> This looks like a local set up issue.
>
> My testing was with python 3.11, venv and pip in the virtual env.
>
> > FWIW the patch didn't apply on my CentOS 7 VM with an even older Sphinx.
>
> The patch is from git to the mailing list. It is now pushed to master so
> please
> try there.
>
> Chris
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20231221/19c7a5dc/attachment-0001.htm>