[DOCS] PDF building with FOP

Поиск
Список
Период
Сортировка
От Peter Eisentraut
Тема [DOCS] PDF building with FOP
Дата
Msg-id 8533aa6b-0f07-9d76-af3b-1f8515b1365e@2ndquadrant.com
обсуждение исходный текст
Ответы Re: [DOCS] PDF building with FOP  (Alvaro Herrera <alvherre@2ndquadrant.com>)
Re: [DOCS] PDF building with FOP  (Tom Lane <tgl@sss.pgh.pa.us>)
Re: [DOCS] PDF building with FOP  (Alexander Law <exclusion@gmail.com>)
Список pgsql-docs
As we are moving away from the old DSSSL toolchain, we also need to look
into how we are building PDFs.

The old way, using jadetex, is called by

    make postgres-A4.pdf postgres-US.pdf

The new way, using FOP, is called by

    make postgres-A4-fop.pdf postgres-US-fop.pdf

This already exists.

The questions for those who are building PDFs are

- Can you make the build work?

- Does the output look OK?


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.)

Note also that there are wildly different fop versions shipped with
distributions.  Compare your package version or fop -v output with the
available versions at <https://xmlgraphics.apache.org/fop/download.html>.


I have done a fair amount of testing across different platforms.  My
assessment is that it's good enough to move forward.  It doesn't have to
work out of the box for everyone.  But I want to make sure that those
who are building PDFs regularly are on board with this.

--
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


В списке pgsql-docs по дате отправления:

Предыдущее
От: Peter Eisentraut
Дата:
Сообщение: Re: [DOCS] broken devel-pages styles
Следующее
От: Alvaro Herrera
Дата:
Сообщение: Re: [DOCS] PDF building with FOP