[PySide] PySide documentation on Qt Assistant

[Sean Fisk]

Hello Jorge,

That looks like a Sphinx issue, actually. It looks like it's trying to
create an inheritance diagram using Graphviz <http://graphviz.org/>. Do you
have it installed? (try 'dot -V').

Whether you have it installed or not, if that's the problem, it should be
warning you in a better way. I would hedge a guess that the qthelp builder
gets significantly less attention than, say, the HTML builder. Anyway, let
me know what the results are.

Cheers,


--
Sean Fisk


On Sat, Mar 29, 2014 at 2:47 PM, Jorge Araya Navarro <kartelo at gmx.com>wrote:

>  Hello, Sean!
>
> I changed the target, and ran build_docs.bash. But this problem appeared
> when building the pyside documentation:
>
> # Sphinx version: 1.1.3
> # Python version: 2.7.6
> # Docutils version: 0.11 release
> # Jinja2 version: 2.7.2
> Traceback (most recent call last):
>   File "/usr/lib/python2.7/site-packages/sphinx/cmdline.py", line 189, in main
>     app.build(force_all, filenames)
>   File "/usr/lib/python2.7/site-packages/sphinx/application.py", line 204, in build
>     self.builder.build_update()
>   File "/usr/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 196, in build_update
>     'out of date' % len(to_build))
>   File "/usr/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 252, in build
>     self.write(docnames, list(updated_docnames), method)
>   File "/usr/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 292, in write
>     self.write_doc(docname, doctree)
>   File "/usr/lib/python2.7/site-packages/sphinx/builders/html.py", line 419, in write_doc
>     self.docwriter.write(doctree, destination)
>   File "/usr/lib/python2.7/site-packages/docutils/writers/__init__.py", line 80, in write
>     self.translate()
>   File "/usr/lib/python2.7/site-packages/sphinx/writers/html.py", line 38, in translate
>     self.document.walkabout(visitor)
>   File "/usr/lib/python2.7/site-packages/docutils/nodes.py", line 174, in walkabout
>     if child.walkabout(visitor):
>   File "/usr/lib/python2.7/site-packages/docutils/nodes.py", line 174, in walkabout
>     if child.walkabout(visitor):
>   File "/usr/lib/python2.7/site-packages/docutils/nodes.py", line 166, in walkabout
>     visitor.dispatch_visit(self)
>   File "/usr/lib/python2.7/site-packages/docutils/nodes.py", line 1882, in dispatch_visit
>     return method(node)
>   File "/home/jorge/Escritorio/pyside-docs-master/prefix/src/pyside/doc/inheritance_diagram.py", line 340, in html_visit_inheritance_diagram
>     alt='Inheritance diagram of ' + node['content'])
>   File "/usr/lib/python2.7/site-packages/sphinx/ext/graphviz.py", line 219, in render_dot_html
>     mapfile = open(outfn + '.map', 'rb')
> IOError: [Errno 2] No such file or directory: '/home/jorge/Escritorio/pyside-docs-master/prefix/src/pyside/build/doc/qthelp/_images/inheritance-b09cc3548cdf92177ba3487cbdadc5722f725138.png.map'
>
>
>
> No file exists on
> '/home/jorge/Escritorio/pyside-docs-master/prefix/src/pyside/build/doc/qthelp/_images/',
> I'm not sure what could be causing this issue!
>
>   --
> *Pax et bonum.*
> Jorge Araya Navarro.
> Diseñador publicitario, programador Python/C++ y colaborador en Parabola
> GNU/Linux-libre.
>
>   El vie, 21-03-2014 a las 15:14 -0400, Sean Fisk escribió:
>
> Hello Jorge,
>
> I have created a script <https://github.com/seanfisk/pyside-docs> which I
> used to build the PySide docs which are currently up at
> http://pyside.github.io/docs/pyside/. If you look in build_docs.bash,
> there are a couple places where patches are applied to adjust the targets.
> That is likely where you will want to go to change html to qthelp.
> Running qcollectiongenerator could be done by adding a couple of CMake
> rules after Sphinx runs.
>
> There are a large number of gotchas when building the PySide docs, for
> example that qdoc3 from Qt 4.6.4 is the oldest version capable of
> building these docs. Therefore I would recommend simply modifying the
> scripts to do what you want.
>
> Hope this helps!
>
>
>
>
>
>  --
>
>  Sean Fisk
>
>
>
>  On Thu, Mar 20, 2014 at 1:05 PM, Jorge Araya Navarro <kartelo at gmx.com>
> wrote:
>
>  Hello!
>
> I'm in a journey of generating important python-related documentation of
> many important projects to view them on Qt Assistant. I'm struggling to
> understand how I can generate the PySide documentation, or how could I
> change the CMakeLists files to add the command `sphinx-build -b qthelp .
> build/qthelp` and then `qcollectiongenerator-qt4 build/qthelp/PySide.qhcp`
> so the documentation for Qt Assistant can be generated.
>
> Any help will be very appreciated!
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/pyside/attachments/20140329/1d842b75/attachment.html>