Peter, A number of osgeo projects use this python / sphinx stack for documentation management. For geoserver we use python 3 (which defaults to utc-8) rather than python 2 which has been discontinued.
The instructions ( https://docs.geoserver.org/latest/en/docguide/install.html ) appear a little of out of date. Here are some I have written more recently (https://github.com/GeoCat/geocat-themes/blob/master/README.md). Jody On Wed, Oct 6, 2021 at 11:15 AM Peter Smythe <g...@smythe.co.za> wrote: > Hi all > > I am able to successfully build the main branch of GeoServer src with > Maven. That is not a problem. > > However, I am struggling to build the documentation, both on Windows and > Ubuntu. These are the steps I have followed: > > cd doc/en > mvn clean install -e -X alternatively mvn compile -Puser -e -X > > The problem appears to be with sphinx-build, from the logs: > > sphinx: > [echo] Running sphinx-build -D release=2.21-SNAPSHOT -W -b html -d > "/home/peters/geoserver-source/doc/e > n/target/docguide/doctrees" . > "/home/peters/geoserver-source/doc/en/target/docguide/html" > > [exec] Theme error: > [exec] An error happened in rendering the page background. > [exec] Reason: *TypeError('quote_from_bytes() expected bytes')* > [INFO] > ------------------------------------------------------------------------ > [INFO] BUILD FAILURE > [INFO] > ------------------------------------------------------------------------ > [INFO] Total time: 16.325 s > > These are the versions. > > python -V > Python 2.7.18 > sphinx-build --version > sphinx-build 3.5.2 > > If the problem is with python2, I have tried to > alias python=python3 > python -V > Python 3.8.10 > and that also does not help. > > Attached is the full output from maven, if that helps. > > Can anyone guide me on what the problem might be, please? > > Thanks > > Peter > _______________________________________________ > Geoserver-devel mailing list > Geoserver-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/geoserver-devel > -- -- Jody Garnett
_______________________________________________ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel
