<div dir="ltr"><div>Solution with conf.py look good for me. It is very easy to uncomment<br></div>desired lines and run build. If others also have no objections I think we<br>can proceed with this<br></div><div class="gmail_extra"><br><div class="gmail_quote">2014-11-29 18:11 GMT+02:00 Richard Duivenvoorde <span dir="ltr"><<a href="mailto:richard@duif.net" target="_blank">richard@duif.net</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 29-11-14 13:58, Alexander Bruy wrote:<br>
> not sure if this really necessary, but what about some<br>
> tweaks in Makefile that allow us exclude Processing<br>
> help from build when needed<br>
<br>
</span>Yep, I tried here, that is easy:<br>
<br>
For example to only build the 'documentation_guidelines' part of the<br>
docs, adding something like:<br>
<br>
exclude_patterns += ['docs/training_manual/*', 'docs/user_manual/*',<br>
'docs/gentle_gis_introduction/*', 'docs/pyqgis_developer_cookbook/*']<br>
<br>
after exclude_patterns value in source/conf.py,<br>
makes sphinx just ignore the other docs<br>
<br>
So a<br>
<br>
exclude_patterns += ['docs/user_manual/processing_algs/*',<br>
'docs/training_manual/*', 'docs/documentation_guidelines/*',<br>
'docs/gentle_gis_introduction/*', 'docs/pyqgis_developer_cookbook/*']<br>
<br>
will build you ONLY a user_manual, but WITHOUT processing_algs<br>
<br>
What do you think is best, we could create some Makefile targets, or<br>
maybe a Makefile variable which you can bring in.<br>
<br>
But actually describe/document that it is that easy to edit the<br>
source/conf.py will make it easy for documentation builders to do this<br>
partial builds.<br>
And by doing it in the conf.py, we do not have to duplicate that switch<br>
in both Makefile and Paver configs....<br>
<br>
So what about adding the following to the conf.py, all commented, so<br>
user which wants to build can easily exclude stuff:<br>
<br>
# uncomment to exclude the processing algs from build<br>
#exclude_patterns += ['docs/user_manual/processing_algs/*']<br>
# uncomment to exclude the user manual from build<br>
#exclude_patterns += ['docs/user_manual/*']<br>
# uncomment to exclude training manual from build<br>
#exclude_patterns += ['docs/training_manual/*']<br>
# uncomment to exclude doc guides from build<br>
#exclude_patterns += ['docs/documentation_guidelines/*']<br>
# uncomment to exclude gentle intro  from build<br>
#exclude_patterns += ['docs/gentle_gis_introduction/*']<br>
# uncomment to exclude pyqgis dev book from build<br>
#exclude_patterns += ['docs/pyqgis_developer_cookbook/*']<br>
<br>
Ok, would that be clear/easy enough for the average builder?<br>
Or would we prefer to add switches?<br>
<br>
Regards,<br>
<br>
Richard Duivenvoorde<br>
<br>
<br>
<br>
<br>
</blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature">Alexander Bruy</div>
</div>