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 <[email protected]> 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* <[email protected] <mailto:[email protected] > >> > > Date: quinta, 23/04/2020, 22:20 > > Subject: Re: [Qgis-user] documentation v 3.10 - PDF ? > > To: Alexandre Neto <[email protected] > > <mailto:[email protected]>>, karsten <[email protected] > > <mailto:[email protected]>> > > Cc: QGIS User <[email protected] <mailto: > [email protected]>> > > > > > > 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 <[email protected] > > <mailto:[email protected]> > >> <mailto:[email protected] <mailto:[email protected]>>> 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 > >> [email protected] <mailto:[email protected]> > > <mailto:[email protected] <mailto:[email protected]>> > >> 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.. > > [email protected] > > https://lists.osgeo.org/mailman/listinfo/qgis-community-team > > > >
_______________________________________________ Qgis-user mailing list [email protected] List info: https://lists.osgeo.org/mailman/listinfo/qgis-user Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-user
