Re: French PDF manual

Bruce Momjian wrote:
> Should we modify the doc build process to generate XML and convert
> that to PDF, or allow it as an option, because PDF generation has
> always been a problem from SGML (very slow)?

If the FOP-based build works better than Jade, by all means let's use
that. Last time I looked at FOP (years ago, admittedly), it broke at
about page 10. Obviously, Guillaume and company are getting better
results now.

What I would like to know, however, is whether FOP runs on a Free(tm)
Java implementation. It seems that you need Sun's JDK to run it and
that will be a problem if it's to become our primary build method.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

2006/5/9, Peter Eisentraut <peter_e(at)gmx(dot)net>:
> Bruce Momjian wrote:
> > Should we modify the doc build process to generate XML and convert
> > that to PDF, or allow it as an option, because PDF generation has
> > always been a problem from SGML (very slow)?
>
> If the FOP-based build works better than Jade, by all means let's use
> that. Last time I looked at FOP (years ago, admittedly), it broke at
> about page 10. Obviously, Guillaume and company are getting better
> results now.
>

We are getting better results in quality. Speed is quite different :
really quick to build a PDF, really slow to build HTML files.

> What I would like to know, however, is whether FOP runs on a Free(tm)
> Java implementation. It seems that you need Sun's JDK to run it and
> that will be a problem if it's to become our primary build method.
>

I use Sun's JDK. I didn't try something else... I'm gonna try.

--
Guillaume.

Peter Eisentraut a écrit :
> Bruce Momjian wrote:
>> Should we modify the doc build process to generate XML and convert
>> that to PDF, or allow it as an option, because PDF generation has
>> always been a problem from SGML (very slow)?
>
> If the FOP-based build works better than Jade, by all means let's use
> that. Last time I looked at FOP (years ago, admittedly), it broke at
> about page 10. Obviously, Guillaume and company are getting better
> results now.
>
> What I would like to know, however, is whether FOP runs on a Free(tm)
> Java implementation. It seems that you need Sun's JDK to run it and
> that will be a problem if it's to become our primary build method.
>

I finally had time to work on this matter. It works just great with
libgcj. I just had to export JAVA_HOME with a new location and to
install Jimy (for image rendering). There's only one issue : I found it
quite slow.

Guillaume LELARGE wrote:
> I finally had time to work on this matter. It works just great with
> libgcj. I just had to export JAVA_HOME with a new location and to
> install Jimy (for image rendering). There's only one issue : I found
> it quite slow.

As long as it works, it's OK.

Would you submit the changes that you had to make to the source code to
get useful results?

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

Peter Eisentraut a écrit :
> Guillaume LELARGE wrote:
>> I finally had time to work on this matter. It works just great with
>> libgcj. I just had to export JAVA_HOME with a new location and to
>> install Jimy (for image rendering). There's only one issue : I found
>> it quite slow.
>
> As long as it works, it's OK.
>
> Would you submit the changes that you had to make to the source code to
> get useful results?
>

Sorry Peter, I don't think I really understood what you meant. Which
changes are you talking about ? which source code ?

--
Guillaume.
<!-- http://abs.traduc.org/
http://lfs.traduc.org/
http://traduc.postgresqlfr.org/ -->

Am Donnerstag, 25. Mai 2006 01:31 schrieb Guillaume LELARGE:
> Sorry Peter, I don't think I really understood what you meant. Which
> changes are you talking about ? which source code ?

I thought that you had to make some changes to the documentation source code
to get it to work with fop.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

2006/5/26, Peter Eisentraut <peter_e(at)gmx(dot)net>:
> Am Donnerstag, 25. Mai 2006 01:31 schrieb Guillaume LELARGE:
> > Sorry Peter, I don't think I really understood what you meant. Which
> > changes are you talking about ? which source code ?
>
> I thought that you had to make some changes to the documentation source code
> to get it to work with fop.
>

Yes, you're right. There's some changes to do on the documentation
source files. I can provide a diff which will transform SGML files
into valid XML files. Do you want me to work on REL8_1_STABLE or HEAD
branch ?

I can work on this next monday and tuesday.

Regards.

--
Guillaume.

Am Freitag, 26. Mai 2006 14:19 schrieb Guillaume Lelarge:
> Yes, you're right. There's some changes to do on the documentation
> source files. I can provide a diff which will transform SGML files
> into valid XML files.

Is that the only change? Then we don't need it.

> Do you want me to work on REL8_1_STABLE or HEAD
> branch ?

HEAD branch always.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

2006/5/26, Peter Eisentraut <peter_e(at)gmx(dot)net>:
> Am Freitag, 26. Mai 2006 14:19 schrieb Guillaume Lelarge:
> > Yes, you're right. There's some changes to do on the documentation
> > source files. I can provide a diff which will transform SGML files
> > into valid XML files.
>
> Is that the only change? Then we don't need it.
>

I added some tags to specify columns' size
(http://www.oasis-open.org/docbook/documentation/reference/html/colspec.html
and http://www.sagehill.net/docbookxsl/ColumnWidths.html) and XSLT
stylesheets to build HTML, PDF, htmlhelp and manpages.

I also added some attributes to handle conditional texts
(http://www.sagehill.net/docbookxsl/Profiling.html#MarkProfileText),
needed to build the standalone install file.

> > Do you want me to work on REL8_1_STABLE or HEAD
> > branch ?
>
> HEAD branch always.
>

OK.

--
Guillaume.

Am Freitag, 26. Mai 2006 14:46 schrieb Guillaume Lelarge:
> I added some tags to specify columns' size
> (http://www.oasis-open.org/docbook/documentation/reference/html/colspec.htm
>l and http://www.sagehill.net/docbookxsl/ColumnWidths.html)

That's what we need, I guess.

>and XSLT
> stylesheets to build HTML, PDF, htmlhelp and manpages.

We already have that.

> I also added some attributes to handle conditional texts
> (http://www.sagehill.net/docbookxsl/Profiling.html#MarkProfileText),
> needed to build the standalone install file.

That will become necessary once we switch the source to XML.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

2006/5/26, Peter Eisentraut <peter_e(at)gmx(dot)net>:
> Am Freitag, 26. Mai 2006 14:46 schrieb Guillaume Lelarge:
> > I added some tags to specify columns' size
> > (http://www.oasis-open.org/docbook/documentation/reference/html/colspec.htm
> >l and http://www.sagehill.net/docbookxsl/ColumnWidths.html)
>
> That's what we need, I guess.
>

Yes, it's required if we don't want to have some text of a cell
overwritten on the following cell.

> >and XSLT
> > stylesheets to build HTML, PDF, htmlhelp and manpages.
>
> We already have that.
>

OK.

> > I also added some attributes to handle conditional texts
> > (http://www.sagehill.net/docbookxsl/Profiling.html#MarkProfileText),
> > needed to build the standalone install file.
>
> That will become necessary once we switch the source to XML.
>

Yes.

So, you just need colspec tags ? it won't be easy to do because
there's a lot of checks to do after changes. But I can try.

--
Guillaume.

On 26/05/06, Guillaume Lelarge <guillaume(dot)lelarge(at)gmail(dot)com> wrote:
> 2006/5/26, Peter Eisentraut <peter_e(at)gmx(dot)net>:
> > Am Freitag, 26. Mai 2006 14:19 schrieb Guillaume Lelarge:
> > > Yes, you're right. There's some changes to do on the documentation
> > > source files. I can provide a diff which will transform SGML files
> > > into valid XML files.
> >

I've got the 8.1 postgres manuals in DocbookXML 4.2 format and I'm
using POT files for translations. As soon as possible I'll have with
the html, xml, pot and a little status page avaliable.

However, the xml files are not 100% valid but it works for me.

> > Is that the only change? Then we don't need it.
> >
>
> I added some tags to specify columns' size
> (http://www.oasis-open.org/docbook/documentation/reference/html/colspec.html
> and http://www.sagehill.net/docbookxsl/ColumnWidths.html) and XSLT
> stylesheets to build HTML, PDF, htmlhelp and manpages.
>
> I also added some attributes to handle conditional texts
> (http://www.sagehill.net/docbookxsl/Profiling.html#MarkProfileText),
> needed to build the standalone install file.
>
> > > Do you want me to work on REL8_1_STABLE or HEAD
> > > branch ?
> >
> > HEAD branch always.
> >
>
> OK.
>