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.tve...@nmbu.no <mailto:havard.tve...@nmbu.no>> > Date: quinta, 23/04/2020, 22:20 > Subject: Re: [Qgis-user] documentation v 3.10 - PDF ? > To: Alexandre Neto <senhor.n...@gmail.com > <mailto:senhor.n...@gmail.com>>, karsten <kars...@terragis.net > <mailto:kars...@terragis.net>> > Cc: QGIS User <qgis-user@lists.osgeo.org <mailto:qgis-user@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 <kars...@terragis.net > <mailto:kars...@terragis.net> >> <mailto:kars...@terragis.net <mailto:kars...@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@lists.osgeo.org <mailto:Qgis-user@lists.osgeo.org> > <mailto:Qgis-user@lists.osgeo.org <mailto:Qgis-user@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-t...@lists.osgeo.org > https://lists.osgeo.org/mailman/listinfo/qgis-community-team > _______________________________________________ Qgis-user mailing list Qgis-user@lists.osgeo.org List info: https://lists.osgeo.org/mailman/listinfo/qgis-user Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-user
