Discussion:
[zathura] Sphinx theme error
Αριστοτέλης Πανάρας
2014-04-24 06:05:33 UTC
Permalink
I am using zathura in Arch Linux, using package 'zathura-git'.
After trying to build the latest develop snapshot (89113e3), it fails with
the following error:

Exception occurred:
File "conf.py", line 6, in <module>
import sphinx_rtd_theme
ImportError: No module named 'sphinx_rtd_theme'
The full traceback has been saved in /tmp/sphinx-err-d62em_yk.log, if you
want to report the issue to the developers.
Please also report this if it was a user error, so that a better error
message can be provided next time.
A bug report can be filed in the tracker at <
https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
Makefile:23: recipe for target 'man' failed
make[1]: *** [man] Error 1
make[1]: Leaving directory
'/tmp/yaourt-tmp-ale1ster/aur-zathura-git/src/zathura/doc'
Makefile:188: recipe for target 'build-manpages' failed
make: *** [build-manpages] Error 2

.
I have installed 'python-sphinx' (which is sphinx with python3
dependencies) and 'doxygen'. Also pip is present
Since there is a requirements.txt file containing a sphinx-rtd-theme line,
is there another reason the install fails?

I am sorry if I have misunderstood something. I am not quite familiar with
python yet.

Thank you for your time.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pwmt.org/archive/zathura/attachments/20140424/b705e65d/attachment.html>
Αριστοτέλης Πανάρας
2014-04-24 06:06:46 UTC
Permalink
I forgot to include the traceback :P


2014-04-24 9:05 GMT+03:00 ??????????? ??????? <
Post by Αριστοτέλης Πανάρας
I am using zathura in Arch Linux, using package 'zathura-git'.
After trying to build the latest develop snapshot (89113e3), it fails with
File "conf.py", line 6, in <module>
import sphinx_rtd_theme
ImportError: No module named 'sphinx_rtd_theme'
The full traceback has been saved in /tmp/sphinx-err-d62em_yk.log, if you
want to report the issue to the developers.
Please also report this if it was a user error, so that a better error
message can be provided next time.
A bug report can be filed in the tracker at <
https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
Makefile:23: recipe for target 'man' failed
make[1]: *** [man] Error 1
make[1]: Leaving directory
'/tmp/yaourt-tmp-ale1ster/aur-zathura-git/src/zathura/doc'
Makefile:188: recipe for target 'build-manpages' failed
make: *** [build-manpages] Error 2
.
I have installed 'python-sphinx' (which is sphinx with python3
dependencies) and 'doxygen'. Also pip is present
Since there is a requirements.txt file containing a sphinx-rtd-theme line,
is there another reason the install fails?
I am sorry if I have misunderstood something. I am not quite familiar with
python yet.
Thank you for your time.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pwmt.org/archive/zathura/attachments/20140424/986b8b7d/attachment-0001.html>
-------------- next part --------------
# Sphinx version: 1.2.2
# Python version: 3.4.0
# Docutils version: 0.11 release
# Jinja2 version: 2.7.2
# Loaded extensions:
Traceback (most recent call last):
File "/usr/lib/python3.4/site-packages/sphinx/cmdline.py", line 253, in main
warningiserror, tags, verbosity, parallel)
File "/usr/lib/python3.4/site-packages/sphinx/application.py", line 107, in __init__
confoverrides or {}, self.tags)
File "/usr/lib/python3.4/site-packages/sphinx/config.py", line 229, in __init__
execfile_(filename, config)
File "/usr/lib/python3.4/site-packages/sphinx/util/pycompat.py", line 105, in execfile_
exec(code, _globals)
File "conf.py", line 6, in <module>
import sphinx_rtd_theme
ImportError: No module named 'sphinx_rtd_theme'
Sebastian Ramacher
2014-04-25 12:27:07 UTC
Permalink
Post by Αριστοτέλης Πανάρας
I am using zathura in Arch Linux, using package 'zathura-git'.
After trying to build the latest develop snapshot (89113e3), it fails with
File "conf.py", line 6, in <module>
import sphinx_rtd_theme
ImportError: No module named 'sphinx_rtd_theme'
The full traceback has been saved in /tmp/sphinx-err-d62em_yk.log, if you
want to report the issue to the developers.
Please also report this if it was a user error, so that a better error
message can be provided next time.
A bug report can be filed in the tracker at <
https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
Makefile:23: recipe for target 'man' failed
make[1]: *** [man] Error 1
make[1]: Leaving directory
'/tmp/yaourt-tmp-ale1ster/aur-zathura-git/src/zathura/doc'
Makefile:188: recipe for target 'build-manpages' failed
make: *** [build-manpages] Error 2
.
I have installed 'python-sphinx' (which is sphinx with python3
dependencies) and 'doxygen'. Also pip is present
Since there is a requirements.txt file containing a sphinx-rtd-theme line,
is there another reason the install fails?
I am sorry if I have misunderstood something. I am not quite familiar with
python yet.
You will also need breathe and sphinx_rtd_theme, I guess. It might be a good
idea to split building of the manpages and the full blown documentation and only
build the doxygen doc if we breathe + doxygen + sphinx_rtd_theme are installed.

I'll look into that.

Cheers
--
Sebastian Ramacher
Sebastian Ramacher
2014-04-27 12:42:02 UTC
Permalink
Post by Αριστοτέλης Πανάρας
I am using zathura in Arch Linux, using package 'zathura-git'.
After trying to build the latest develop snapshot (89113e3), it fails with
File "conf.py", line 6, in <module>
import sphinx_rtd_theme
ImportError: No module named 'sphinx_rtd_theme'
The full traceback has been saved in /tmp/sphinx-err-d62em_yk.log, if you
want to report the issue to the developers.
Please also report this if it was a user error, so that a better error
message can be provided next time.
A bug report can be filed in the tracker at <
https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
Makefile:23: recipe for target 'man' failed
make[1]: *** [man] Error 1
make[1]: Leaving directory
'/tmp/yaourt-tmp-ale1ster/aur-zathura-git/src/zathura/doc'
Makefile:188: recipe for target 'build-manpages' failed
make: *** [build-manpages] Error 2
.
I have installed 'python-sphinx' (which is sphinx with python3
dependencies) and 'doxygen'. Also pip is present
Since there is a requirements.txt file containing a sphinx-rtd-theme line,
is there another reason the install fails?
There should be some auto-detection happening for that now. If Sphinx is
available, the manpages will be built. If doxygen, breathe and sphinx_rtd_theme
are also available, the HTML documentation will be built too.

If there are any problems with that, please let me know.

Cheers
--
Sebastian Ramacher
Αριστοτέλης Πανάρας
2014-04-27 18:02:10 UTC
Permalink
Well, actually there was a slight problem.
More specifically, the manpages were not installed. It was not a packaging
error, but a Makefile mishap.
It seems that *Sphinx* (ran through the Makefile in ./doc) is used to build
the complete manpages, but the thing is that the following lines in the
root Makefile do not work as they are supposed to:

install-manpages: build-manpages
$(call colorecho,INSTALL,"man pages")
$(QUIET)mkdir -m 755 -p ${DESTDIR}${MANPREFIX}/man1
${DESTDIR}${MANPREFIX}/man5
ifneq "$(wildcard ./doc/_build/man/${PROJECT}.1)" ""
$(QUIET)install -m 644 ./doc/_build/man/${PROJECT}.1
${DESTDIR}${MANPREFIX}/man1
endif
ifneq "$(wildcard ./doc/_build/man/${PROJECT}rc.5)" ""
$(QUIET)install -m 644 ./doc/_build/man/${PROJECT}rc.5
${DESTDIR}${MANPREFIX}/man5
endif

That is because *Sphinx*, after building the manpages for *zathura* and
*zathurarc*, it does not leave them under *./doc/_build/man/*, but rather
under *./doc/_build/*.
So removing the */man/* part of the path in these four lines fixes the
problem.

Other than that, the updates were quite nice.
And the {index,index-active}-{fg,bg} options do work quite nicely.
Thank you for the update.
Post by Sebastian Ramacher
Post by Αριστοτέλης Πανάρας
I am using zathura in Arch Linux, using package 'zathura-git'.
After trying to build the latest develop snapshot (89113e3), it fails
with
Post by Αριστοτέλης Πανάρας
File "conf.py", line 6, in <module>
import sphinx_rtd_theme
ImportError: No module named 'sphinx_rtd_theme'
The full traceback has been saved in /tmp/sphinx-err-d62em_yk.log, if you
want to report the issue to the developers.
Please also report this if it was a user error, so that a better error
message can be provided next time.
A bug report can be filed in the tracker at <
https://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
Makefile:23: recipe for target 'man' failed
make[1]: *** [man] Error 1
make[1]: Leaving directory
'/tmp/yaourt-tmp-ale1ster/aur-zathura-git/src/zathura/doc'
Makefile:188: recipe for target 'build-manpages' failed
make: *** [build-manpages] Error 2
.
I have installed 'python-sphinx' (which is sphinx with python3
dependencies) and 'doxygen'. Also pip is present
Since there is a requirements.txt file containing a sphinx-rtd-theme
line,
Post by Αριστοτέλης Πανάρας
is there another reason the install fails?
There should be some auto-detection happening for that now. If Sphinx is
available, the manpages will be built. If doxygen, breathe and
sphinx_rtd_theme
are also available, the HTML documentation will be built too.
If there are any problems with that, please let me know.
Cheers
--
Sebastian Ramacher
_______________________________________________
zathura mailing list
zathura at lists.pwmt.org
http://lists.pwmt.org/mailman/listinfo/zathura
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pwmt.org/archive/zathura/attachments/20140427/09508175/attachment.html>
Sebastian Ramacher
2014-04-28 14:23:04 UTC
Permalink
Post by Αριστοτέλης Πανάρας
Well, actually there was a slight problem.
More specifically, the manpages were not installed. It was not a packaging
error, but a Makefile mishap.
It seems that *Sphinx* (ran through the Makefile in ./doc) is used to build
the complete manpages, but the thing is that the following lines in the
install-manpages: build-manpages
$(call colorecho,INSTALL,"man pages")
$(QUIET)mkdir -m 755 -p ${DESTDIR}${MANPREFIX}/man1
${DESTDIR}${MANPREFIX}/man5
ifneq "$(wildcard ./doc/_build/man/${PROJECT}.1)" ""
$(QUIET)install -m 644 ./doc/_build/man/${PROJECT}.1
${DESTDIR}${MANPREFIX}/man1
endif
ifneq "$(wildcard ./doc/_build/man/${PROJECT}rc.5)" ""
$(QUIET)install -m 644 ./doc/_build/man/${PROJECT}rc.5
${DESTDIR}${MANPREFIX}/man5
endif
That is because *Sphinx*, after building the manpages for *zathura* and
*zathurarc*, it does not leave them under *./doc/_build/man/*, but rather
under *./doc/_build/*.
So removing the */man/* part of the path in these four lines fixes the
problem.
Thanks for noticing. This should be fixed now.

Cheers
--
Sebastian Ramacher
Loading...