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.
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
···
Regards,
Andrea Aime
==
GeoServer Professional Services from the experts!
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
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…
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
···
Regards,
Andrea Aime
==
GeoServer Professional Services from the experts!
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
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.
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…
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.
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.
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!
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](mailto:Geoserver-devel@lists.sourceforge.net)
[https://lists.sourceforge.net/lists/listinfo/geoserver-devel](https://lists.sourceforge.net/lists/listinfo/geoserver-devel)
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.
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…
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.
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.
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!
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](mailto:Geoserver-devel@lists.sourceforge.net)
[https://lists.sourceforge.net/lists/listinfo/geoserver-devel](https://lists.sourceforge.net/lists/listinfo/geoserver-devel)
Try a clean first, and review your change for any toctree directive changes. As indicated this is sometimes an issue with parent / child relationships.
I get the error after cleaning, I also get it without any changes (on an updated and untouched main branch).
Note that the error is:
[exec] Theme error:
[exec] An error happened in rendering the page background.
[exec] Reason: UndefinedError(“‘root_doc’ is undefined”)
Exactly the same as what Andrea had. I was hoping he could clarify how he resolved it? (Not sure where to find the ‘GeoCat docs’ for this issue)
Kind Regards
Niels
···
On 27/04/2022 02:28, Jody Garnett wrote:
Try a clean first, and review your change for any toctree directive changes. As indicated this is sometimes an issue with parent / child relationships.
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.
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…
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.
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.
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!
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](mailto:Geoserver-devel@lists.sourceforge.net)
[https://lists.sourceforge.net/lists/listinfo/geoserver-devel](https://lists.sourceforge.net/lists/listinfo/geoserver-devel)
I get the error after cleaning, I also get it without any changes (on an updated and untouched main branch).
Note that the error is:
[exec] Theme error:
[exec] An error happened in rendering the page background.
[exec] Reason: UndefinedError(“‘root_doc’ is undefined”)
Exactly the same as what Andrea had. I was hoping he could clarify how he resolved it? (Not sure where to find the ‘GeoCat docs’ for this issue)
Kind Regards
Niels
On 27/04/2022 02:28, Jody Garnett wrote:
Try a clean first, and review your change for any toctree directive changes. As indicated this is sometimes an issue with parent / child relationships.
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.
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…
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.
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.
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!
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](mailto:Geoserver-devel@lists.sourceforge.net)
[https://lists.sourceforge.net/lists/listinfo/geoserver-devel](https://lists.sourceforge.net/lists/listinfo/geoserver-devel)
I get the error after cleaning, I also get it without any changes (on an updated and untouched main branch).
Note that the error is:
[exec] Theme error:
[exec] An error happened in rendering the page background.
[exec] Reason: UndefinedError(“‘root_doc’ is undefined”)
Exactly the same as what Andrea had. I was hoping he could clarify how he resolved it? (Not sure where to find the ‘GeoCat docs’ for this issue)
Kind Regards
Niels
On 27/04/2022 02:28, Jody Garnett wrote:
Try a clean first, and review your change for any toctree directive changes. As indicated this is sometimes an issue with parent / child relationships.
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.
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…
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.
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.
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!
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](mailto:Geoserver-devel@lists.sourceforge.net)
[https://lists.sourceforge.net/lists/listinfo/geoserver-devel](https://lists.sourceforge.net/lists/listinfo/geoserver-devel)