Messages in this thread | | | Subject | Re: Sphinx version dependencies? | From | Markus Heiser <> | Date | Fri, 20 Jul 2018 18:28:09 +0200 |
| |
Am Freitag, den 20.07.2018, 08:04 -0700 schrieb Christoph Hellwig: > On Fri, Jul 20, 2018 at 09:30:33AM +0200, Markus Heiser wrote: > > We have this discussion over and over again an I believe we will have it again > > and again, as long as we do not change our POV .. building viewing formats is > > an application not a part of the Kernel. > > Sorry, but this is complete and utter bullshit.
Maybe .. I'am not a Kernel developer .. I only try to help with the doc tool- chain. But if I don't want to install anything from the web, the plain text is not as bad.
> > If that was the case we could skip all that RST stuff and just stick > to text files. If we want fancy docs it better behave like the rest > of the kernel and just works. python virtual environments are just > not going to cut it as they lead to a long-term maintainance nightmare.
Really a nightmare? This is what I do on my ubuntu/debian box ... I do prefer py3 so I installed *virtualenv-py3* once from distro's package manager:
$ sudo apt install python3-virtualenv
To setup up a environment for building htmldocs:
$ python3 -m virtualenv py3env $ ./py3env/bin/pip install -r ./Documentation/sphinx/requirements.txt
now I have all installed in the in the py3env folder. To build htmldocs with:
$ SPHINXBUILD=./py3env/bin/sphinx-build make htmldocs
If the env is no longer needed:
$ rm -r py3env
-- Markus --
> -- > To unsubscribe from this list: send the line "unsubscribe linux-doc" in > the body of a message to majordomo@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html
| |