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

[Alexandre Neto]

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-community-team/attachments/20200618/6785bcaf/attachment.html>