<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">2016-01-20 14:25 GMT+01:00 Richard Duivenvoorde <span dir="ltr"><<a href="mailto:rdmailings@duif.net" target="_blank">rdmailings@duif.net</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">(sorry for cross posting)<br>
<br>
Hi Devs and Python cookbook writers,<br>
<br>
As you may know if you follow community list, we have a travis build now<br>
for QGIS documentation (and python cookbook then).<br>
<br>
To make Travis fail, I build the docs with an option that warning become<br>
errors, thereby making it clear for commiters that something broke.<br>
<br>
To try to make it fully warning free know, I hit warnings like:<br>
<br>
pyqgis_developer_cookbook/canvas.rst:21: WARNING: py:class reference<br>
target not found: QgsMapCanvas<br>
<br>
It turns out that Sphinx (off course) outside the source tree cannot<br>
resolve the reference to the QgsMapCanvas documentation....<br>
<br>
Then found the sphinx conf.py option:<br>
<br>
nitpick_ignore = [('py:class', 'QgsMapCanvas'),<br>
                  ('py:class', 'QgsMapRenderer')]<br>
<br>
BUT that only works if you put all classes referenced in it, and I'm not<br>
able to find a wildcard...<br>
<br>
So I find/added all classes... but then it start failing on :func: .....<br>
which is even more...<br>
<br>
So: is it ok for you if I just delete all this :class: stuff? So it will<br>
never be possible anymore to make that a reference to api.....<br></blockquote><div><br></div><div>Hello Richard,<br><br></div><div>I'd prefer if we keep that reference to the API.<br><br></div><div>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.<br><br></div><div>Can't you just regexp and add the :func: stuff too?<br clear="all"></div></div><br></div><div class="gmail_extra">-- <br><div class="gmail_signature">Alessandro Pasotti<br>w3:   <a href="http://www.itopen.it" target="_blank">www.itopen.it</a></div>
</div></div>