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

Thu Jun 18 14:29:10 PDT 2020

Hi again,

Travis is returning an error because I have added pdflatex to the
requirements. I think the problem is that we are still using a 16.04
machine, with python 3.5 in Travis and PDFLAtex is only available on pip in
python >= 3.6

Is there a reason to keep this old setup for travis, would it make sense to
upgrade? at least for 18.04 now that 20.04 already available. Otherwise, I
can simply remove the requirement

https://travis-ci.org/github/qgis/QGIS-Documentation/builds/699870137

Thanks,

Alexandre Neto

On Thu, Jun 18, 2020 at 10:22 PM Alexandre Neto <senhor.neto at gmail.com>
wrote:

> Hi,
>
> Based on some work done by Richard and Håvard, I have tried to revive the
> ability to create PDFs for the main documents.
>
> https://github.com/qgis/QGIS-Documentation/pull/5729
>
> I only tested with English outputs, but I hope it works with most
> languages too.
>
> Thanks!
>
> Alexandre Neto
>
>
> On Fri, Apr 24, 2020 at 9:03 AM Richard Duivenvoorde <rdmailings at duif.net>
> wrote:
>
>> 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
>> >
>>
>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-user/attachments/20200618/2ce379f1/attachment.html>