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
<http://bit.ly/gs-services-us>for more
information.==Ing. Andrea Aime
@geowolfTechnical Lead
GeoSolutions Groupphone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 333 8128928
https://www.geosolutionsgroup.com/
<https://www.geosolutionsgroup.com/>
http://twitter.com/geosolutions_it
<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
<http://bit.ly/gs-services-us>for more
information.==Ing. Andrea Aime @geowolfTechnical Lead
GeoSolutions Groupphone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 333 8128928
https://www.geosolutionsgroup.com/
<https://www.geosolutionsgroup.com/>
http://twitter.com/geosolutions_it
<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
