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 <andrea.a...@geosolutionsgroup.com>
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 <jody.garn...@gmail.com>
> 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 <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
>>
>
>
> --
>
> 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
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel
