<div dir="ltr">Hi Alexandre,<div class="gmail_extra"><br></div><div class="gmail_extra">For when working on just the PyQGIS Cookbook, I made a small shell script [0] that applies a git diff patch [1] to the QGIS-Documentation repo, which adjusts the Sphinx conf.py to exclude everything but the section I am working on during a build, builds the docs, then reverts the patch.<br>
<br></div><div class="gmail_extra">I do get a couple of Sphinx warnings about missing other sections when processing the main index, but the script is very handy to add as an external command in PyCharm (my reST editor), which also provides console output from the build run.<br>
<br></div><div class="gmail_extra">I also use `restview $FilePath$` as an external command to quickly auto-preview the current .rst file in PyCharm in the restview server [2]. Not a perfect preview, but IMO more helpful for reading how the text flows than just reading reST alone.<br>
<br></div><div class="gmail_extra">Having those two commands bound to shortcut keys has really sped up my editing previews.<br></div><div class="gmail_extra"><br>[0] <a href="https://gist.github.com/dakcarto/f166cdc1135c5d34c673">https://gist.github.com/dakcarto/f166cdc1135c5d34c673</a><br>
[1] <a href="https://gist.github.com/dakcarto/bd6a5b1c2dd7565918f6">https://gist.github.com/dakcarto/bd6a5b1c2dd7565918f6</a><br>[2] <a href="https://pypi.python.org/pypi/restview">https://pypi.python.org/pypi/restview</a><br>
<br></div><div class="gmail_extra">Regards, <br></div><div class="gmail_extra"><div><br>Larry Shaffer<br>Dakota Cartography<br>Black Hills, South Dakota</div>
<br><br><div class="gmail_quote">On Wed, May 7, 2014 at 4:06 AM, Richard Duivenvoorde <span dir="ltr"><<a href="mailto:richard@duif.net" target="_blank">richard@duif.net</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div class=""><div class="h5">On 07-05-14 10:21, Alexandre Neto wrote:<br>
> Hello all,<br>
><br>
> while preparing screenshots for the Users Manual, it's quite useful to<br>
> build the related html and PDF to see if everything was done well. But<br>
> it takes a lots of time (at least in my computer).<br>
><br>
> Is there a way to just Build the Users Manual and Ignore PyQGIS Cookbook<br>
> and Training Manual?<br>
><br>
> Generally I simply activate the virtual environment and do "make pdf".<br>
<br>
</div></div>Hi Alexandre,<br>
<br>
easiest, I think is to just remove the rst-sources (temporarily) from<br>
your build directory: /QGIS-Documentation/source/docs . This will<br>
already speed up your html building already because only user_manual<br>
will not be read/build then.<br>
<br>
If you comment out or (temporarily) remove the lines for<br>
pyqgis_developer_cookbook and user_manual in sources/conf.py around this<br>
part:<br>
<br>
latex_documents = [<br>
<br>
  ('docs/user_manual/index', 'QGISUserGuide.tex', u'QGIS User Guide',<br>
u'QGIS Project', 'manu><br>
  ('docs/pyqgis_developer_cookbook/index',<br>
'PyQGISDeveloperCookbook.tex', u'PyQGIS developer><br>
  ('docs/training_manual/index', 'QGISTrainingManual.tex', u'QGIS<br>
Training Manual', u'QGIS P><br>
]<br>
<br>
then the Makefile will not even be able to try to build latex/pdf stuff<br>
for those docs.<br>
<br>
Hope this helps,<br>
<br>
Regards,<br>
<br>
Richard Duivenvoorde<br>
_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org">Qgis-community-team@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/qgis-community-team" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>
</blockquote></div><br></div></div>