[Geoserver-devel] PDF documentation

GeoServer GeoServer Developer
1

Hi,
the PDF documentation has not been generated for the past few releases.
I’m wondering if we can automate its generation any way, or if we should simply drop it
as something we’re failing to deliver?

Cheers
Andrea

–

== Our support, Your Success! Visit http://opensdi.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

2

On Fri, Jan 10, 2014 at 10:41 AM, Andrea Aime
<andrea.aime@anonymised.com>wrote:

Hi,
the PDF documentation has not been generated for the past few releases.
I'm wondering if we can automate its generation any way, or if we should
simply drop it
as something we're failing to deliver?

Doh, I gave it another crack (never really worked on my machine) and this
time I've found this page:
http://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html

So the trick is, you have to install the texlive-full monster (1GB
download, 1.8GB installed on disk)
to have the PDF generation work (eeek!).
And then the generated PDF really sucks as all the images are ridiculously
big... but a quick
search on the internet shows latex can rescale the images if instructed to,
so for example the following
command makes the images 50% of their original size in the tex file:

sed "s/includegraphics/includegraphics[scale=0.5]/g"
GeoServerUserManual.tex > manual.tex

and then pdflatex can be invoked so that it does not require manual
intervention (we still have a million
issues in the generated tex file) like this:

pdflatex -interaction batchmode manual.tex

which in turn generates the following pdf file (still 900+ pages, please
please don't print this thing...):
http://demo.geo-solutions.it/share/manual.pdf

The images are at least not completely ridiculous in this output.. although
it seems it's still missing
a table of contents, good luck navigating it without it...

Wondering if the above could be replicated on the build server, to automate
the PDF production during
the release process... we'd need to have texlive-full there to have things
working though.

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

3

Hi Andrea,
Took a peak at that file. A few observations:

  • It seems there’s a “Contents” section but it’s completely empty (Page i and ii).

  • Footers - The alternating-side-page-numbers make sense for a book, but not for a PDF.

  • Footers - “21.10. Using the ImageMosaic plugin for raster time-series data” - the number has a trailing decimal place but probably shouldn’t.

  • Page 898 (22.10.2 Getting a NetCDF output file) has a link that goes into the margin and off the page.

This transmission is intended for the named addressee(s) only and may contain sensitive or protectively marked material up to RESTRICTED and should be handled accordingly. Unless you are the named addressee (or authorised to receive it for the addressee) you may not copy or use it, or disclose it to anyone else. If you have received this transmission in error please notify the sender immediately. All email traffic sent to or from us, including without limitation all GCSX traffic, may be subject to recording and/or monitoring in accordance with relevant legislation.

···

There’s quoted text on the page above that does something similar too. Code comments ala “21.14.3 Hidden Deployment” as well.

All minor things; it looks good (I’ve never peeked at the pdf before).

Cheers,
Jonathan

On 10 January 2014 11:11, Andrea Aime <andrea.aime@anonymised.com> wrote:

CenturyLink Cloud: The Leader in Enterprise Cloud Services.
Learn Why More Businesses Are Choosing CenturyLink Cloud For
Critical Workloads, Development Environments & Everything In Between.
Get a Quote or Start a Free Trial Today.
http://pubads.g.doubleclick.net/gampad/clk?id=119420431&iu=/4140/ostg.clktrk

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

On Fri, Jan 10, 2014 at 10:41 AM, Andrea Aime <andrea.aime@anonymised.com> wrote:

Hi,
the PDF documentation has not been generated for the past few releases.
I’m wondering if we can automate its generation any way, or if we should simply drop it
as something we’re failing to deliver?

Doh, I gave it another crack (never really worked on my machine) and this time I’ve found this page:
http://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html

So the trick is, you have to install the texlive-full monster (1GB download, 1.8GB installed on disk)
to have the PDF generation work (eeek!).
And then the generated PDF really sucks as all the images are ridiculously big… but a quick
search on the internet shows latex can rescale the images if instructed to, so for example the following
command makes the images 50% of their original size in the tex file:

sed “s/includegraphics/includegraphics[scale=0.5]/g” GeoServerUserManual.tex > manual.tex

and then pdflatex can be invoked so that it does not require manual intervention (we still have a million
issues in the generated tex file) like this:

pdflatex -interaction batchmode manual.tex

which in turn generates the following pdf file (still 900+ pages, please please don’t print this thing…):
http://demo.geo-solutions.it/share/manual.pdf

The images are at least not completely ridiculous in this output… although it seems it’s still missing
a table of contents, good luck navigating it without it…

Wondering if the above could be replicated on the build server, to automate the PDF production during
the release process… we’d need to have texlive-full there to have things working though.

Cheers

Andrea

–

== Our support, Your Success! Visit http://opensdi.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

4

Latex requires multiple passes to provide intra-document links/references of any sort (my understanding is that Latex’s semantics make it difficult to make a multi-pass latex compiler and without it you cannot know what the page numbers are for any such links.) Generally it is necessary to run the ‘latex’ command multiple times for a document of any complexity - did you try re-running it?

I’ll also note that any place where content runs off the page will be noted in an ‘overfull hbox’ or similar warning from the latex command. Tracking them back to the Sphinx/rst sources can be a pain.

···

There’s quoted text on the page above that does something similar too. Code comments ala “21.14.3 Hidden Deployment” as well.

All minor things; it looks good (I’ve never peeked at the pdf before).

Cheers,
Jonathan

On 10 January 2014 11:11, Andrea Aime <andrea.aime@anonymised.com> wrote:

CenturyLink Cloud: The Leader in Enterprise Cloud Services.
Learn Why More Businesses Are Choosing CenturyLink Cloud For
Critical Workloads, Development Environments & Everything In Between.
Get a Quote or Start a Free Trial Today.
http://pubads.g.doubleclick.net/gampad/clk?id=119420431&iu=/4140/ostg.clktrk

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

On Fri, Jan 10, 2014 at 10:41 AM, Andrea Aime <andrea.aime@anonymised.com.> wrote:

Hi,
the PDF documentation has not been generated for the past few releases.
I’m wondering if we can automate its generation any way, or if we should simply drop it
as something we’re failing to deliver?

Doh, I gave it another crack (never really worked on my machine) and this time I’ve found this page:
http://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html

So the trick is, you have to install the texlive-full monster (1GB download, 1.8GB installed on disk)
to have the PDF generation work (eeek!).
And then the generated PDF really sucks as all the images are ridiculously big… but a quick
search on the internet shows latex can rescale the images if instructed to, so for example the following
command makes the images 50% of their original size in the tex file:

sed “s/includegraphics/includegraphics[scale=0.5]/g” GeoServerUserManual.tex > manual.tex

and then pdflatex can be invoked so that it does not require manual intervention (we still have a million
issues in the generated tex file) like this:

pdflatex -interaction batchmode manual.tex

which in turn generates the following pdf file (still 900+ pages, please please don’t print this thing…):
http://demo.geo-solutions.it/share/manual.pdf

The images are at least not completely ridiculous in this output… although it seems it’s still missing
a table of contents, good luck navigating it without it…

Wondering if the above could be replicated on the build server, to automate the PDF production during
the release process… we’d need to have texlive-full there to have things working though.

Cheers

Andrea

–

== Our support, Your Success! Visit http://opensdi.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

5

On Fri, Jan 10, 2014 at 3:49 PM, David Winslow <dwinslow@anonymised.com>wrote:

Latex requires multiple passes to provide intra-document links/references
of any sort (my understanding is that Latex's semantics make it difficult
to make a multi-pass latex compiler and without it you cannot know what the
page numbers are for any such links.) Generally it is necessary to run the
'latex' command multiple times for a document of any complexity - did you
try re-running it?

Ah! Yes, running it again makes the TOC appear. Weird :slight_smile:

I'll also note that any place where content runs off the page will be
noted in an 'overfull hbox' or similar warning from the latex command.
Tracking them back to the Sphinx/rst sources can be a pain.

Yes... don't really feel like hunting down these things...

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

6

Hi all,
so… any chance we can have the full latex package installed on the build server?
If this gets done, I’ll spend some time updating the release scripts to also generate the pdf docs.
Will not be perfect, but should be an improvement over what we had, and maybe we will
get traction to improve them further

Cheers
Andrea

···

On Fri, Jan 10, 2014 at 6:57 PM, Andrea Aime <andrea.aime@anonymised.com> wrote:

–

== Our support, Your Success! Visit http://opensdi.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

On Fri, Jan 10, 2014 at 3:49 PM, David Winslow <dwinslow@anonymised.com…3839…> wrote:

Latex requires multiple passes to provide intra-document links/references of any sort (my understanding is that Latex’s semantics make it difficult to make a multi-pass latex compiler and without it you cannot know what the page numbers are for any such links.) Generally it is necessary to run the ‘latex’ command multiple times for a document of any complexity - did you try re-running it?

Ah! Yes, running it again makes the TOC appear. Weird :slight_smile:

I’ll also note that any place where content runs off the page will be noted in an ‘overfull hbox’ or similar warning from the latex command. Tracking them back to the Sphinx/rst sources can be a pain.

Yes… don’t really feel like hunting down these things…

Cheers

Andrea

–

== Our support, Your Success! Visit http://opensdi.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

7

On Wed, Jan 29, 2014 at 7:07 AM, Andrea Aime
<andrea.aime@anonymised.com>wrote:

Hi all,
so... any chance we can have the full latex package installed on the build
server?
If this gets done, I'll spend some time updating the release scripts to
also generate the pdf docs.
Will not be perfect, but should be an improvement over what we had, and
maybe we will
get traction to improve them further

Sure. I just installed what I think should be latex and all the required
font packages.

Cheers
Andrea

On Fri, Jan 10, 2014 at 6:57 PM, Andrea Aime <andrea.aime@anonymised.com
> wrote:

On Fri, Jan 10, 2014 at 3:49 PM, David Winslow <dwinslow@anonymised.com
> wrote:

Latex requires multiple passes to provide intra-document
links/references of any sort (my understanding is that Latex's semantics
make it difficult to make a multi-pass latex compiler and without it you
cannot know what the page numbers are for any such links.) Generally it is
necessary to run the 'latex' command multiple times for a document of any
complexity - did you try re-running it?

Ah! Yes, running it again makes the TOC appear. Weird :slight_smile:

I'll also note that any place where content runs off the page will be
noted in an 'overfull hbox' or similar warning from the latex command.
Tracking them back to the Sphinx/rst sources can be a pain.

Yes... don't really feel like hunting down these things...

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

------------------------------------------------------------------------------
WatchGuard Dimension instantly turns raw network data into actionable
security intelligence. It gives you real-time visual feedback on key
security issues and trends. Skip the complicated setup - simply import
a virtual appliance and go from zero to informed in seconds.

http://pubads.g.doubleclick.net/gampad/clk?id=123612991&iu=/4140/ostg.clktrk
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

--
*Justin Deoliveira*
Vice President, Engineering | Boundless
jdeolive@anonymised.com
@j_deolive <https://twitter.com/j_deolive&gt;

8

On Wed, Jan 29, 2014 at 4:32 PM, Justin Deoliveira <
jdeolive@anonymised.com> wrote:

On Wed, Jan 29, 2014 at 7:07 AM, Andrea Aime <andrea.aime@anonymised.com
> wrote:

Hi all,
so... any chance we can have the full latex package installed on the
build server?
If this gets done, I'll spend some time updating the release scripts to
also generate the pdf docs.
Will not be perfect, but should be an improvement over what we had, and
maybe we will
get traction to improve them further

Sure. I just installed what I think should be latex and all the required
font packages.

Thanks. Which package was that?
I'm asking because the only way to have the freaking monster build the PDF
on my
machine was to install texlive-full (which is "everything you ever wanted,
plus
lots more stuff you did not imagine existed, about latex"), see also:
http://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

9

On Wed, Jan 29, 2014 at 8:40 AM, Andrea Aime
<andrea.aime@anonymised.com>wrote:

On Wed, Jan 29, 2014 at 4:32 PM, Justin Deoliveira <
jdeolive@anonymised.com> wrote:

On Wed, Jan 29, 2014 at 7:07 AM, Andrea Aime <
andrea.aime@anonymised.com> wrote:

Hi all,
so... any chance we can have the full latex package installed on the
build server?
If this gets done, I'll spend some time updating the release scripts to
also generate the pdf docs.
Will not be perfect, but should be an improvement over what we had, and
maybe we will
get traction to improve them further

Sure. I just installed what I think should be latex and all the required
font packages.

Thanks. Which package was that?
I'm asking because the only way to have the freaking monster build the PDF
on my
machine was to install texlive-full (which is "everything you ever
wanted, plus
lots more stuff you did not imagine existed, about latex"), see also:
http://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html

Right. Initially I just installed these packages going off some notes i
made in the past about getting pdfs to work since indeed it is kind of a
nightmare:

  texlive-latex-recommened
  texlive-latex-extra
  texlive-fonts-recommended

But I just went ahead and installed texlive-full as well. So hopefully we
are good.

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

--
*Justin Deoliveira*
Vice President, Engineering | Boundless
jdeolive@anonymised.com
@j_deolive <https://twitter.com/j_deolive&gt;

10

On Wed, Jan 29, 2014 at 5:01 PM, Justin Deoliveira <
jdeolive@anonymised.com> wrote:

Right. Initially I just installed these packages going off some notes i
made in the past about getting pdfs to work since indeed it is kind of a
nightmare:

  texlive-latex-recommened
  texlive-latex-extra
  texlive-fonts-recommended

But I just went ahead and installed texlive-full as well. So hopefully we
are good.

Hopefully we'll know soon enough. Created
http://jira.codehaus.org/browse/GEOS-6322 to track the build process
changes

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

11

A potential alternative for PDF generation is https://github.com/flyingsaucerproject/flyingsaucer

I used this for sphinx docs with success in the past but don’t have the CSS stylesheet I had created (previous employer). The key was some of the CSS3 page media support.

It was much faster, IIRC, and I was able to fix a number of layout issues w/ latex and it’s a lot easier to install and have other work with :slight_smile:

To be clear, out of the box and without additional CSS, it won’t work that great.

···

On Wed, Jan 29, 2014 at 9:01 AM, Justin Deoliveira <jdeolive@anonymised.com> wrote:

WatchGuard Dimension instantly turns raw network data into actionable
security intelligence. It gives you real-time visual feedback on key
security issues and trends. Skip the complicated setup - simply import
a virtual appliance and go from zero to informed in seconds.
http://pubads.g.doubleclick.net/gampad/clk?id=123612991&iu=/4140/ostg.clktrk

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

–

Ian Schneider
Software Engineer | Boundless
ischneider@anonymised.com

On Wed, Jan 29, 2014 at 8:40 AM, Andrea Aime <andrea.aime@anonymised.com> wrote:

Right. Initially I just installed these packages going off some notes i made in the past about getting pdfs to work since indeed it is kind of a nightmare:

texlive-latex-recommened
texlive-latex-extra
texlive-fonts-recommended

But I just went ahead and installed texlive-full as well. So hopefully we are good.

–

Justin Deoliveira
Vice President, Engineering | Boundless
jdeolive@anonymised.com
@j_deolive

On Wed, Jan 29, 2014 at 4:32 PM, Justin Deoliveira <jdeolive@anonymised.com9…> wrote:

Thanks. Which package was that?
I’m asking because the only way to have the freaking monster build the PDF on my
machine was to install texlive-full (which is “everything you ever wanted, plus
lots more stuff you did not imagine existed, about latex”), see also:
http://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html

On Wed, Jan 29, 2014 at 7:07 AM, Andrea Aime <andrea.aime@anonymised.com8…> wrote:

Hi all,
so… any chance we can have the full latex package installed on the build server?
If this gets done, I’ll spend some time updating the release scripts to also generate the pdf docs.
Will not be perfect, but should be an improvement over what we had, and maybe we will
get traction to improve them further

Sure. I just installed what I think should be latex and all the required font packages.

Cheers

Andrea

–

== Our support, Your Success! Visit http://opensdi.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

12

On Wed, Jan 29, 2014 at 6:17 PM, Ian Schneider
<ischneider@anonymised.com>wrote:

A potential alternative for PDF generation is
https://github.com/flyingsaucerproject/flyingsaucer

I used this for sphinx docs with success in the past but don't have the
CSS stylesheet I had created (previous employer). The key was some of the
CSS3 page media support.

It was much faster, IIRC, and I was able to fix a number of layout issues
w/ latex and it's a lot easier to install and have other work with :slight_smile:

That sounds rather interesting... unfortunately I don't have time to
research it right now (and my CSS3 is not rusty... it's simply not there).
Any other taker? :slight_smile:

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

13

On Wed, Jan 29, 2014 at 5:21 PM, Andrea Aime
<andrea.aime@anonymised.com>wrote:

On Wed, Jan 29, 2014 at 5:01 PM, Justin Deoliveira <
jdeolive@anonymised.com> wrote:

Right. Initially I just installed these packages going off some notes i
made in the past about getting pdfs to work since indeed it is kind of a
nightmare:

  texlive-latex-recommened
  texlive-latex-extra
  texlive-fonts-recommended

But I just went ahead and installed texlive-full as well. So hopefully we
are good.

Hopefully we'll know soon enough. Created
http://jira.codehaus.org/browse/GEOS-6322 to track the build process
changes

Ok, just committed a change on master that should make it build the pdf and
eventually deploy it on sourceforge.
Now... I guess we'll have to wait until the next release to check if it
works properly?
Or, does anybody have suggestions on how to test it otherwise?

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

14

You could run the build job and it should copy the artifacts to the directory without doing anything in github, sourceforge, or jira.

But I just ran the pdf creation commands from the build script on the build server and they worked great. Result looked nice.

···

On Thu, Jan 30, 2014 at 8:15 AM, Andrea Aime <andrea.aime@anonymised.com> wrote:

–

Justin Deoliveira
Vice President, Engineering | Boundless
jdeolive@anonymised.com
@j_deolive

On Wed, Jan 29, 2014 at 5:21 PM, Andrea Aime <andrea.aime@anonymised.com> wrote:

Ok, just committed a change on master that should make it build the pdf and eventually deploy it on sourceforge.
Now… I guess we’ll have to wait until the next release to check if it works properly?
Or, does anybody have suggestions on how to test it otherwise?

Cheers

Andrea

–

== Our support, Your Success! Visit http://opensdi.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

On Wed, Jan 29, 2014 at 5:01 PM, Justin Deoliveira <jdeolive@anonymised.com> wrote:

Hopefully we’ll know soon enough. Created http://jira.codehaus.org/browse/GEOS-6322 to track the build process
changes

Right. Initially I just installed these packages going off some notes i made in the past about getting pdfs to work since indeed it is kind of a nightmare:

texlive-latex-recommened
texlive-latex-extra
texlive-fonts-recommended

But I just went ahead and installed texlive-full as well. So hopefully we are good.

15

On Thu, Jan 30, 2014 at 5:39 PM, Justin Deoliveira <
jdeolive@anonymised.com> wrote:

You could run the build job and it should copy the artifacts to the
directory without doing anything in github, sourceforge, or jira.

Yeah... but it seems one is forced to build a real version of GeoServer,
which means that at the end the script will replace
the artifacts in the release directory for that version

But I just ran the pdf creation commands from the build script on the
build server and they worked great. Result looked nice.

Great, thanks for confirming

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

16

On Thu, Jan 30, 2014 at 9:41 AM, Andrea Aime
<andrea.aime@anonymised.com>wrote:

On Thu, Jan 30, 2014 at 5:39 PM, Justin Deoliveira <
jdeolive@anonymised.com> wrote:

You could run the build job and it should copy the artifacts to the
directory without doing anything in github, sourceforge, or jira.

Yeah... but it seems one is forced to build a real version of GeoServer,
which means that at the end the script will replace
the artifacts in the release directory for that version

Right... I guess you could a dummy version... something that will never be
an official release number. Or you could use something like 2.4.5... and
when we actually release 2.4.5 everything should just be overwritten.

But I just ran the pdf creation commands from the build script on the
build server and they worked great. Result looked nice.

Great, thanks for confirming

Cheers
Andrea

--
== Our support, Your Success! Visit http://opensdi.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

-------------------------------------------------------

--
*Justin Deoliveira*
Vice President, Engineering | Boundless
jdeolive@anonymised.com
@j_deolive <https://twitter.com/j_deolive&gt;