[Qgis-developer] Can :class: :mod: :func: be removed from python cookbook?

Alessandro Pasotti apasotti at gmail.com
Wed Jan 20 05:32:21 PST 2016

2016-01-20 14:25 GMT+01:00 Richard Duivenvoorde <rdmailings at duif.net>:

> (sorry for cross posting)
> Hi Devs and Python cookbook writers,
> As you may know if you follow community list, we have a travis build now
> for QGIS documentation (and python cookbook then).
> To make Travis fail, I build the docs with an option that warning become
> errors, thereby making it clear for commiters that something broke.
> To try to make it fully warning free know, I hit warnings like:
> pyqgis_developer_cookbook/canvas.rst:21: WARNING: py:class reference
> target not found: QgsMapCanvas
> It turns out that Sphinx (off course) outside the source tree cannot
> resolve the reference to the QgsMapCanvas documentation....
> Then found the sphinx conf.py option:
> nitpick_ignore = [('py:class', 'QgsMapCanvas'),
>                   ('py:class', 'QgsMapRenderer')]
> BUT that only works if you put all classes referenced in it, and I'm not
> able to find a wildcard...
> So I find/added all classes... but then it start failing on :func: .....
> which is even more...
> So: is it ok for you if I just delete all this :class: stuff? So it will
> never be possible anymore to make that a reference to api.....

Hello Richard,

I'd prefer if we keep that reference to the API.

I know that we are not currently using it, but it would be nice if one
could just click on the function/class name and jump to the API docs, this
could be implemented in the future.

Can't you just regexp and add the :func: stuff too?

Alessandro Pasotti
w3:   www.itopen.it
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-developer/attachments/20160120/0ba149aa/attachment.html>

More information about the Qgis-developer mailing list