
<html><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">Hi<div class=""><br class=""><blockquote type="cite" class="">On 20 Jan 2016, at 15:26, Richard Duivenvoorde <<a href="mailto:richard@duif.net" class="">richard@duif.net</a>> wrote:<br class=""><br class="">(sorry for cross posting)<br class=""><br class="">Hi Devs and Python cookbook writers,<br class=""><br class="">As you may know if you follow community list, we have a travis build now<br class="">for QGIS documentation (and python cookbook then).<br class=""><br class="">To make Travis fail, I build the docs with an option that warning become<br class="">errors, thereby making it clear for commiters that something broke.<br class=""><br class="">To try to make it fully warning free know, I hit warnings like:<br class=""><br class="">pyqgis_developer_cookbook/canvas.rst:21: WARNING: py:class reference<br class="">target not found: QgsMapCanvas<br class=""><br class="">It turns out that Sphinx (off course) outside the source tree cannot<br class="">resolve the reference to the QgsMapCanvas documentation....<br class=""><br class="">Then found the sphinx conf.py option:<br class=""><br class="">nitpick_ignore = [('py:class', 'QgsMapCanvas'),<br class="">('py:class', 'QgsMapRenderer')]<br class=""><br class="">BUT that only works if you put all classes referenced in it, and I'm not<br class="">able to find a wildcard...<br class=""><br class="">So I find/added all classes... but then it start failing on :func: .....<br class="">which is even more...<br class=""><br class="">So: is it ok for you if I just delete all this :class: stuff? So it will<br class="">never be possible anymore to make that a reference to api.....<br class=""><br class="">I will leave the backquotes, so it will at least be made a bold font in<br class="">the docs....<br class=""><br class="">Please let me know if somebody sees troubles with this<br class=""></blockquote><div class=""><br class=""></div><div class="">This seems ok to me - the value of knowing the docs are clean is probably higher than the value of the outward links for class references.</div><div class=""><br class=""></div><div class="">Regards</div><div class=""><br class=""></div><div class="">Tim</div><br class=""><blockquote type="cite" class=""><br class="">Regards,<br class=""><br class="">Richard<br class="">_______________________________________________<br class="">Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br class=""><a href="mailto:Qgis-community-team@lists.osgeo.org" class="">Qgis-community-team@lists.osgeo.org</a><br class="">http://lists.osgeo.org/mailman/listinfo/qgis-community-team<br class=""></blockquote><br class=""><div class=""><span>—</span><br class=""><span><br class=""></span><span style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><br class="Apple-interchange-newline"><span><img height="66" width="160" apple-inline="yes" id="606A8E66-2569-4441-AF42-145EA78CE930" apple-width="yes" apple-height="yes" src="cid:62C890D4-3964-4609-BDE6-7536D5FBDD70" class=""></span><div style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-align: center;" class=""><br class="Apple-interchange-newline"><br class=""></div><div style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-align: center;" class="">Tim Sutton</div><div style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-align: center;" class=""><br class=""></div><div style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><div style="text-align: center;" class="">Visit <a href="http://kartoza.com" class="">http://kartoza.com</a> to find out about open source:</div><div style="text-align: center;" class=""><br class=""></div><div class=""><div style="text-align: center;" class="">* Desktop GIS programming services</div><div style="text-align: center;" class="">* Geospatial web development</div><div style="text-align: center;" class="">* GIS Training</div><div style="text-align: center;" class="">* Consulting Services</div><div style="text-align: center;" class=""><br class=""></div><div class=""><div style="text-align: center;" class="">Skype: timlinux Irc: timlinux on #qgis at <a href="http://freenode.net" class="">freenode.net</a></div><div style="text-align: center;" class="">Tim is a member of the QGIS Project Steering Committee</div><div style="text-align: center;" class=""><br class=""></div><div style="text-align: center;" class="">Kartoza is a merger between Linfiniti and Afrispatial</div></div></div></div>

</span></div><br class=""></div></body></html>