[Ovmsdev] How I got sphinx working on ubuntu 23.1 + WSL

[Craig Leres]

On 11/16/24 16:19, Michael Geddes via OvmsDev wrote:
> For some reason I was getting run-time python errors with m2r2 which is 
> why I tried switching to mdinclude.

Over here in FreeBSD-land, I can "gmake html" if I change conf.py to use 
sphinx_mdinclude instead of m2r2.

		Craig

ice 4003 % pkg info | fgrep sphinx
py311-sphinx-5.3.0_3,1         Python documentation generator
py311-sphinx-mdinclude-0.6.2   Sphinx extension that enables including 
Markdown documents
py311-sphinx_rtd_theme-1.0.0   Mobile-friendly py-sphinx theme
py311-sphinxcontrib-applehelp-1.0.2 Extension which outputs Apple help books
py311-sphinxcontrib-devhelp-1.0.2 Sphinx extension which outputs Devhelp 
document
py311-sphinxcontrib-htmlhelp-2.1.0 Sphinx extension which renders HTML 
help files
py311-sphinxcontrib-jsmath-1.0.1 Sphinx extension which renders display 
math in HTML via JavaScript
py311-sphinxcontrib-qthelp-2.0.0 Sphinx extension which outputs QtHelp 
document
py311-sphinxcontrib-serializinghtml-2.0.0 Sphinx extension which outputs 
serialized HTML files (json and pickle)