[Qgis-community-team] Fwd: [Qgis-user] documentation v 3.10 - PDF ?

[Richard Duivenvoorde]

Sure :-)

And to be clear: I'm not against creating (or providing docs about
creating) pdf's/latex. Just that I'm not good in it, AND I wanted to
keep the building process as smooth and easy and possible on ALL OS's.

Going through latex is hard to hit all three bullet points above for all
OS's, but on our Debian build machines it should be rather easy to setup
at least for Engish.

One thing to note though is that setting it up for non western languages
is trickier, because of all the different locales/font you need for
latex to work in all languages. THAT is actually the reason we created a
docker anyway... IN that docker is ALL machinery to build chinese and
japanese and farshi tex/pdf...

I just did a quick test here locally, and using the (default Sphinx)
latex builder I'm able to create tex files... but then I'm stuck :-)

So: if anybody is able to update the Makefile to create pdf's, please
do. And it should be easier then before:
https://www.sphinx-doc.org/en/master/usage/builders/index.html#sphinx.builders.latex.LaTeXBuilder.

Let's start small: make it possible to create the english pdf's on
Debian stable. Then we can build these at least.

Any volunteers or people willing to share some latex knowledge?

Regards,

Richard

On 4/24/20 9:15 AM, Alexandre Neto wrote:
> Something to discuss?
> 
> ---------- Forwarded message ---------
> De: *Håvard Tveite* <havard.tveite at nmbu.no <mailto:havard.tveite at nmbu.no>>
> Date: quinta, 23/04/2020, 22:20
> Subject: Re: [Qgis-user] documentation v 3.10 - PDF ?
> To: Alexandre Neto <senhor.neto at gmail.com
> <mailto:senhor.neto at gmail.com>>, karsten <karsten at terragis.net
> <mailto:karsten at terragis.net>>
> Cc: QGIS User <qgis-user at lists.osgeo.org <mailto:qgis-user at lists.osgeo.org>>
> 
> 
> I hope that we can continue to provide the documentation also
> as PDFs (one for the user manual, one for the training manual, ...).
> HTML definitely has its merits, but I find a PDF very much more
> convenient than a huge structure of HTML files for reading and
> searching the documentation.
> 
> Could a "compromise" be to generate the PDF(s) as a separate
> process?  We could then generate the PDFs less frequently
> (and provide a warning about that).
> 
> Håvard
> 
> On 23.04.2020 23:09, Alexandre Neto wrote:
>> Hello Karsten,
>>
>> The documentation team decided to drop the PDF creation, because It was
>> a big overhead in the all process.
>>
>> The plan is to provide the HTML version in a zip package instead, but we
>> were not able to tackle that yet. We think the HTML package will replace
>> the PDF functionality, while providing another advantage. Having a local
>> copy of the HTML, one can set QGIS to use it as an alternative to online
>> documentation. That way, if you press a help button while offline, it
>> will redirect to you local copy.
>>
>> Thanks,
>>
>> Alexandre Neto
>>
>> A quinta, 23/04/2020, 19:26, karsten <karsten at terragis.net
> <mailto:karsten at terragis.net>
>> <mailto:karsten at terragis.net <mailto:karsten at terragis.net>>> escreveu:
>>
>>     __
>>     Dear all,
>>     I have looked at the nice new documentation for QGIS v. 3.10 online
>>     (HTML) but wanted to find the PDF versions which unfortunately I
>>     could not locate so far (last ones I found are 3.4 ).
>>     Can someone point me to the doc PDFs ?
>>     or are there none available (unless I would install all the docs
>>     source code and try to compile them myself as PDF ) ?
>>     Thanks + Cheers
>>     Karsten
>>     _______________________________________________
>>     Qgis-user mailing list
>>     Qgis-user at lists.osgeo.org <mailto:Qgis-user at lists.osgeo.org>
> <mailto:Qgis-user at lists.osgeo.org <mailto:Qgis-user at lists.osgeo.org>>
>>     List info: https://lists.osgeo.org/mailman/listinfo/qgis-user
>>     Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-user
>>
> 
> _______________________________________________
> Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..
> Qgis-community-team at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/qgis-community-team
>