[Geoserver-devel] GeoServer 2.3.1 release: PDF docs, or better, dropping them

Hi,
another thing that is not build by the build server is the DPF docs.
I’ve installed virtually every package with latex in its name (well over a GB of stuff) but the build keeps on giving me hundreds of errors, and in the end the generated PDF does not contain a table of contents…

Given all the hurdles with generating the PDF, and generally speaking, how bad the PDF looks vs images contained in it (they are very much oversized) I’d suggest to just drop the PDF as part of our downloads.

Opinions?

Cheers
Andrea

==
GeoServer training in Milan, 6th & 7th June 2013! Visit http://geoserver.geo-solutions.it for more information.

Ing. Andrea Aime
@geowolf
Technical Lead

GeoSolutions S.A.S.
Via Poggio alle Viti 1187
55054 Massarosa (LU)
Italy
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549

http://www.geo-solutions.it
http://twitter.com/geosolutions_it


I understand, I have had some luck with the latex build pipeline in another context, but ended up with various restrictions on what RST syntax can be used (in order to avoid errors creating PDFs). Mark Leslie would have more details on what to avoid.

However for the direct issue of image handling I have an answer discovered earlier this month.

To handle images consistently for both HTML and PDF:

… image:: foo.png
:width: 100% ← to make sure we start within bounds
:scale: 80% ← scale is adjusted from above width, change percentage to make content consistent in final output

So some examples would be:

… image:: webpage.png
:width: 100%
:scale: 100%

… image:: windows_installer_wizard.png
:width: 100%
:scale: 60%

… image:: open_layers_preview.png

:width: 100%
:scale: 80%

… image:: config_page_detail.png
:width: 100%
:scale: 30%

But yeah until the PDF is cleaned up may as well leave it out. You can even indicate a volunteer is needed in your release announcement.


Jody Garnett

On Sunday, 21 April 2013 at 3:08 AM, Andrea Aime wrote:

Hi,
another thing that is not build by the build server is the DPF docs.
I’ve installed virtually every package with latex in its name (well over a GB of stuff) but the build keeps on giving me hundreds of errors, and in the end the generated PDF does not contain a table of contents…

Given all the hurdles with generating the PDF, and generally speaking, how bad the PDF looks vs images contained in it (they are very much oversized) I’d suggest to just drop the PDF as part of our downloads.

Opinions?

Cheers
Andrea

==
GeoServer training in Milan, 6th & 7th June 2013! Visit http://geoserver.geo-solutions.it for more information.

Ing. Andrea Aime
@geowolf
Technical Lead

GeoSolutions S.A.S.
Via Poggio alle Viti 1187
55054 Massarosa (LU)
Italy
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549

http://www.geo-solutions.it
http://twitter.com/geosolutions_it



Precog is a next-generation analytics platform capable of advanced
analytics on semi-structured data. The platform includes APIs for building
apps and a phenomenal toolset for data science. Developers can use
our toolset for easy data analysis & visualization. Get a free account!
http://www2.precog.com/precogplatform/slashdotnewsletter


Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

Well, PDF docs are one of the reason why we moved to Sphinx so many years ago, so bummer.

I admit that until/unless someone goes in and cleans up the documentation output for LaTeX, it's not going to look pretty. That said, I would be against dropping them just on the basis of them looking bad. But if no one other than me is able to build the PDF docs easily, then I won't stand in anyone's way.

Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.org

On 4/21/2013 2:08 AM, Andrea Aime wrote:

Hi,
another thing that is not build by the build server is the DPF docs.
I've installed virtually every package with latex in its name (well over a
GB of stuff) but the build keeps on giving me hundreds of errors, and in
the end the generated PDF does not contain a table of contents...

Given all the hurdles with generating the PDF, and generally speaking, how
bad the PDF looks vs images contained in it (they are very much oversized)
I'd suggest to just drop the PDF as part of our downloads.

Opinions?

Cheers
Andrea

------------------------------------------------------------------------------
Precog is a next-generation analytics platform capable of advanced
analytics on semi-structured data. The platform includes APIs for building
apps and a phenomenal toolset for data science. Developers can use
our toolset for easy data analysis & visualization. Get a free account!
http://www2.precog.com/precogplatform/slashdotnewsletter

_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel