<div dir="ltr">Hi,<div><br></div><div>Based on some work done by Richard and Håvard, I have tried to revive the ability to create PDFs for the main documents.</div><div><br></div><div><a href="https://github.com/qgis/QGIS-Documentation/pull/5729">https://github.com/qgis/QGIS-Documentation/pull/5729</a><br></div><div><br></div><div>I only tested with English outputs, but I hope it works with most languages too.</div><div><br></div><div>Thanks!</div><div><br></div><div>Alexandre Neto</div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Apr 24, 2020 at 9:03 AM Richard Duivenvoorde <<a href="mailto:rdmailings@duif.net">rdmailings@duif.net</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Sure :-)<br>
<br>
And to be clear: I'm not against creating (or providing docs about<br>
creating) pdf's/latex. Just that I'm not good in it, AND I wanted to<br>
keep the building process as smooth and easy and possible on ALL OS's.<br>
<br>
Going through latex is hard to hit all three bullet points above for all<br>
OS's, but on our Debian build machines it should be rather easy to setup<br>
at least for Engish.<br>
<br>
One thing to note though is that setting it up for non western languages<br>
is trickier, because of all the different locales/font you need for<br>
latex to work in all languages. THAT is actually the reason we created a<br>
docker anyway... IN that docker is ALL machinery to build chinese and<br>
japanese and farshi tex/pdf...<br>
<br>
I just did a quick test here locally, and using the (default Sphinx)<br>
latex builder I'm able to create tex files... but then I'm stuck :-)<br>
<br>
So: if anybody is able to update the Makefile to create pdf's, please<br>
do. And it should be easier then before:<br>
<a href="https://www.sphinx-doc.org/en/master/usage/builders/index.html#sphinx.builders.latex.LaTeXBuilder" rel="noreferrer" target="_blank">https://www.sphinx-doc.org/en/master/usage/builders/index.html#sphinx.builders.latex.LaTeXBuilder</a>.<br>
<br>
Let's start small: make it possible to create the english pdf's on<br>
Debian stable. Then we can build these at least.<br>
<br>
Any volunteers or people willing to share some latex knowledge?<br>
<br>
Regards,<br>
<br>
Richard<br>
<br>
On 4/24/20 9:15 AM, Alexandre Neto wrote:<br>
> Something to discuss?<br>
> <br>
> ---------- Forwarded message ---------<br>
> De: *Håvard Tveite* <<a href="mailto:havard.tveite@nmbu.no" target="_blank">havard.tveite@nmbu.no</a> <mailto:<a href="mailto:havard.tveite@nmbu.no" target="_blank">havard.tveite@nmbu.no</a>>><br>
> Date: quinta, 23/04/2020, 22:20<br>
> Subject: Re: [Qgis-user] documentation v 3.10 - PDF ?<br>
> To: Alexandre Neto <<a href="mailto:senhor.neto@gmail.com" target="_blank">senhor.neto@gmail.com</a><br>
> <mailto:<a href="mailto:senhor.neto@gmail.com" target="_blank">senhor.neto@gmail.com</a>>>, karsten <<a href="mailto:karsten@terragis.net" target="_blank">karsten@terragis.net</a><br>
> <mailto:<a href="mailto:karsten@terragis.net" target="_blank">karsten@terragis.net</a>>><br>
> Cc: QGIS User <<a href="mailto:qgis-user@lists.osgeo.org" target="_blank">qgis-user@lists.osgeo.org</a> <mailto:<a href="mailto:qgis-user@lists.osgeo.org" target="_blank">qgis-user@lists.osgeo.org</a>>><br>
> <br>
> <br>
> I hope that we can continue to provide the documentation also<br>
> as PDFs (one for the user manual, one for the training manual, ...).<br>
> HTML definitely has its merits, but I find a PDF very much more<br>
> convenient than a huge structure of HTML files for reading and<br>
> searching the documentation.<br>
> <br>
> Could a "compromise" be to generate the PDF(s) as a separate<br>
> process? We could then generate the PDFs less frequently<br>
> (and provide a warning about that).<br>
> <br>
> Håvard<br>
> <br>
> On 23.04.2020 23:09, Alexandre Neto wrote:<br>
>> Hello Karsten,<br>
>><br>
>> The documentation team decided to drop the PDF creation, because It was<br>
>> a big overhead in the all process.<br>
>><br>
>> The plan is to provide the HTML version in a zip package instead, but we<br>
>> were not able to tackle that yet. We think the HTML package will replace<br>
>> the PDF functionality, while providing another advantage. Having a local<br>
>> copy of the HTML, one can set QGIS to use it as an alternative to online<br>
>> documentation. That way, if you press a help button while offline, it<br>
>> will redirect to you local copy.<br>
>><br>
>> Thanks,<br>
>><br>
>> Alexandre Neto<br>
>><br>
>> A quinta, 23/04/2020, 19:26, karsten <<a href="mailto:karsten@terragis.net" target="_blank">karsten@terragis.net</a><br>
> <mailto:<a href="mailto:karsten@terragis.net" target="_blank">karsten@terragis.net</a>><br>
>> <mailto:<a href="mailto:karsten@terragis.net" target="_blank">karsten@terragis.net</a> <mailto:<a href="mailto:karsten@terragis.net" target="_blank">karsten@terragis.net</a>>>> escreveu:<br>
>><br>
>> __<br>
>> Dear all,<br>
>> I have looked at the nice new documentation for QGIS v. 3.10 online<br>
>> (HTML) but wanted to find the PDF versions which unfortunately I<br>
>> could not locate so far (last ones I found are 3.4 ).<br>
>> Can someone point me to the doc PDFs ?<br>
>> or are there none available (unless I would install all the docs<br>
>> source code and try to compile them myself as PDF ) ?<br>
>> Thanks + Cheers<br>
>> Karsten<br>
>> _______________________________________________<br>
>> Qgis-user mailing list<br>
>> <a href="mailto:Qgis-user@lists.osgeo.org" target="_blank">Qgis-user@lists.osgeo.org</a> <mailto:<a href="mailto:Qgis-user@lists.osgeo.org" target="_blank">Qgis-user@lists.osgeo.org</a>><br>
> <mailto:<a href="mailto:Qgis-user@lists.osgeo.org" target="_blank">Qgis-user@lists.osgeo.org</a> <mailto:<a href="mailto:Qgis-user@lists.osgeo.org" target="_blank">Qgis-user@lists.osgeo.org</a>>><br>
>> List info: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-user" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-user</a><br>
>> Unsubscribe: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-user" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-user</a><br>
>><br>
> <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" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
> <a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>
> <br>
<br>
</blockquote></div>