<div dir="ltr"><div>Firstly, thanks to Michael Balzer for fixing my errors in the rst files I checked in. (Also, apparently I can't spell Auxiliary - doh).  I _had_ tried to get sphinx working recently and failed miserably, so I tried again this morning.</div><div><br></div><div>The problem is that ubuntu:</div><div>* Doesn't provide a package for m2r2 or sphinx-mdinclude (a fork of m2r2)</div><div>* No longer allows you to pip install into the main python library path</div><div><br></div><div>So first I got rid of the installed sphinx-doc</div><div><font face="monospace">sudo apt remove sphinx-doc</font></div><div><br></div><div>Then I set up a sphinx virtual environment</div><div><font face="monospace"><br></font></div><font face="monospace">pipx install sphinx<br>pipx inject sphinx sphinx_rtd_theme docutils mistune requests sphinx-mdinclude<br><br></font><div>For some reason I was getting run-time python errors with m2r2 which is why I tried switching to mdinclude.  <br><br>In docs/source/conf.py I changed<div> <font face="monospace">extensions = [ 'm2r2' ]</font> </div><div>to be  'sphinx_mdinclude' instead of 'm2r2'<br></div><div><br></div></div><div>The pipx command creates a virtual execution environment for sphinx and puts a shim for sphinx in your local path that runs it in the virtual environment.</div><div><br></div><div>//.ichael</div></div>