Re: PDF building with FOP

From: Alexander Law <exclusion(at)gmail(dot)com>
To: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: PDF building with FOP
Date: 2017-03-11 07:38:13
Message-ID: 2222e787-430e-4d67-4f55-4e091b7a2f53@gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Hello Peter,

11.03.2017 05:25, Peter Eisentraut wrote:
> The questions for those who are building PDFs are
>
> - Can you make the build work?
>
> - Does the output look OK?
Yes, we use FOP build to generate all the PDF's for current versions
(starting with 9.5).
Output looks ok, though we need to use extra fop-config.xml with font
substitutions to get Russian letters in the translated docs
(e.g. http://repo.postgrespro.ru/doc/pgsql/9.6/ru/postgres-A4-fop.pdf).
> Some tips: FOP is extremely memory hungry. You will probably have to
> fiddle with some Java memory settings to make it work. One way is by
> edting ~/.foprc and set something like
>
> FOP_OPTS='-Xmx1200m' # fop upstream binary installation
> ADDITIONAL_FLAGS='-Xmx1200m' # centos/fedora
> JAVA_ARGS='-Xmx1200m' # debian
>
> It looks like you need at least -Xmx1000m, depending on the fop version.
> More memory can make things faster. (Some of this could go into the
> documentation.)
Yes, we added JAVA_ARGS=-Xmx4096m to get the docs built on Ubuntu 14.04
(with FOP Version 1.1)
We also haven't encountered new problems on Ubuntu 16.04 (with FOP
Version 2.1). (This version prints some additional warnings, but the
resulting PDF looks valid).

Best regards,
Alexander

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message johnjdevine 2017-03-11 16:24:34 incorrect assignment op (= vs :=)
Previous Message Alexander Law 2017-03-11 07:22:51 Re: PDF building with FOP