Oh I know this one, it often annoys me when doing theme development it usually has to do with parent / child table of contents relationships being messed up somehow. Sometimes if you are just doing incremental builds locally you can introduce a problem of this nature...
Let me check out main and build all the docs. -- Jody Garnett On Tue, 12 Oct 2021 at 01:42, Andrea Aime <[email protected]> wrote: > Something has changed recently that broke the build for me too: > > sphinx: > [echo] Running sphinx-build -D release=2.21-SNAPSHOT -W -b html -d > "/home/aaime/devel/git-gs/doc/en/target/docguide/doctrees" . > "/home/aaime/devel/git-gs/doc/en/target/docguide/html" > [exec] > /usr/local/lib/python2.7/dist-packages/sphinx/util/nodes.py:94: > FutureWarning: > [exec] The iterable returned by Node.traverse() > [exec] will become an iterator instead of a list in Docutils > > 0.16. > [exec] for classifier in > reversed(node.parent.traverse(nodes.classifier)): > > [exec] Theme error: > [exec] An error happened in rendering the page background. > [exec] Reason: UndefinedError("'root_doc' is undefined",) > > Did not touch the system installation, has built the docs fine till some > time ago.... Some recent change in the sphinx setup has made the > instructions "outdated". > Tried the instructions from the GeoCat docs, they worked. > > Cheers > Andrea > > > On Sat, Oct 9, 2021 at 5:48 PM Jody Garnett <[email protected]> > wrote: > >> 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 <[email protected]> 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 >>> [email protected] >>> https://lists.sourceforge.net/lists/listinfo/geoserver-devel >>> >> -- >> -- >> Jody Garnett >> _______________________________________________ >> Geoserver-devel mailing list >> [email protected] >> https://lists.sourceforge.net/lists/listinfo/geoserver-devel >> > > > -- > > Regards, > > Andrea Aime > > == > GeoServer Professional Services from the experts! > > Visit http://bit.ly/gs-services-us for more information. > == > > Ing. Andrea Aime > @geowolf > Technical Lead > > GeoSolutions Group > phone: +39 0584 962313 > > fax: +39 0584 1660272 > > mob: +39 333 8128928 > > https://www.geosolutionsgroup.com/ > > http://twitter.com/geosolutions_it > > ------------------------------------------------------- > > Con riferimento alla normativa sul trattamento dei dati personali (Reg. UE > 2016/679 - Regolamento generale sulla protezione dei dati “GDPR”), si > precisa che ogni circostanza inerente alla presente email (il suo > contenuto, gli eventuali allegati, etc.) è un dato la cui conoscenza è > riservata al/i solo/i destinatario/i indicati dallo scrivente. Se il > messaggio Le è giunto per errore, è tenuta/o a cancellarlo, ogni altra > operazione è illecita. Le sarei comunque grato se potesse darmene notizia. > > This email is intended only for the person or entity to which it is > addressed and may contain information that is privileged, confidential or > otherwise protected from disclosure. We remind that - as provided by > European Regulation 2016/679 “GDPR” - copying, dissemination or use of this > e-mail or the information herein by anyone other than the intended > recipient is prohibited. If you have received this email by mistake, please > notify us immediately by telephone or e-mail >
_______________________________________________ Geoserver-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/geoserver-devel
