Try a clean first, and review your change for any toctree directive
changes. As indicated this is sometimes an issue with parent / child
relationships.
Jody
On Tue, Apr 26, 2022 at 12:27 AM Niels Charlier via Geoserver-devel <
geoserver-devel@lists.sourceforge.net> wrote:
> Hello Ian,
>
> Yes, I get the same error from sphinx as Andrea did back then.
>
> Kind Regards
>
> Niels
> On 26/04/2022 12:18, Ian Turton wrote:
>
> I just go to docs/en and do mvn install - do you have sphinx installed?
>
> Ian
>
> On Tue, 26 Apr 2022 at 11:11, Niels Charlier via Geoserver-devel <
> geoserver-devel@lists.sourceforge.net> wrote:
>
>> Andrea,
>>
>> I keep having this issue. What do you mean exactly with the instructions
>> on the GeoCat site? I cannot resolve it.
>>
>> Kind Regards
>>
>> Niels
>> On 13/10/2021 09:42, Andrea Aime wrote:
>>
>> Hi Jody,
>> I just followed the instructions on the GeoCat site and then, it built.
>> No changes in the docs.
>>
>> However, it was building just fine until some time ago (weeks?) so some
>> recent change must have broken
>> a previously working setup, and now requires a more recent sphinx
>> version, it seems.
>>
>> Cheers
>> Andrea
>>
>>
>> On Tue, Oct 12, 2021 at 7:20 PM Jody Garnett <jody.garn...@gmail.com>
>> wrote:
>>
>>> 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
>>>>
>>>
>>
>> --
>>
>> 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
>> listGeoserver-devel@lists.sourceforge.nethttps://lists.sourceforge.net/lists/listinfo/geoserver-devel
>>
>> _______________________________________________
>> Geoserver-devel mailing list
>> Geoserver-devel@lists.sourceforge.net
>> https://lists.sourceforge.net/lists/listinfo/geoserver-devel
>>
>
>
> --
> Ian Turton
>
> _______________________________________________
> 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
